@soulcraft/brainy 0.31.0 → 0.33.0

package/dist/utils/fieldNameTracking.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Utility functions for tracking and managing field names in JSON documents
+ */
+/**
+ * Extracts field names from a JSON document
+ * @param jsonObject The JSON object to extract field names from
+ * @param options Configuration options
+ * @returns An array of field paths (e.g., "user.name", "addresses[0].city")
+ */
+export declare function extractFieldNamesFromJson(jsonObject: any, options?: {
+    maxDepth?: number;
+    currentDepth?: number;
+    currentPath?: string;
+    fieldNames?: Set<string>;
+}): string[];
+/**
+ * Maps field names to standard field names based on common patterns
+ * @param fieldName The field name to map
+ * @returns The standard field name if a match is found, or null if no match
+ */
+export declare function mapToStandardField(fieldName: string): string | null;

package/dist/utils/fieldNameTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldNameTracking.d.ts","sourceRoot":"","sources":["../../src/utils/fieldNameTracking.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,GAAG,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACpB,GACL,MAAM,EAAE,CAkDV;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsCnE"}

package/dist/utils/index.d.ts

@@ -2,3 +2,5 @@ export * from './distance.js';
 export * from './embedding.js';
 export * from './workerUtils.js';
 export * from './statistics.js';
+export * from './jsonProcessing.js';
+export * from './fieldNameTracking.js';

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA"}

package/dist/utils/jsonProcessing.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Utility functions for processing JSON documents for vectorization and search
+ */
+/**
+ * Extracts text from a JSON object for vectorization
+ * This function recursively processes the JSON object and extracts text from all fields
+ * It can also prioritize specific fields if provided
+ *
+ * @param jsonObject The JSON object to extract text from
+ * @param options Configuration options for text extraction
+ * @returns A string containing the extracted text
+ */
+export declare function extractTextFromJson(jsonObject: any, options?: {
+    priorityFields?: string[];
+    excludeFields?: string[];
+    includeFieldNames?: boolean;
+    maxDepth?: number;
+    currentDepth?: number;
+    fieldPath?: string[];
+}): string;
+/**
+ * Prepares a JSON document for vectorization
+ * This function extracts text from the JSON document and formats it for optimal vectorization
+ *
+ * @param jsonDocument The JSON document to prepare
+ * @param options Configuration options for preparation
+ * @returns A string ready for vectorization
+ */
+export declare function prepareJsonForVectorization(jsonDocument: any, options?: {
+    priorityFields?: string[];
+    excludeFields?: string[];
+    includeFieldNames?: boolean;
+    maxDepth?: number;
+}): string;
+/**
+ * Extracts text from a specific field in a JSON document
+ * This is useful for searching within specific fields
+ *
+ * @param jsonDocument The JSON document to extract from
+ * @param fieldPath The path to the field (e.g., "user.name" or "addresses[0].city")
+ * @returns The extracted text or empty string if field not found
+ */
+export declare function extractFieldFromJson(jsonDocument: any, fieldPath: string): string;

package/dist/utils/jsonProcessing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonProcessing.d.ts","sourceRoot":"","sources":["../../src/utils/jsonProcessing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,GAAG,EACf,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB,GACL,MAAM,CAsGR;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,GAAG,EACjB,OAAO,GAAE;IACP,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;CACb,GACL,MAAM,CAmBR;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,GAAG,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAkDR"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "0.31.0",
+  "version": "0.33.0",
   "description": "A vector graph database using HNSW indexing with Origin Private File System storage",
   "main": "dist/unified.js",
   "module": "dist/unified.js",