@lensjs/core 2.0.0 → 2.1.1

package/README.md

@@ -0,0 +1,69 @@
+# @lensjs/core
+
+The core library for Lens, providing the fundamental architecture for monitoring and debugging applications. It defines the abstract concepts of adapters, stores, and watchers, along with utilities for event emission, asynchronous context management, and SQL formatting. This package also includes the embedded UI for the Lens dashboard.
+
+## Features
+
+*   **`Lens` class**: The central class for initializing Lens, setting up adapters and watchers, and starting the monitoring process.
+*   **`LensAdapter` (abstract class)**: Defines the interface for integrating Lens with different application frameworks (e.g., Express, Adonis). It handles route registration and UI serving.
+*   **`LensStore` (abstract class)**: Defines the interface for data storage, allowing Lens to persist and retrieve captured events (requests, queries, cache entries). Includes methods for saving, retrieving, and truncating data.
+*   **`LensWatcher` (abstract class)**: Defines the interface for capturing specific types of events within an application.
+*   **Concrete Watchers**:
+    *   `RequestWatcher`: Captures and logs details of incoming HTTP requests.
+    *   `QueryWatcher`: Captures and logs database queries.
+    *   `CacheWatcher`: Captures and logs cache interactions.
+    *   `ExceptionWatcher`: Captures and logs exceptions and errors.
+*   **`ApiController`**: Provides the API endpoints for the Lens UI to fetch monitoring data.
+*   **`lensEmitter`**: A global event emitter for internal communication between different parts of Lens.
+*   **`lensContext`**: Utilizes `AsyncLocalStorage` for managing asynchronous context, primarily to associate events with a specific request ID.
+*   **`lensUtils`**: A collection of utility functions, including:
+    *   `generateRandomUuid`: Generates unique IDs.
+    *   `interpolateQuery`: Interpolates SQL query placeholders with actual values.
+    *   `formatSqlQuery`: Formats SQL queries for readability.
+    *   `getMeta`: Provides `__filename` and `__dirname` in both CommonJS and ESM environments.
+    *   `isStaticFile`, `stripBeforeAssetsPath`: Utilities for handling static file paths.
+    *   `prepareIgnoredPaths`, `shouldIgnoreCurrentPath`: Logic for path-based filtering.
+    *   `prettyHrTime`: Formats high-resolution time differences.
+*   **`BetterSqliteStore`**: A concrete implementation of `LensStore` using Better SQLite for data persistence.
+*   **Embedded UI**: Includes a built-in web interface for visualizing captured application data.
+
+## Installation
+
+```bash
+pnpm add @lensjs/core
+```
+
+## Usage Example (Conceptual - typically used via framework adapters)
+
+```typescript
+import { Lens, RequestWatcher, QueryWatcher, CacheWatcher } from '@lensjs/core';
+import { BetterSqliteStore } from '@lensjs/core/stores';
+// Assuming you have a custom adapter for your framework
+import MyFrameworkAdapter from './my-framework-adapter';
+
+async function bootstrapLens(appInstance: any) {
+  const store = new BetterSqliteStore();
+  await store.initialize();
+
+  const adapter = new MyFrameworkAdapter({ app: appInstance });
+
+  await Lens.setStore(store)
+    .setAdapter(adapter)
+    .setWatchers([
+      new RequestWatcher(),
+      new QueryWatcher(),
+      new CacheWatcher(),
+      new ExceptionWatcher(),
+    ])
+    .start({
+      appName: 'My Application',
+      enabled: process.env.NODE_ENV !== 'production',
+      basePath: 'lens-dashboard', // UI will be served at /lens-dashboard
+    });
+
+  console.log('Lens core initialized.');
+}
+
+// In your application's main entry point:
+// bootstrapLens(yourFrameworkAppInstance);
+```

package/dist/abstracts/store.cjs

@@ -24,6 +24,9 @@ __export(store_exports, {
 });
 module.exports = __toCommonJS(store_exports);
 var Store = class {
+  getAllExceptions(_paginationParams) {
+    return this.defaultMinimalPaginate();
+  }
   stringifyData(data) {
     if (typeof data === "string") {
       return data;
@@ -34,4 +37,14 @@ var Store = class {
       console.error(`Failed to stringify lens data: ${e}`);
     }
   }
+  defaultMinimalPaginate() {
+    return Promise.resolve({
+      data: [],
+      meta: {
+        currentPage: 0,
+        lastPage: 0,
+        total: 0
+      }
+    });
+  }
 };

package/dist/abstracts/store.d.cts

@@ -1,6 +1,7 @@
 import { WatcherTypeEnum, PaginationParams, Paginator, LensEntry } from '../types/index.cjs';
 import 'sql-formatter';
 
+type MinimalPaginatePromise = Promise<Paginator<Omit<LensEntry, "data">[]>>;
 declare abstract class Store {
     abstract initialize(): Promise<void>;
     abstract save(entry: {
@@ -11,15 +12,17 @@ declare abstract class Store {
         timestamp?: string;
         requestId?: string;
     }): Promise<void>;
-    abstract getAllRequests(paginationParams: PaginationParams): Promise<Paginator<Omit<LensEntry, "data">[]>>;
+    abstract getAllRequests(paginationParams: PaginationParams): MinimalPaginatePromise;
     abstract getAllQueries(paginationParams: PaginationParams): Promise<Paginator<LensEntry[]>>;
-    abstract allByRequestId(requestId: string, type: WatcherTypeEnum): Promise<LensEntry[]>;
-    abstract getAllCacheEntries(paginationParams: PaginationParams): Promise<Paginator<Omit<LensEntry, "data">[]>>;
+    abstract getAllCacheEntries(paginationParams: PaginationParams): MinimalPaginatePromise;
+    abstract allByRequestId(requestId: string, type: WatcherTypeEnum, includeFullData?: boolean): Promise<LensEntry[]>;
     abstract find(type: WatcherTypeEnum, id: string): Promise<LensEntry | null>;
     abstract truncate(): Promise<void>;
     abstract paginate<T>(type: WatcherTypeEnum, pagination: PaginationParams): Promise<Paginator<T>>;
     abstract count(type: WatcherTypeEnum): Promise<number>;
+    getAllExceptions(_paginationParams: PaginationParams): MinimalPaginatePromise;
     protected stringifyData(data: Record<string, any> | string): string | undefined;
+    protected defaultMinimalPaginate(): MinimalPaginatePromise;
 }
 
 export { Store as default };

package/dist/abstracts/store.d.ts

@@ -1,6 +1,7 @@
 import { WatcherTypeEnum, PaginationParams, Paginator, LensEntry } from '../types/index.js';
 import 'sql-formatter';
 
+type MinimalPaginatePromise = Promise<Paginator<Omit<LensEntry, "data">[]>>;
 declare abstract class Store {
     abstract initialize(): Promise<void>;
     abstract save(entry: {
@@ -11,15 +12,17 @@ declare abstract class Store {
         timestamp?: string;
         requestId?: string;
     }): Promise<void>;
-    abstract getAllRequests(paginationParams: PaginationParams): Promise<Paginator<Omit<LensEntry, "data">[]>>;
+    abstract getAllRequests(paginationParams: PaginationParams): MinimalPaginatePromise;
     abstract getAllQueries(paginationParams: PaginationParams): Promise<Paginator<LensEntry[]>>;
-    abstract allByRequestId(requestId: string, type: WatcherTypeEnum): Promise<LensEntry[]>;
-    abstract getAllCacheEntries(paginationParams: PaginationParams): Promise<Paginator<Omit<LensEntry, "data">[]>>;
+    abstract getAllCacheEntries(paginationParams: PaginationParams): MinimalPaginatePromise;
+    abstract allByRequestId(requestId: string, type: WatcherTypeEnum, includeFullData?: boolean): Promise<LensEntry[]>;
     abstract find(type: WatcherTypeEnum, id: string): Promise<LensEntry | null>;
     abstract truncate(): Promise<void>;
     abstract paginate<T>(type: WatcherTypeEnum, pagination: PaginationParams): Promise<Paginator<T>>;
     abstract count(type: WatcherTypeEnum): Promise<number>;
+    getAllExceptions(_paginationParams: PaginationParams): MinimalPaginatePromise;
     protected stringifyData(data: Record<string, any> | string): string | undefined;
+    protected defaultMinimalPaginate(): MinimalPaginatePromise;
 }
 
 export { Store as default };

package/dist/abstracts/store.js

@@ -1,5 +1,8 @@
 // src/abstracts/store.ts
 var Store = class {
+  getAllExceptions(_paginationParams) {
+    return this.defaultMinimalPaginate();
+  }
   stringifyData(data) {
     if (typeof data === "string") {
       return data;
@@ -10,6 +13,16 @@ var Store = class {
       console.error(`Failed to stringify lens data: ${e}`);
     }
   }
+  defaultMinimalPaginate() {
+    return Promise.resolve({
+      data: [],
+      meta: {
+        currentPage: 0,
+        lastPage: 0,
+        total: 0
+      }
+    });
+  }
 };
 export {
   Store as default

package/dist/core/api_controller.cjs

@@ -87,10 +87,16 @@ var ApiController = class {
       request.id,
       "cache" /* CACHE */
     );
+    const exceptions = await getStore().allByRequestId(
+      request.id,
+      "exception" /* EXCEPTION */,
+      false
+    );
     return this.resourceResponse({
       request,
       queries,
-      cacheEntries
+      cacheEntries,
+      exceptions
     });
   }
   static async getQueries({
@@ -122,6 +128,21 @@ var ApiController = class {
     }
     return this.resourceResponse(cacheEntry);
   }
+  static async getExceptions({ qs }) {
+    return this.paginatedResponse(
+      await getStore().getAllExceptions(this.extractPaginationParams(qs))
+    );
+  }
+  static async getException({ params }) {
+    const exception = await getStore().find(
+      "exception" /* EXCEPTION */,
+      params.id
+    );
+    if (!exception) {
+      return this.notFoundResponse();
+    }
+    return this.resourceResponse(exception);
+  }
   static async truncate() {
     await getStore().truncate();
     return this.baseResponse({}, 200, "All entries cleared");

package/dist/core/api_controller.d.cts

@@ -1,4 +1,4 @@
-import { RouteDefinitionHandler, ApiResponse, LensEntry } from '../types/index.cjs';
+import { RouteDefinitionHandler, ApiResponse, LensEntry, Paginator } from '../types/index.cjs';
 import 'sql-formatter';
 
 declare class ApiController {
@@ -8,6 +8,8 @@ declare class ApiController {
     static getQuery({ params, }: RouteDefinitionHandler): Promise<ApiResponse<LensEntry>>;
     static getCacheEntries({ qs }: RouteDefinitionHandler): Promise<ApiResponse<Omit<LensEntry, "data">[]>>;
     static getCacheEntry({ params }: RouteDefinitionHandler): Promise<ApiResponse<Object>>;
+    static getExceptions({ qs }: RouteDefinitionHandler): Promise<ApiResponse<Omit<LensEntry, "data">[]>>;
+    static getException({ params }: RouteDefinitionHandler): Promise<ApiResponse<Object>>;
     static truncate(): Promise<ApiResponse<{}>>;
     static fetchUiConfig(): {
         appName: string;
@@ -20,7 +22,7 @@ declare class ApiController {
     private static extractPaginationParams;
     private static resourceResponse;
     private static notFoundResponse;
-    private static paginatedResponse;
+    static paginatedResponse<T extends Object>(data: Paginator<T>): ApiResponse<T>;
     private static baseResponse;
 }
 

package/dist/core/api_controller.d.ts

@@ -1,4 +1,4 @@
-import { RouteDefinitionHandler, ApiResponse, LensEntry } from '../types/index.js';
+import { RouteDefinitionHandler, ApiResponse, LensEntry, Paginator } from '../types/index.js';
 import 'sql-formatter';
 
 declare class ApiController {
@@ -8,6 +8,8 @@ declare class ApiController {
     static getQuery({ params, }: RouteDefinitionHandler): Promise<ApiResponse<LensEntry>>;
     static getCacheEntries({ qs }: RouteDefinitionHandler): Promise<ApiResponse<Omit<LensEntry, "data">[]>>;
     static getCacheEntry({ params }: RouteDefinitionHandler): Promise<ApiResponse<Object>>;
+    static getExceptions({ qs }: RouteDefinitionHandler): Promise<ApiResponse<Omit<LensEntry, "data">[]>>;
+    static getException({ params }: RouteDefinitionHandler): Promise<ApiResponse<Object>>;
     static truncate(): Promise<ApiResponse<{}>>;
     static fetchUiConfig(): {
         appName: string;
@@ -20,7 +22,7 @@ declare class ApiController {
     private static extractPaginationParams;
     private static resourceResponse;
     private static notFoundResponse;
-    private static paginatedResponse;
+    static paginatedResponse<T extends Object>(data: Paginator<T>): ApiResponse<T>;
     private static baseResponse;
 }
 

package/dist/core/api_controller.js

@@ -61,10 +61,16 @@ var ApiController = class {
       request.id,
       "cache" /* CACHE */
     );
+    const exceptions = await getStore().allByRequestId(
+      request.id,
+      "exception" /* EXCEPTION */,
+      false
+    );
     return this.resourceResponse({
       request,
       queries,
-      cacheEntries
+      cacheEntries,
+      exceptions
     });
   }
   static async getQueries({
@@ -96,6 +102,21 @@ var ApiController = class {
     }
     return this.resourceResponse(cacheEntry);
   }
+  static async getExceptions({ qs }) {
+    return this.paginatedResponse(
+      await getStore().getAllExceptions(this.extractPaginationParams(qs))
+    );
+  }
+  static async getException({ params }) {
+    const exception = await getStore().find(
+      "exception" /* EXCEPTION */,
+      params.id
+    );
+    if (!exception) {
+      return this.notFoundResponse();
+    }
+    return this.resourceResponse(exception);
+  }
   static async truncate() {
     await getStore().truncate();
     return this.baseResponse({}, 200, "All entries cleared");

package/dist/core/lens.cjs

@@ -97,10 +97,16 @@ var ApiController = class {
       request.id,
       "cache" /* CACHE */
     );
+    const exceptions = await getStore().allByRequestId(
+      request.id,
+      "exception" /* EXCEPTION */,
+      false
+    );
     return this.resourceResponse({
       request,
       queries,
-      cacheEntries
+      cacheEntries,
+      exceptions
     });
   }
   static async getQueries({
@@ -132,6 +138,21 @@ var ApiController = class {
     }
     return this.resourceResponse(cacheEntry);
   }
+  static async getExceptions({ qs }) {
+    return this.paginatedResponse(
+      await getStore().getAllExceptions(this.extractPaginationParams(qs))
+    );
+  }
+  static async getException({ params }) {
+    const exception = await getStore().find(
+      "exception" /* EXCEPTION */,
+      params.id
+    );
+    if (!exception) {
+      return this.notFoundResponse();
+    }
+    return this.resourceResponse(exception);
+  }
   static async truncate() {
     await getStore().truncate();
     return this.baseResponse({}, 200, "All entries cleared");
@@ -183,6 +204,9 @@ var path2 = __toESM(require("path"), 1);
 
 // src/abstracts/store.ts
 var Store = class {
+  getAllExceptions(_paginationParams) {
+    return this.defaultMinimalPaginate();
+  }
   stringifyData(data) {
     if (typeof data === "string") {
       return data;
@@ -193,6 +217,16 @@ var Store = class {
       console.error(`Failed to stringify lens data: ${e}`);
     }
   }
+  defaultMinimalPaginate() {
+    return Promise.resolve({
+      data: [],
+      meta: {
+        currentPage: 0,
+        lastPage: 0,
+        total: 0
+      }
+    });
+  }
 };
 
 // src/stores/better_sqlite.ts
@@ -231,11 +265,14 @@ var BetterSqliteStore = class extends Store {
   async getAllCacheEntries(pagination) {
     return await this.paginate("cache" /* CACHE */, pagination);
   }
-  async allByRequestId(requestId, type) {
+  async getAllExceptions(pagination) {
+    return await this.paginate("exception" /* EXCEPTION */, pagination, false);
+  }
+  async allByRequestId(requestId, type, includeFullData = true) {
     const rows = this.connection.prepare(
-      `${this.getSelectedColumns()} FROM ${TABLE_NAME} WHERE type = $type AND lens_entry_id = $requestId ORDER BY created_at DESC`
+      `${this.getSelectedColumns(includeFullData)} FROM ${TABLE_NAME} WHERE type = $type AND lens_entry_id = $requestId ORDER BY created_at DESC`
     ).all({ type, requestId });
-    return this.mapRows(rows);
+    return this.mapRows(rows, includeFullData);
   }
   async paginate(type, { page, perPage }, includeFullData = true) {
     const offset = (page - 1) * perPage;
@@ -397,6 +434,7 @@ var Lens = class {
           requests: `/${config.basePath}/api/requests`,
           queries: `/${config.basePath}/api/queries`,
           cache: `/${config.basePath}/api/cache`,
+          exceptions: `/${config.basePath}/api/exceptions`,
           truncate: `/${config.basePath}/api/truncate`
         }
       };
@@ -439,6 +477,16 @@ var Lens = class {
         path: `${basePath}/api/cache/:id`,
         handler: async (data) => await ApiController.getCacheEntry(data)
       },
+      {
+        method: "GET",
+        path: `${basePath}/api/exceptions`,
+        handler: async (data) => await ApiController.getExceptions(data)
+      },
+      {
+        method: "GET",
+        path: `${basePath}/api/exceptions/:id`,
+        handler: async (data) => await ApiController.getException(data)
+      },
       {
         method: "DELETE",
         path: `${basePath}/api/truncate`,

package/dist/core/lens.js

@@ -61,10 +61,16 @@ var ApiController = class {
       request.id,
       "cache" /* CACHE */
     );
+    const exceptions = await getStore().allByRequestId(
+      request.id,
+      "exception" /* EXCEPTION */,
+      false
+    );
     return this.resourceResponse({
       request,
       queries,
-      cacheEntries
+      cacheEntries,
+      exceptions
     });
   }
   static async getQueries({
@@ -96,6 +102,21 @@ var ApiController = class {
     }
     return this.resourceResponse(cacheEntry);
   }
+  static async getExceptions({ qs }) {
+    return this.paginatedResponse(
+      await getStore().getAllExceptions(this.extractPaginationParams(qs))
+    );
+  }
+  static async getException({ params }) {
+    const exception = await getStore().find(
+      "exception" /* EXCEPTION */,
+      params.id
+    );
+    if (!exception) {
+      return this.notFoundResponse();
+    }
+    return this.resourceResponse(exception);
+  }
   static async truncate() {
     await getStore().truncate();
     return this.baseResponse({}, 200, "All entries cleared");
@@ -147,6 +168,9 @@ import * as path2 from "path";
 
 // src/abstracts/store.ts
 var Store = class {
+  getAllExceptions(_paginationParams) {
+    return this.defaultMinimalPaginate();
+  }
   stringifyData(data) {
     if (typeof data === "string") {
       return data;
@@ -157,6 +181,16 @@ var Store = class {
       console.error(`Failed to stringify lens data: ${e}`);
     }
   }
+  defaultMinimalPaginate() {
+    return Promise.resolve({
+      data: [],
+      meta: {
+        currentPage: 0,
+        lastPage: 0,
+        total: 0
+      }
+    });
+  }
 };
 
 // src/stores/better_sqlite.ts
@@ -195,11 +229,14 @@ var BetterSqliteStore = class extends Store {
   async getAllCacheEntries(pagination) {
     return await this.paginate("cache" /* CACHE */, pagination);
   }
-  async allByRequestId(requestId, type) {
+  async getAllExceptions(pagination) {
+    return await this.paginate("exception" /* EXCEPTION */, pagination, false);
+  }
+  async allByRequestId(requestId, type, includeFullData = true) {
     const rows = this.connection.prepare(
-      `${this.getSelectedColumns()} FROM ${TABLE_NAME} WHERE type = $type AND lens_entry_id = $requestId ORDER BY created_at DESC`
+      `${this.getSelectedColumns(includeFullData)} FROM ${TABLE_NAME} WHERE type = $type AND lens_entry_id = $requestId ORDER BY created_at DESC`
     ).all({ type, requestId });
-    return this.mapRows(rows);
+    return this.mapRows(rows, includeFullData);
   }
   async paginate(type, { page, perPage }, includeFullData = true) {
     const offset = (page - 1) * perPage;
@@ -360,6 +397,7 @@ var Lens = class {
           requests: `/${config.basePath}/api/requests`,
           queries: `/${config.basePath}/api/queries`,
           cache: `/${config.basePath}/api/cache`,
+          exceptions: `/${config.basePath}/api/exceptions`,
           truncate: `/${config.basePath}/api/truncate`
         }
       };
@@ -402,6 +440,16 @@ var Lens = class {
         path: `${basePath}/api/cache/:id`,
         handler: async (data) => await ApiController.getCacheEntry(data)
       },
+      {
+        method: "GET",
+        path: `${basePath}/api/exceptions`,
+        handler: async (data) => await ApiController.getExceptions(data)
+      },
+      {
+        method: "GET",
+        path: `${basePath}/api/exceptions/:id`,
+        handler: async (data) => await ApiController.getException(data)
+      },
       {
         method: "DELETE",
         path: `${basePath}/api/truncate`,

package/dist/exception-3AZsPtAg.d.ts

@@ -0,0 +1,52 @@
+import { ExceptionEntry } from './types/index.js';
+
+/**
+ * Clean a raw stack trace string, removing internal Node.js frames.
+ */
+declare function cleanStack(stack?: string): string;
+/**
+ * Extract file information from the top frame of a stack trace.
+ */
+declare function getFileInfo(stack?: string): {
+    file: string;
+    line: number;
+    column: number;
+    function: string;
+};
+/**
+ * Parse a stack trace into an array of structured frames.
+ */
+declare function getStackTrace(stack?: string): string[];
+/**
+ * Extract surrounding code lines (context) from a file where the error occurred.
+ */
+declare function extractCodeFrame({ file, line, column, contextLines, }: {
+    file: string;
+    line: number;
+    column: number;
+    contextLines?: number;
+}): {
+    file: string;
+    line: number;
+    column: number;
+    context: {
+        pre: string[];
+        error: string;
+        post: string[];
+    };
+} | null;
+/**
+ * Construct a normalized error object with metadata, stack trace, and code frame.
+ */
+declare function constructErrorObject(err: Error): ExceptionEntry;
+
+declare const exception_cleanStack: typeof cleanStack;
+declare const exception_constructErrorObject: typeof constructErrorObject;
+declare const exception_extractCodeFrame: typeof extractCodeFrame;
+declare const exception_getFileInfo: typeof getFileInfo;
+declare const exception_getStackTrace: typeof getStackTrace;
+declare namespace exception {
+  export { exception_cleanStack as cleanStack, exception_constructErrorObject as constructErrorObject, exception_extractCodeFrame as extractCodeFrame, exception_getFileInfo as getFileInfo, exception_getStackTrace as getStackTrace };
+}
+
+export { getStackTrace as a, extractCodeFrame as b, cleanStack as c, constructErrorObject as d, exception as e, getFileInfo as g };

package/dist/exception-C69UCHPk.d.cts

@@ -0,0 +1,52 @@
+import { ExceptionEntry } from './types/index.cjs';
+
+/**
+ * Clean a raw stack trace string, removing internal Node.js frames.
+ */
+declare function cleanStack(stack?: string): string;
+/**
+ * Extract file information from the top frame of a stack trace.
+ */
+declare function getFileInfo(stack?: string): {
+    file: string;
+    line: number;
+    column: number;
+    function: string;
+};
+/**
+ * Parse a stack trace into an array of structured frames.
+ */
+declare function getStackTrace(stack?: string): string[];
+/**
+ * Extract surrounding code lines (context) from a file where the error occurred.
+ */
+declare function extractCodeFrame({ file, line, column, contextLines, }: {
+    file: string;
+    line: number;
+    column: number;
+    contextLines?: number;
+}): {
+    file: string;
+    line: number;
+    column: number;
+    context: {
+        pre: string[];
+        error: string;
+        post: string[];
+    };
+} | null;
+/**
+ * Construct a normalized error object with metadata, stack trace, and code frame.
+ */
+declare function constructErrorObject(err: Error): ExceptionEntry;
+
+declare const exception_cleanStack: typeof cleanStack;
+declare const exception_constructErrorObject: typeof constructErrorObject;
+declare const exception_extractCodeFrame: typeof extractCodeFrame;
+declare const exception_getFileInfo: typeof getFileInfo;
+declare const exception_getStackTrace: typeof getStackTrace;
+declare namespace exception {
+  export { exception_cleanStack as cleanStack, exception_constructErrorObject as constructErrorObject, exception_extractCodeFrame as extractCodeFrame, exception_getFileInfo as getFileInfo, exception_getStackTrace as getStackTrace };
+}
+
+export { getStackTrace as a, extractCodeFrame as b, cleanStack as c, constructErrorObject as d, exception as e, getFileInfo as g };