feat(core, tests): add standalone getStatistics function and improve storage configuration

- **Core**: Introduced a new `getStatistics` utility function in `statistics.ts` for fetching database statistics at the root level of the library. Enhanced `BrainyData` methods to ensure metadata includes `id` field and refined statistics calculations, excluding verbs from the noun count.
- **Tests**: Added comprehensive test coverage in `statistics.test.ts` for the new utility function, validating proper error handling, statistics accuracy, and consistent results between instance methods and standalone function.
- **Storage Config**: Enabled dynamic support for AWS S3, Cloudflare R2, and Google Cloud Storage in web service configuration, utilizing environment variables for adapter setup. Addressed a race condition in `FileSystemStorage` initialization by deferring path module imports.

**Purpose**: Enhance database analytics by introducing a reusable `getStatistics` function, improve flexibility in storage configuration, and ensure robust testing for reliability and accuracy.

src/utils/index.ts

@@ -1,3 +1,4 @@
 export * from './distance.js'
 export * from './embedding.js'
 export * from './workerUtils.js'
+export * from './statistics.js'

src/utils/statistics.ts

@@ -0,0 +1,31 @@
+/**
+ * Utility functions for retrieving statistics from Brainy
+ */
+
+import { BrainyData } from '../brainyData.js'
+
+/**
+ * Get statistics about the current state of a BrainyData instance
+ * This function provides access to statistics at the root level of the library
+ * 
+ * @param instance A BrainyData instance to get statistics from
+ * @returns Object containing counts of nouns, verbs, metadata entries, and HNSW index size
+ * @throws Error if the instance is not provided or if statistics retrieval fails
+ */
+export async function getStatistics(instance: BrainyData): Promise<{
+    nounCount: number
+    verbCount: number
+    metadataCount: number
+    hnswIndexSize: number
+}> {
+    if (!instance) {
+        throw new Error('BrainyData instance must be provided to getStatistics')
+    }
+    
+    try {
+        return await instance.getStatistics()
+    } catch (error) {
+        console.error('Failed to get statistics:', error)
+        throw new Error(`Failed to get statistics: ${error}`)
+    }
+}