@hazeljs/rag 0.2.0-alpha.1

package/dist/__tests__/graph/knowledge-graph.test.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const knowledge_graph_1 = require("../../graph/knowledge-graph");
+function makeEntity(overrides = {}) {
+    return {
+        id: 'e1',
+        name: 'TypeScript',
+        type: 'TECHNOLOGY',
+        description: 'A typed superset of JavaScript.',
+        sourceDocIds: ['doc1'],
+        ...overrides,
+    };
+}
+function makeRelationship(overrides = {}) {
+    return {
+        id: 'r1',
+        sourceId: 'e1',
+        targetId: 'e2',
+        type: 'USES',
+        description: 'TypeScript uses JavaScript.',
+        weight: 7,
+        sourceDocIds: ['doc1'],
+        ...overrides,
+    };
+}
+describe('GraphStore — entities', () => {
+    let store;
+    beforeEach(() => {
+        store = new knowledge_graph_1.GraphStore();
+    });
+    it('adds an entity and retrieves it', () => {
+        const e = makeEntity();
+        store.addEntity(e);
+        expect(store.entities.get('e1')).toEqual(e);
+    });
+    it('initialises adjacency entry on addEntity', () => {
+        store.addEntity(makeEntity());
+        expect(store.adjacency.has('e1')).toBe(true);
+    });
+    it('merges duplicate entity by id', () => {
+        store.addEntity(makeEntity({ description: 'original' }));
+        store.addEntity(makeEntity({ description: 'additional info', sourceDocIds: ['doc2'] }));
+        const merged = store.entities.get('e1');
+        expect(merged.description).toContain('original');
+        expect(merged.description).toContain('additional info');
+        expect(merged.sourceDocIds).toContain('doc1');
+        expect(merged.sourceDocIds).toContain('doc2');
+    });
+    it('mergeEntity throws when entity does not exist', () => {
+        expect(() => store.mergeEntity('missing', {})).toThrow('not found');
+    });
+    it('findEntityByName is case-insensitive', () => {
+        store.addEntity(makeEntity({ name: 'TypeScript' }));
+        expect(store.findEntityByName('typescript')).toBeDefined();
+        expect(store.findEntityByName('TYPESCRIPT')).toBeDefined();
+    });
+    it('findEntityByName returns undefined for non-existing entity', () => {
+        expect(store.findEntityByName('NonExistent')).toBeUndefined();
+    });
+    it('findEntitiesByName returns partial matches sorted by name length', () => {
+        store.addEntity(makeEntity({ id: 'e1', name: 'TypeScript' }));
+        store.addEntity(makeEntity({ id: 'e2', name: 'TypeScript Compiler' }));
+        const results = store.findEntitiesByName('typescript');
+        expect(results).toHaveLength(2);
+        expect(results[0].name.length).toBeLessThanOrEqual(results[1].name.length);
+    });
+    it('findEntitiesByName respects limit', () => {
+        for (let i = 0; i < 15; i++) {
+            store.addEntity(makeEntity({ id: `e${i}`, name: `TypeScript ${i}` }));
+        }
+        const results = store.findEntitiesByName('typescript', 5);
+        expect(results).toHaveLength(5);
+    });
+    it('findEntitiesByName returns empty when nothing matches', () => {
+        store.addEntity(makeEntity());
+        expect(store.findEntitiesByName('Rust')).toHaveLength(0);
+    });
+});
+describe('GraphStore — relationships', () => {
+    let store;
+    beforeEach(() => {
+        store = new knowledge_graph_1.GraphStore();
+        store.addEntity(makeEntity({ id: 'e1', name: 'A' }));
+        store.addEntity(makeEntity({ id: 'e2', name: 'B' }));
+    });
+    it('adds a relationship and updates adjacency', () => {
+        store.addRelationship(makeRelationship());
+        expect(store.relationships.has('r1')).toBe(true);
+        expect(store.adjacency.get('e1').has('e2')).toBe(true);
+        expect(store.adjacency.get('e2').has('e1')).toBe(true);
+    });
+    it('creates adjacency entries for previously unknown entity IDs', () => {
+        store.addRelationship(makeRelationship({ sourceId: 'e99', targetId: 'e100' }));
+        expect(store.adjacency.get('e99')?.has('e100')).toBe(true);
+    });
+    it('getEntityRelationships returns all rels touching an entity', () => {
+        store.addRelationship(makeRelationship({ id: 'r1', sourceId: 'e1', targetId: 'e2' }));
+        store.addRelationship(makeRelationship({ id: 'r2', sourceId: 'e2', targetId: 'e1' }));
+        const rels = store.getEntityRelationships('e1');
+        expect(rels).toHaveLength(2);
+    });
+    it('getEntityRelationships returns empty for entity with no relationships', () => {
+        expect(store.getEntityRelationships('e1')).toHaveLength(0);
+    });
+});
+describe('GraphStore — BFS traversal', () => {
+    let store;
+    beforeEach(() => {
+        store = new knowledge_graph_1.GraphStore();
+        for (const id of ['e1', 'e2', 'e3', 'e4']) {
+            store.addEntity(makeEntity({ id, name: id }));
+        }
+        store.addRelationship(makeRelationship({ id: 'r1', sourceId: 'e1', targetId: 'e2' }));
+        store.addRelationship(makeRelationship({ id: 'r2', sourceId: 'e2', targetId: 'e3' }));
+    });
+    it('returns only seed entities at depth 0', () => {
+        const result = store.bfsNeighbours(['e1'], 0);
+        // seed entity plus relationships within visited set
+        expect(result.entities.map((e) => e.id)).toContain('e1');
+    });
+    it('traverses one hop correctly', () => {
+        const result = store.bfsNeighbours(['e1'], 1);
+        const ids = result.entities.map((e) => e.id);
+        expect(ids).toContain('e1');
+        expect(ids).toContain('e2');
+    });
+    it('traverses two hops correctly', () => {
+        const result = store.bfsNeighbours(['e1'], 2);
+        const ids = result.entities.map((e) => e.id);
+        expect(ids).toContain('e3');
+    });
+    it('returns relationships between visited entities', () => {
+        const result = store.bfsNeighbours(['e1'], 2);
+        const relIds = result.relationships.map((r) => r.id);
+        expect(relIds).toContain('r1');
+        expect(relIds).toContain('r2');
+    });
+    it('stops when frontier is empty', () => {
+        const result = store.bfsNeighbours(['e4'], 5);
+        // e4 is isolated
+        expect(result.entities.map((e) => e.id)).toContain('e4');
+        expect(result.relationships).toHaveLength(0);
+    });
+});
+describe('GraphStore — communities', () => {
+    let store;
+    beforeEach(() => {
+        store = new knowledge_graph_1.GraphStore();
+    });
+    it('sets and retrieves communities', () => {
+        const communities = [{ id: 'c1', entityIds: ['e1', 'e2'], level: 0 }];
+        store.setCommunities(communities);
+        expect(store.communities).toHaveLength(1);
+    });
+    it('getCommunityForEntity finds the right community', () => {
+        store.setCommunities([{ id: 'c1', entityIds: ['e1', 'e2'], level: 0 }]);
+        expect(store.getCommunityForEntity('e1')?.id).toBe('c1');
+        expect(store.getCommunityForEntity('e99')).toBeUndefined();
+    });
+    it('addCommunityReport stores a report', () => {
+        store.addCommunityReport({
+            communityId: 'c1',
+            title: 'Test',
+            summary: 'Summary',
+            findings: [],
+            rating: 5,
+            entityIds: ['e1'],
+        });
+        expect(store.communityReports.has('c1')).toBe(true);
+    });
+});
+describe('GraphStore — getStats', () => {
+    it('returns zeroed stats for an empty graph', () => {
+        const store = new knowledge_graph_1.GraphStore();
+        const stats = store.getStats();
+        expect(stats.totalEntities).toBe(0);
+        expect(stats.totalRelationships).toBe(0);
+        expect(stats.avgRelationshipsPerEntity).toBe(0);
+    });
+    it('computes entity and relationship type breakdowns', () => {
+        const store = new knowledge_graph_1.GraphStore();
+        store.addEntity(makeEntity({ id: 'e1', type: 'TECHNOLOGY' }));
+        store.addEntity(makeEntity({ id: 'e2', type: 'CONCEPT' }));
+        store.addRelationship(makeRelationship({ id: 'r1', type: 'USES' }));
+        const stats = store.getStats();
+        expect(stats.entityTypeBreakdown['TECHNOLOGY']).toBe(1);
+        expect(stats.entityTypeBreakdown['CONCEPT']).toBe(1);
+        expect(stats.relationshipTypeBreakdown['USES']).toBe(1);
+        expect(stats.topEntities).toBeDefined();
+    });
+});
+describe('GraphStore — toJSON & clear', () => {
+    it('toJSON serialises the graph', () => {
+        const store = new knowledge_graph_1.GraphStore();
+        store.addEntity(makeEntity());
+        const json = store.toJSON();
+        expect(json.entities).toHaveLength(1);
+        expect(json.stats.totalEntities).toBe(1);
+    });
+    it('clear empties the store', () => {
+        const store = new knowledge_graph_1.GraphStore();
+        store.addEntity(makeEntity());
+        store.clear();
+        expect(store.entities.size).toBe(0);
+        expect(store.relationships.size).toBe(0);
+    });
+});
+//# sourceMappingURL=knowledge-graph.test.js.map

package/dist/__tests__/graph/knowledge-graph.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.test.js","sourceRoot":"","sources":["../../../src/__tests__/graph/knowledge-graph.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/loaders/base.loader.test.d.ts

@@ -0,0 +1,2 @@
+import 'reflect-metadata';
+//# sourceMappingURL=base.loader.test.d.ts.map

package/dist/__tests__/loaders/base.loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.loader.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/loaders/base.loader.test.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC"}

package/dist/__tests__/loaders/base.loader.test.js

@@ -0,0 +1,114 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const base_loader_1 = require("../../loaders/base.loader");
+// Concrete loader for testing BaseDocumentLoader
+class TestLoader extends base_loader_1.BaseDocumentLoader {
+    async load() {
+        return [this.createDocument('test content', { source: 'test.txt' })];
+    }
+    exposeCreateDocuments(pages, meta) {
+        return this.createDocuments(pages, meta);
+    }
+}
+let DecoratedLoader = class DecoratedLoader extends base_loader_1.BaseDocumentLoader {
+    async load() {
+        return [];
+    }
+};
+DecoratedLoader = __decorate([
+    (0, base_loader_1.Loader)({
+        name: 'DecoratedLoader',
+        description: 'A test loader',
+        extensions: ['.test'],
+        mimeTypes: ['application/test'],
+    })
+], DecoratedLoader);
+class UndecoatedLoader extends base_loader_1.BaseDocumentLoader {
+    async load() {
+        return [];
+    }
+}
+describe('@Loader decorator & getLoaderConfig', () => {
+    it('stores config on a decorated class', () => {
+        const config = (0, base_loader_1.getLoaderConfig)(DecoratedLoader);
+        expect(config).toEqual({
+            name: 'DecoratedLoader',
+            description: 'A test loader',
+            extensions: ['.test'],
+            mimeTypes: ['application/test'],
+        });
+    });
+    it('returns undefined for an undecorated class', () => {
+        expect((0, base_loader_1.getLoaderConfig)(UndecoatedLoader)).toBeUndefined();
+    });
+});
+describe('BaseDocumentLoader', () => {
+    let loader;
+    beforeEach(() => {
+        loader = new TestLoader();
+    });
+    it('createDocument trims content and sets metadata', async () => {
+        const docs = await loader.load();
+        expect(docs[0].content).toBe('test content');
+        expect(docs[0].metadata?.source).toBe('test.txt');
+    });
+    it('createDocuments returns one doc per non-empty page', () => {
+        const docs = loader.exposeCreateDocuments(['page 1', '  ', 'page 3'], { source: 'multi.pdf' });
+        expect(docs).toHaveLength(2);
+        expect(docs[0].content).toBe('page 1');
+        expect(docs[0].metadata?.pageNumber).toBe(1);
+        expect(docs[0].metadata?.totalPages).toBe(3);
+        expect(docs[1].metadata?.pageNumber).toBe(3);
+    });
+    it('createDocuments filters out blank pages', () => {
+        const docs = loader.exposeCreateDocuments(['', '   ', '\t']);
+        expect(docs).toHaveLength(0);
+    });
+});
+describe('DocumentLoaderRegistry', () => {
+    beforeEach(() => {
+        // Clear registry state between tests by re-registering
+    });
+    it('registers a loader and retrieves by extension', () => {
+        base_loader_1.DocumentLoaderRegistry.register(DecoratedLoader, () => new DecoratedLoader());
+        const loader = base_loader_1.DocumentLoaderRegistry.forExtension('.test');
+        expect(loader).toBeInstanceOf(DecoratedLoader);
+    });
+    it('retrieves by MIME type', () => {
+        base_loader_1.DocumentLoaderRegistry.register(DecoratedLoader, () => new DecoratedLoader());
+        const loader = base_loader_1.DocumentLoaderRegistry.forMimeType('application/test');
+        expect(loader).toBeInstanceOf(DecoratedLoader);
+    });
+    it('returns undefined for unregistered extension', () => {
+        expect(base_loader_1.DocumentLoaderRegistry.forExtension('.xyz123')).toBeUndefined();
+    });
+    it('returns undefined for unregistered MIME type', () => {
+        expect(base_loader_1.DocumentLoaderRegistry.forMimeType('application/xyz123')).toBeUndefined();
+    });
+    it('is case-insensitive for extensions', () => {
+        base_loader_1.DocumentLoaderRegistry.register(DecoratedLoader, () => new DecoratedLoader());
+        const lower = base_loader_1.DocumentLoaderRegistry.forExtension('.test');
+        const upper = base_loader_1.DocumentLoaderRegistry.forExtension('.TEST');
+        expect(lower).toBeDefined();
+        expect(upper).toBeDefined();
+    });
+    it('lists registered extensions', () => {
+        base_loader_1.DocumentLoaderRegistry.register(DecoratedLoader, () => new DecoratedLoader());
+        const exts = base_loader_1.DocumentLoaderRegistry.registeredExtensions();
+        expect(exts).toContain('.test');
+    });
+    it('does nothing when class has no @Loader decorator', () => {
+        const before = base_loader_1.DocumentLoaderRegistry.registeredExtensions().length;
+        base_loader_1.DocumentLoaderRegistry.register(UndecoatedLoader, () => new UndecoatedLoader());
+        const after = base_loader_1.DocumentLoaderRegistry.registeredExtensions().length;
+        expect(after).toBe(before);
+    });
+});
+//# sourceMappingURL=base.loader.test.js.map

package/dist/__tests__/loaders/base.loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.loader.test.js","sourceRoot":"","sources":["../../../src/__tests__/loaders/base.loader.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/loaders/csv-file.loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=csv-file.loader.test.d.ts.map

package/dist/__tests__/loaders/csv-file.loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-file.loader.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/loaders/csv-file.loader.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/loaders/csv-file.loader.test.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+jest.mock('fs/promises', () => ({
+    readFile: jest.fn(),
+}));
+const promises_1 = require("fs/promises");
+const csv_file_loader_1 = require("../../loaders/csv-file.loader");
+const mockReadFile = promises_1.readFile;
+const CSV_BASIC = `name,age,city\nAlice,30,NYC\nBob,25,LA`;
+const CSV_QUOTED = `name,description\nAlice,"loves cats, dogs"\nBob,"says ""hello""!"`;
+const CSV_NO_HEADER = `Alice,30\nBob,25`;
+const CSV_EMPTY = ``;
+describe('CSVFileLoader', () => {
+    afterEach(() => jest.clearAllMocks());
+    it('loads CSV with header, one doc per row', async () => {
+        mockReadFile.mockResolvedValueOnce(CSV_BASIC);
+        const loader = new csv_file_loader_1.CSVFileLoader({ path: '/tmp/data.csv' });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(2);
+        expect(docs[0].content).toContain('Alice');
+        expect(docs[0].metadata?.loaderType).toBe('csv');
+        expect(docs[0].metadata?.source).toBe('data.csv');
+        expect(docs[0].metadata?.row).toBe(0);
+    });
+    it('uses contentColumns to build content', async () => {
+        mockReadFile.mockResolvedValueOnce(CSV_BASIC);
+        const loader = new csv_file_loader_1.CSVFileLoader({
+            path: '/tmp/data.csv',
+            contentColumns: ['name'],
+            metadataColumns: ['age', 'city'],
+        });
+        const docs = await loader.load();
+        expect(docs[0].content).toBe('Alice');
+        expect(docs[0].metadata?.age).toBe('30');
+        expect(docs[0].metadata?.city).toBe('NYC');
+    });
+    it('uses multiple contentColumns with key:value format', async () => {
+        mockReadFile.mockResolvedValueOnce(CSV_BASIC);
+        const loader = new csv_file_loader_1.CSVFileLoader({
+            path: '/tmp/data.csv',
+            contentColumns: ['name', 'city'],
+        });
+        const docs = await loader.load();
+        expect(docs[0].content).toContain('name: Alice');
+        expect(docs[0].content).toContain('city: NYC');
+    });
+    it('handles quoted fields with embedded commas', async () => {
+        mockReadFile.mockResolvedValueOnce(CSV_QUOTED);
+        const loader = new csv_file_loader_1.CSVFileLoader({ path: '/tmp/data.csv', contentColumns: ['description'] });
+        const docs = await loader.load();
+        expect(docs[0].content).toBe('loves cats, dogs');
+    });
+    it('handles escaped quotes inside quoted fields', async () => {
+        mockReadFile.mockResolvedValueOnce(CSV_QUOTED);
+        const loader = new csv_file_loader_1.CSVFileLoader({ path: '/tmp/data.csv', contentColumns: ['description'] });
+        const docs = await loader.load();
+        expect(docs[1].content).toContain('"hello"');
+    });
+    it('handles CSV without header row', async () => {
+        mockReadFile.mockResolvedValueOnce(CSV_NO_HEADER);
+        const loader = new csv_file_loader_1.CSVFileLoader({ path: '/tmp/data.csv', hasHeader: false });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(2);
+        expect(docs[0].content).toContain('col0');
+    });
+    it('returns empty array for empty CSV', async () => {
+        mockReadFile.mockResolvedValueOnce(CSV_EMPTY);
+        const loader = new csv_file_loader_1.CSVFileLoader({ path: '/tmp/empty.csv' });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(0);
+    });
+    it('merges extra metadata', async () => {
+        mockReadFile.mockResolvedValueOnce(CSV_BASIC);
+        const loader = new csv_file_loader_1.CSVFileLoader({
+            path: '/tmp/data.csv',
+            metadata: { project: 'test' },
+        });
+        const docs = await loader.load();
+        expect(docs[0].metadata?.project).toBe('test');
+    });
+    it('uses custom delimiter', async () => {
+        mockReadFile.mockResolvedValueOnce('a|b|c\n1|2|3');
+        const loader = new csv_file_loader_1.CSVFileLoader({ path: '/tmp/data.csv', delimiter: '|' });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(1);
+    });
+    it('uses custom content separator', async () => {
+        mockReadFile.mockResolvedValueOnce(CSV_BASIC);
+        const loader = new csv_file_loader_1.CSVFileLoader({
+            path: '/tmp/data.csv',
+            contentColumns: ['name', 'city'],
+            contentSeparator: ' | ',
+        });
+        const docs = await loader.load();
+        expect(docs[0].content).toContain(' | ');
+    });
+});
+//# sourceMappingURL=csv-file.loader.test.js.map

package/dist/__tests__/loaders/csv-file.loader.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-file.loader.test.js","sourceRoot":"","sources":["../../../src/__tests__/loaders/csv-file.loader.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/loaders/directory.loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=directory.loader.test.d.ts.map

package/dist/__tests__/loaders/directory.loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.loader.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/loaders/directory.loader.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/loaders/directory.loader.test.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+jest.mock('fs/promises', () => ({
+    readdir: jest.fn(),
+    stat: jest.fn(),
+    readFile: jest.fn(),
+}));
+const promises_1 = require("fs/promises");
+const directory_loader_1 = require("../../loaders/directory.loader");
+const mockReaddir = promises_1.readdir;
+const mockStat = promises_1.stat;
+const mockReadFile = promises_1.readFile;
+function makeStat(isDir) {
+    return { isDirectory: () => isDir };
+}
+describe('DirectoryLoader', () => {
+    afterEach(() => jest.clearAllMocks());
+    it('loads .txt files from a flat directory', async () => {
+        mockReaddir.mockResolvedValueOnce(['notes.txt']);
+        mockStat.mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce('file content');
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs' });
+        const docs = await loader.load();
+        expect(docs.length).toBeGreaterThan(0);
+        expect(docs[0].content).toBe('file content');
+        expect(docs[0].metadata?.directoryPath).toBe('/tmp/docs');
+    });
+    it('recurses into subdirectories when recursive is true', async () => {
+        mockReaddir
+            .mockResolvedValueOnce(['subdir'])
+            .mockResolvedValueOnce(['doc.txt']);
+        mockStat
+            .mockResolvedValueOnce(makeStat(true))
+            .mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce('nested content');
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs', recursive: true });
+        const docs = await loader.load();
+        expect(docs.length).toBeGreaterThan(0);
+    });
+    it('does not recurse when recursive is false', async () => {
+        mockReaddir.mockResolvedValueOnce(['subdir']);
+        mockStat.mockResolvedValueOnce(makeStat(true));
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs', recursive: false });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(0);
+    });
+    it('skips hidden files/directories', async () => {
+        mockReaddir.mockResolvedValueOnce(['.hidden', 'visible.txt']);
+        mockStat.mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce('visible');
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs' });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(1);
+        expect(docs[0].content).toBe('visible');
+    });
+    it('respects includeExtensions filter', async () => {
+        mockReaddir.mockResolvedValueOnce(['doc.txt', 'image.png']);
+        mockStat
+            .mockResolvedValueOnce(makeStat(false))
+            .mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce('text content');
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs', includeExtensions: ['.txt'] });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(1);
+    });
+    it('respects excludeExtensions filter', async () => {
+        mockReaddir.mockResolvedValueOnce(['doc.txt', 'data.json']);
+        mockStat
+            .mockResolvedValueOnce(makeStat(false))
+            .mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce('text');
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs', excludeExtensions: ['.json'] });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(1);
+    });
+    it('stops at maxFiles limit', async () => {
+        mockReaddir.mockResolvedValueOnce(['a.txt', 'b.txt', 'c.txt']);
+        mockStat
+            .mockResolvedValueOnce(makeStat(false))
+            .mockResolvedValueOnce(makeStat(false))
+            .mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce('a').mockResolvedValueOnce('b');
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs', maxFiles: 2 });
+        const docs = await loader.load();
+        expect(docs.length).toBeLessThanOrEqual(2);
+    });
+    it('uses user-supplied loader factory', async () => {
+        mockReaddir.mockResolvedValueOnce(['doc.txt']);
+        mockStat.mockResolvedValueOnce(makeStat(false));
+        const fakeDocs = [{ content: 'custom', metadata: {} }];
+        const factory = jest.fn().mockReturnValue({ load: jest.fn().mockResolvedValue(fakeDocs) });
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs', loaders: { '.txt': factory } });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(1);
+        expect(docs[0].content).toBe('custom');
+        expect(factory).toHaveBeenCalledWith(expect.stringContaining('doc.txt'));
+    });
+    it('auto-detects .md files', async () => {
+        mockReaddir.mockResolvedValueOnce(['readme.md']);
+        mockStat.mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce('# Hello');
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs' });
+        const docs = await loader.load();
+        expect(docs.length).toBeGreaterThan(0);
+    });
+    it('auto-detects .json files', async () => {
+        mockReaddir.mockResolvedValueOnce(['data.json']);
+        mockStat.mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce(JSON.stringify([{ text: 'hello' }]));
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs' });
+        const docs = await loader.load();
+        expect(docs.length).toBeGreaterThan(0);
+    });
+    it('auto-detects .csv files', async () => {
+        mockReaddir.mockResolvedValueOnce(['data.csv']);
+        mockStat.mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce('col\nval');
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs' });
+        const docs = await loader.load();
+        expect(docs.length).toBeGreaterThan(0);
+    });
+    it('auto-detects .html files', async () => {
+        mockReaddir.mockResolvedValueOnce(['page.html']);
+        mockStat.mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce('<p>hello</p>');
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs' });
+        const docs = await loader.load();
+        expect(docs.length).toBeGreaterThan(0);
+    });
+    it('skips files with unknown extensions gracefully', async () => {
+        mockReaddir.mockResolvedValueOnce(['binary.exe']);
+        mockStat.mockResolvedValueOnce(makeStat(false));
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs' });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(0);
+    });
+    it('skips files that throw errors during loading', async () => {
+        mockReaddir.mockResolvedValueOnce(['bad.txt']);
+        mockStat.mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockRejectedValueOnce(new Error('ENOENT'));
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs' });
+        const docs = await loader.load();
+        expect(docs).toHaveLength(0);
+    });
+    it('merges extra metadata into documents', async () => {
+        mockReaddir.mockResolvedValueOnce(['notes.txt']);
+        mockStat.mockResolvedValueOnce(makeStat(false));
+        mockReadFile.mockResolvedValueOnce('content');
+        const loader = new directory_loader_1.DirectoryLoader({ path: '/tmp/docs', metadata: { org: 'hazel' } });
+        const docs = await loader.load();
+        expect(docs[0].metadata?.org).toBe('hazel');
+    });
+});
+//# sourceMappingURL=directory.loader.test.js.map