@claude-flow/memory 3.0.0-alpha.2 → 3.0.0-alpha.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (253) hide show
  1. package/README.md +858 -249
  2. package/dist/agent-memory-scope.d.ts +131 -0
  3. package/dist/agent-memory-scope.d.ts.map +1 -0
  4. package/dist/agent-memory-scope.js +223 -0
  5. package/dist/agent-memory-scope.js.map +1 -0
  6. package/dist/agent-memory-scope.test.d.ts +8 -0
  7. package/dist/agent-memory-scope.test.d.ts.map +1 -0
  8. package/dist/agent-memory-scope.test.js +463 -0
  9. package/dist/agent-memory-scope.test.js.map +1 -0
  10. package/dist/agentdb-adapter.d.ts +82 -4
  11. package/dist/agentdb-adapter.d.ts.map +1 -1
  12. package/dist/agentdb-adapter.js +388 -17
  13. package/dist/agentdb-adapter.js.map +1 -1
  14. package/dist/agentdb-backend.d.ts +6 -0
  15. package/dist/agentdb-backend.d.ts.map +1 -1
  16. package/dist/agentdb-backend.js +115 -51
  17. package/dist/agentdb-backend.js.map +1 -1
  18. package/dist/auto-memory-bridge.d.ts +237 -0
  19. package/dist/auto-memory-bridge.d.ts.map +1 -0
  20. package/dist/auto-memory-bridge.js +758 -0
  21. package/dist/auto-memory-bridge.js.map +1 -0
  22. package/dist/auto-memory-bridge.test.d.ts +8 -0
  23. package/dist/auto-memory-bridge.test.d.ts.map +1 -0
  24. package/dist/auto-memory-bridge.test.js +849 -0
  25. package/dist/auto-memory-bridge.test.js.map +1 -0
  26. package/dist/benchmark.test.d.ts +2 -0
  27. package/dist/benchmark.test.d.ts.map +1 -0
  28. package/dist/benchmark.test.js +277 -0
  29. package/dist/benchmark.test.js.map +1 -0
  30. package/dist/consolidator.d.ts +96 -0
  31. package/dist/consolidator.d.ts.map +1 -0
  32. package/dist/consolidator.js +209 -0
  33. package/dist/consolidator.js.map +1 -0
  34. package/dist/consolidator.test.d.ts +17 -0
  35. package/dist/consolidator.test.d.ts.map +1 -0
  36. package/dist/consolidator.test.js +239 -0
  37. package/dist/consolidator.test.js.map +1 -0
  38. package/dist/controller-registry.d.ts +232 -0
  39. package/dist/controller-registry.d.ts.map +1 -0
  40. package/dist/controller-registry.js +1049 -0
  41. package/dist/controller-registry.js.map +1 -0
  42. package/dist/controller-registry.test.d.ts +14 -0
  43. package/dist/controller-registry.test.d.ts.map +1 -0
  44. package/dist/controller-registry.test.js +691 -0
  45. package/dist/controller-registry.test.js.map +1 -0
  46. package/dist/database-provider.d.ts +14 -2
  47. package/dist/database-provider.d.ts.map +1 -1
  48. package/dist/database-provider.js +63 -3
  49. package/dist/database-provider.js.map +1 -1
  50. package/dist/database-provider.test.js +56 -3
  51. package/dist/database-provider.test.js.map +1 -1
  52. package/dist/entity-tagger.d.ts +31 -0
  53. package/dist/entity-tagger.d.ts.map +1 -0
  54. package/dist/entity-tagger.js +80 -0
  55. package/dist/entity-tagger.js.map +1 -0
  56. package/dist/entity-tagger.test.d.ts +12 -0
  57. package/dist/entity-tagger.test.d.ts.map +1 -0
  58. package/dist/entity-tagger.test.js +70 -0
  59. package/dist/entity-tagger.test.js.map +1 -0
  60. package/dist/fts5.test.d.ts +13 -0
  61. package/dist/fts5.test.d.ts.map +1 -0
  62. package/dist/fts5.test.js +144 -0
  63. package/dist/fts5.test.js.map +1 -0
  64. package/dist/graceful-retrieval.test.d.ts +14 -0
  65. package/dist/graceful-retrieval.test.d.ts.map +1 -0
  66. package/dist/graceful-retrieval.test.js +192 -0
  67. package/dist/graceful-retrieval.test.js.map +1 -0
  68. package/dist/hnsw-index.d.ts +51 -0
  69. package/dist/hnsw-index.d.ts.map +1 -1
  70. package/dist/hnsw-index.js +396 -12
  71. package/dist/hnsw-index.js.map +1 -1
  72. package/dist/hnsw-persistence.test.d.ts +13 -0
  73. package/dist/hnsw-persistence.test.d.ts.map +1 -0
  74. package/dist/hnsw-persistence.test.js +208 -0
  75. package/dist/hnsw-persistence.test.js.map +1 -0
  76. package/dist/hybrid-backend.d.ts +28 -0
  77. package/dist/hybrid-backend.d.ts.map +1 -1
  78. package/dist/hybrid-backend.js +82 -4
  79. package/dist/hybrid-backend.js.map +1 -1
  80. package/dist/hybrid-backend.test.js +6 -5
  81. package/dist/hybrid-backend.test.js.map +1 -1
  82. package/dist/index.d.ts +167 -9
  83. package/dist/index.d.ts.map +1 -1
  84. package/dist/index.js +277 -30
  85. package/dist/index.js.map +1 -1
  86. package/dist/index.test.d.ts +10 -0
  87. package/dist/index.test.d.ts.map +1 -0
  88. package/dist/index.test.js +71 -0
  89. package/dist/index.test.js.map +1 -0
  90. package/dist/json-security.d.ts +12 -0
  91. package/dist/json-security.d.ts.map +1 -0
  92. package/dist/json-security.js +20 -0
  93. package/dist/json-security.js.map +1 -0
  94. package/dist/learning-bridge.d.ts +137 -0
  95. package/dist/learning-bridge.d.ts.map +1 -0
  96. package/dist/learning-bridge.js +335 -0
  97. package/dist/learning-bridge.js.map +1 -0
  98. package/dist/learning-bridge.test.d.ts +8 -0
  99. package/dist/learning-bridge.test.d.ts.map +1 -0
  100. package/dist/learning-bridge.test.js +578 -0
  101. package/dist/learning-bridge.test.js.map +1 -0
  102. package/dist/memory-graph.d.ts +100 -0
  103. package/dist/memory-graph.d.ts.map +1 -0
  104. package/dist/memory-graph.js +333 -0
  105. package/dist/memory-graph.js.map +1 -0
  106. package/dist/memory-graph.test.d.ts +8 -0
  107. package/dist/memory-graph.test.d.ts.map +1 -0
  108. package/dist/memory-graph.test.js +609 -0
  109. package/dist/memory-graph.test.js.map +1 -0
  110. package/dist/persistent-sona.d.ts +144 -0
  111. package/dist/persistent-sona.d.ts.map +1 -0
  112. package/dist/persistent-sona.js +332 -0
  113. package/dist/persistent-sona.js.map +1 -0
  114. package/dist/rvf-backend.d.ts +53 -0
  115. package/dist/rvf-backend.d.ts.map +1 -0
  116. package/dist/rvf-backend.js +643 -0
  117. package/dist/rvf-backend.js.map +1 -0
  118. package/dist/rvf-learning-store.d.ts +139 -0
  119. package/dist/rvf-learning-store.d.ts.map +1 -0
  120. package/dist/rvf-learning-store.js +295 -0
  121. package/dist/rvf-learning-store.js.map +1 -0
  122. package/dist/rvf-migration.d.ts +45 -0
  123. package/dist/rvf-migration.d.ts.map +1 -0
  124. package/dist/rvf-migration.js +254 -0
  125. package/dist/rvf-migration.js.map +1 -0
  126. package/dist/smart-retrieval.d.ts +118 -0
  127. package/dist/smart-retrieval.d.ts.map +1 -0
  128. package/dist/smart-retrieval.js +322 -0
  129. package/dist/smart-retrieval.js.map +1 -0
  130. package/dist/smart-retrieval.test.d.ts +2 -0
  131. package/dist/smart-retrieval.test.d.ts.map +1 -0
  132. package/dist/smart-retrieval.test.js +238 -0
  133. package/dist/smart-retrieval.test.js.map +1 -0
  134. package/dist/sqlite-backend.d.ts +10 -0
  135. package/dist/sqlite-backend.d.ts.map +1 -1
  136. package/dist/sqlite-backend.js +170 -74
  137. package/dist/sqlite-backend.js.map +1 -1
  138. package/dist/sqljs-backend.d.ts +9 -0
  139. package/dist/sqljs-backend.d.ts.map +1 -1
  140. package/dist/sqljs-backend.js +120 -29
  141. package/dist/sqljs-backend.js.map +1 -1
  142. package/dist/types.d.ts +3 -0
  143. package/dist/types.d.ts.map +1 -1
  144. package/package.json +48 -35
  145. package/.agentic-flow/intelligence.json +0 -16
  146. package/__tests__/coverage/base.css +0 -224
  147. package/__tests__/coverage/block-navigation.js +0 -87
  148. package/__tests__/coverage/coverage-final.json +0 -19
  149. package/__tests__/coverage/favicon.png +0 -0
  150. package/__tests__/coverage/index.html +0 -206
  151. package/__tests__/coverage/lcov-report/base.css +0 -224
  152. package/__tests__/coverage/lcov-report/block-navigation.js +0 -87
  153. package/__tests__/coverage/lcov-report/favicon.png +0 -0
  154. package/__tests__/coverage/lcov-report/index.html +0 -206
  155. package/__tests__/coverage/lcov-report/prettify.css +0 -1
  156. package/__tests__/coverage/lcov-report/prettify.js +0 -2
  157. package/__tests__/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  158. package/__tests__/coverage/lcov-report/sorter.js +0 -210
  159. package/__tests__/coverage/lcov-report/src/agentdb-adapter.ts.html +0 -2737
  160. package/__tests__/coverage/lcov-report/src/agentdb-backend.ts.html +0 -3130
  161. package/__tests__/coverage/lcov-report/src/application/commands/delete-memory.command.ts.html +0 -601
  162. package/__tests__/coverage/lcov-report/src/application/commands/index.html +0 -131
  163. package/__tests__/coverage/lcov-report/src/application/commands/store-memory.command.ts.html +0 -394
  164. package/__tests__/coverage/lcov-report/src/application/queries/index.html +0 -116
  165. package/__tests__/coverage/lcov-report/src/application/queries/search-memory.query.ts.html +0 -796
  166. package/__tests__/coverage/lcov-report/src/application/services/index.html +0 -116
  167. package/__tests__/coverage/lcov-report/src/application/services/memory-application-service.ts.html +0 -793
  168. package/__tests__/coverage/lcov-report/src/cache-manager.ts.html +0 -1633
  169. package/__tests__/coverage/lcov-report/src/database-provider.ts.html +0 -1618
  170. package/__tests__/coverage/lcov-report/src/domain/entities/index.html +0 -116
  171. package/__tests__/coverage/lcov-report/src/domain/entities/memory-entry.ts.html +0 -952
  172. package/__tests__/coverage/lcov-report/src/domain/services/index.html +0 -116
  173. package/__tests__/coverage/lcov-report/src/domain/services/memory-domain-service.ts.html +0 -1294
  174. package/__tests__/coverage/lcov-report/src/hnsw-index.ts.html +0 -3124
  175. package/__tests__/coverage/lcov-report/src/hybrid-backend.ts.html +0 -2167
  176. package/__tests__/coverage/lcov-report/src/index.html +0 -266
  177. package/__tests__/coverage/lcov-report/src/infrastructure/repositories/hybrid-memory-repository.ts.html +0 -1633
  178. package/__tests__/coverage/lcov-report/src/infrastructure/repositories/index.html +0 -116
  179. package/__tests__/coverage/lcov-report/src/migration.ts.html +0 -2092
  180. package/__tests__/coverage/lcov-report/src/query-builder.ts.html +0 -1711
  181. package/__tests__/coverage/lcov-report/src/sqlite-backend.ts.html +0 -2281
  182. package/__tests__/coverage/lcov-report/src/sqljs-backend.ts.html +0 -2374
  183. package/__tests__/coverage/lcov-report/src/types.ts.html +0 -2266
  184. package/__tests__/coverage/lcov.info +0 -10238
  185. package/__tests__/coverage/prettify.css +0 -1
  186. package/__tests__/coverage/prettify.js +0 -2
  187. package/__tests__/coverage/sort-arrow-sprite.png +0 -0
  188. package/__tests__/coverage/sorter.js +0 -210
  189. package/__tests__/coverage/src/agentdb-adapter.ts.html +0 -2737
  190. package/__tests__/coverage/src/agentdb-backend.ts.html +0 -3130
  191. package/__tests__/coverage/src/application/commands/delete-memory.command.ts.html +0 -601
  192. package/__tests__/coverage/src/application/commands/index.html +0 -131
  193. package/__tests__/coverage/src/application/commands/store-memory.command.ts.html +0 -394
  194. package/__tests__/coverage/src/application/queries/index.html +0 -116
  195. package/__tests__/coverage/src/application/queries/search-memory.query.ts.html +0 -796
  196. package/__tests__/coverage/src/application/services/index.html +0 -116
  197. package/__tests__/coverage/src/application/services/memory-application-service.ts.html +0 -793
  198. package/__tests__/coverage/src/cache-manager.ts.html +0 -1633
  199. package/__tests__/coverage/src/database-provider.ts.html +0 -1618
  200. package/__tests__/coverage/src/domain/entities/index.html +0 -116
  201. package/__tests__/coverage/src/domain/entities/memory-entry.ts.html +0 -952
  202. package/__tests__/coverage/src/domain/services/index.html +0 -116
  203. package/__tests__/coverage/src/domain/services/memory-domain-service.ts.html +0 -1294
  204. package/__tests__/coverage/src/hnsw-index.ts.html +0 -3124
  205. package/__tests__/coverage/src/hybrid-backend.ts.html +0 -2167
  206. package/__tests__/coverage/src/index.html +0 -266
  207. package/__tests__/coverage/src/infrastructure/repositories/hybrid-memory-repository.ts.html +0 -1633
  208. package/__tests__/coverage/src/infrastructure/repositories/index.html +0 -116
  209. package/__tests__/coverage/src/migration.ts.html +0 -2092
  210. package/__tests__/coverage/src/query-builder.ts.html +0 -1711
  211. package/__tests__/coverage/src/sqlite-backend.ts.html +0 -2281
  212. package/__tests__/coverage/src/sqljs-backend.ts.html +0 -2374
  213. package/__tests__/coverage/src/types.ts.html +0 -2266
  214. package/benchmarks/cache-hit-rate.bench.ts +0 -535
  215. package/benchmarks/hnsw-indexing.bench.ts +0 -552
  216. package/benchmarks/memory-write.bench.ts +0 -469
  217. package/benchmarks/vector-search.bench.ts +0 -449
  218. package/docs/AGENTDB-INTEGRATION.md +0 -388
  219. package/docs/CROSS_PLATFORM.md +0 -505
  220. package/docs/WINDOWS_SUPPORT.md +0 -422
  221. package/examples/agentdb-example.ts +0 -345
  222. package/examples/cross-platform-usage.ts +0 -326
  223. package/framework/benchmark.ts +0 -112
  224. package/src/agentdb-adapter.ts +0 -884
  225. package/src/agentdb-backend.test.ts +0 -339
  226. package/src/agentdb-backend.ts +0 -1016
  227. package/src/application/commands/delete-memory.command.ts +0 -172
  228. package/src/application/commands/store-memory.command.ts +0 -103
  229. package/src/application/index.ts +0 -36
  230. package/src/application/queries/search-memory.query.ts +0 -237
  231. package/src/application/services/memory-application-service.ts +0 -236
  232. package/src/cache-manager.ts +0 -516
  233. package/src/database-provider.test.ts +0 -364
  234. package/src/database-provider.ts +0 -511
  235. package/src/domain/entities/memory-entry.ts +0 -289
  236. package/src/domain/index.ts +0 -35
  237. package/src/domain/repositories/memory-repository.interface.ts +0 -120
  238. package/src/domain/services/memory-domain-service.ts +0 -403
  239. package/src/hnsw-index.ts +0 -1013
  240. package/src/hybrid-backend.test.ts +0 -399
  241. package/src/hybrid-backend.ts +0 -694
  242. package/src/index.ts +0 -515
  243. package/src/infrastructure/index.ts +0 -23
  244. package/src/infrastructure/repositories/hybrid-memory-repository.ts +0 -516
  245. package/src/migration.ts +0 -669
  246. package/src/query-builder.ts +0 -542
  247. package/src/sqlite-backend.ts +0 -732
  248. package/src/sqljs-backend.ts +0 -763
  249. package/src/types.ts +0 -727
  250. package/tmp.json +0 -0
  251. package/tsconfig.json +0 -9
  252. package/tsconfig.tsbuildinfo +0 -1
  253. package/verify-cross-platform.ts +0 -170
@@ -1,364 +0,0 @@
1
- /**
2
- * Database Provider Tests - Cross-Platform Compatibility
3
- *
4
- * Tests for platform-aware database selection and fallback mechanisms
5
- */
6
-
7
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
8
- import { createDatabase, getPlatformInfo, getAvailableProviders } from './database-provider.js';
9
- import { generateMemoryId, createDefaultEntry } from './types.js';
10
- import { unlinkSync, existsSync } from 'node:fs';
11
-
12
- describe('DatabaseProvider', () => {
13
- const testDbPath = './test-database-provider.db';
14
-
15
- afterEach(() => {
16
- // Cleanup test database
17
- if (existsSync(testDbPath)) {
18
- try {
19
- unlinkSync(testDbPath);
20
- } catch (error) {
21
- // Ignore cleanup errors
22
- }
23
- }
24
- });
25
-
26
- describe('Platform Detection', () => {
27
- it('should detect platform information', () => {
28
- const info = getPlatformInfo();
29
-
30
- expect(info).toHaveProperty('os');
31
- expect(info).toHaveProperty('isWindows');
32
- expect(info).toHaveProperty('isMacOS');
33
- expect(info).toHaveProperty('isLinux');
34
- expect(info).toHaveProperty('recommendedProvider');
35
-
36
- // Should recommend sql.js on Windows, better-sqlite3 on Unix
37
- if (info.isWindows) {
38
- expect(info.recommendedProvider).toBe('sql.js');
39
- } else {
40
- expect(info.recommendedProvider).toBe('better-sqlite3');
41
- }
42
- });
43
- });
44
-
45
- describe('Provider Availability', () => {
46
- it('should check available providers', async () => {
47
- const available = await getAvailableProviders();
48
-
49
- expect(available).toHaveProperty('betterSqlite3');
50
- expect(available).toHaveProperty('sqlJs');
51
- expect(available).toHaveProperty('json');
52
-
53
- // JSON backend should always be available
54
- expect(available.json).toBe(true);
55
- });
56
- });
57
-
58
- describe('Automatic Provider Selection', () => {
59
- it('should create database with auto provider selection', async () => {
60
- const db = await createDatabase(':memory:');
61
-
62
- expect(db).toBeDefined();
63
- await expect(db.count()).resolves.toBe(0);
64
-
65
- await db.shutdown();
66
- });
67
-
68
- it('should create persistent database with auto provider', async () => {
69
- const db = await createDatabase(testDbPath);
70
-
71
- expect(db).toBeDefined();
72
-
73
- // Store test entry
74
- const entry = createDefaultEntry({
75
- key: 'test-key',
76
- content: 'test content',
77
- namespace: 'test',
78
- });
79
-
80
- await db.store(entry);
81
- await expect(db.count()).resolves.toBe(1);
82
-
83
- await db.shutdown();
84
- });
85
- });
86
-
87
- describe('Explicit Provider Selection', () => {
88
- it('should create database with sql.js provider', async () => {
89
- const available = await getAvailableProviders();
90
-
91
- if (!available.sqlJs) {
92
- console.log('sql.js not available, skipping test');
93
- return;
94
- }
95
-
96
- const db = await createDatabase(':memory:', {
97
- provider: 'sql.js',
98
- verbose: false,
99
- });
100
-
101
- expect(db).toBeDefined();
102
-
103
- // Test basic operations
104
- const entry = createDefaultEntry({
105
- key: 'sqljs-test',
106
- content: 'testing sql.js backend',
107
- namespace: 'test',
108
- });
109
-
110
- await db.store(entry);
111
- await expect(db.count()).resolves.toBe(1);
112
-
113
- const retrieved = await db.get(entry.id);
114
- expect(retrieved).toBeDefined();
115
- expect(retrieved?.key).toBe('sqljs-test');
116
-
117
- await db.shutdown();
118
- });
119
-
120
- it('should create database with better-sqlite3 provider', async () => {
121
- const available = await getAvailableProviders();
122
-
123
- if (!available.betterSqlite3) {
124
- console.log('better-sqlite3 not available, skipping test');
125
- return;
126
- }
127
-
128
- const db = await createDatabase(':memory:', {
129
- provider: 'better-sqlite3',
130
- verbose: false,
131
- });
132
-
133
- expect(db).toBeDefined();
134
-
135
- // Test basic operations
136
- const entry = createDefaultEntry({
137
- key: 'sqlite-test',
138
- content: 'testing better-sqlite3 backend',
139
- namespace: 'test',
140
- });
141
-
142
- await db.store(entry);
143
- await expect(db.count()).resolves.toBe(1);
144
-
145
- const retrieved = await db.get(entry.id);
146
- expect(retrieved).toBeDefined();
147
- expect(retrieved?.key).toBe('sqlite-test');
148
-
149
- await db.shutdown();
150
- });
151
-
152
- it('should create database with JSON provider', async () => {
153
- const db = await createDatabase(testDbPath, {
154
- provider: 'json',
155
- verbose: false,
156
- });
157
-
158
- expect(db).toBeDefined();
159
-
160
- // Test basic operations
161
- const entry = createDefaultEntry({
162
- key: 'json-test',
163
- content: 'testing JSON backend',
164
- namespace: 'test',
165
- });
166
-
167
- await db.store(entry);
168
- await expect(db.count()).resolves.toBe(1);
169
-
170
- const retrieved = await db.get(entry.id);
171
- expect(retrieved).toBeDefined();
172
- expect(retrieved?.key).toBe('json-test');
173
-
174
- await db.shutdown();
175
- });
176
- });
177
-
178
- describe('Cross-Platform Functionality', () => {
179
- it('should handle CRUD operations consistently across providers', async () => {
180
- const available = await getAvailableProviders();
181
- const providers: Array<'better-sqlite3' | 'sql.js' | 'json'> = [];
182
-
183
- if (available.betterSqlite3) providers.push('better-sqlite3');
184
- if (available.sqlJs) providers.push('sql.js');
185
- providers.push('json'); // Always available
186
-
187
- for (const provider of providers) {
188
- const db = await createDatabase(':memory:', { provider });
189
-
190
- // Create
191
- const entry = createDefaultEntry({
192
- key: `test-${provider}`,
193
- content: `testing ${provider}`,
194
- namespace: 'cross-platform',
195
- tags: ['test', provider],
196
- });
197
-
198
- await db.store(entry);
199
-
200
- // Read
201
- const retrieved = await db.get(entry.id);
202
- expect(retrieved).toBeDefined();
203
- expect(retrieved?.key).toBe(`test-${provider}`);
204
- expect(retrieved?.tags).toContain(provider);
205
-
206
- // Update
207
- const updated = await db.update(entry.id, {
208
- content: `updated ${provider}`,
209
- });
210
- expect(updated).toBeDefined();
211
- expect(updated?.content).toBe(`updated ${provider}`);
212
-
213
- // Query
214
- const results = await db.query({
215
- type: 'hybrid',
216
- namespace: 'cross-platform',
217
- limit: 10,
218
- });
219
- expect(results.length).toBe(1);
220
- expect(results[0].key).toBe(`test-${provider}`);
221
-
222
- // Delete
223
- const deleted = await db.delete(entry.id);
224
- expect(deleted).toBe(true);
225
-
226
- await expect(db.count()).resolves.toBe(0);
227
-
228
- await db.shutdown();
229
- }
230
- });
231
-
232
- it('should handle namespace operations across providers', async () => {
233
- const db = await createDatabase(':memory:');
234
-
235
- // Create entries in different namespaces
236
- const entries = [
237
- createDefaultEntry({ key: 'entry1', content: 'content1', namespace: 'ns1' }),
238
- createDefaultEntry({ key: 'entry2', content: 'content2', namespace: 'ns1' }),
239
- createDefaultEntry({ key: 'entry3', content: 'content3', namespace: 'ns2' }),
240
- ];
241
-
242
- for (const entry of entries) {
243
- await db.store(entry);
244
- }
245
-
246
- // List namespaces
247
- const namespaces = await db.listNamespaces();
248
- expect(namespaces).toContain('ns1');
249
- expect(namespaces).toContain('ns2');
250
-
251
- // Count by namespace
252
- await expect(db.count('ns1')).resolves.toBe(2);
253
- await expect(db.count('ns2')).resolves.toBe(1);
254
-
255
- // Clear namespace
256
- const cleared = await db.clearNamespace('ns1');
257
- expect(cleared).toBe(2);
258
- await expect(db.count('ns1')).resolves.toBe(0);
259
- await expect(db.count('ns2')).resolves.toBe(1);
260
-
261
- await db.shutdown();
262
- });
263
-
264
- it('should handle bulk operations across providers', async () => {
265
- const db = await createDatabase(':memory:');
266
-
267
- // Bulk insert
268
- const entries = Array.from({ length: 10 }, (_, i) =>
269
- createDefaultEntry({
270
- key: `bulk-${i}`,
271
- content: `content ${i}`,
272
- namespace: 'bulk-test',
273
- })
274
- );
275
-
276
- await db.bulkInsert(entries);
277
- await expect(db.count('bulk-test')).resolves.toBe(10);
278
-
279
- // Bulk delete
280
- const idsToDelete = entries.slice(0, 5).map((e) => e.id);
281
- const deletedCount = await db.bulkDelete(idsToDelete);
282
- expect(deletedCount).toBe(5);
283
- await expect(db.count('bulk-test')).resolves.toBe(5);
284
-
285
- await db.shutdown();
286
- });
287
- });
288
-
289
- describe('Health Check', () => {
290
- it('should perform health check', async () => {
291
- const db = await createDatabase(':memory:');
292
-
293
- const health = await db.healthCheck();
294
-
295
- expect(health).toHaveProperty('status');
296
- expect(health).toHaveProperty('components');
297
- expect(health).toHaveProperty('timestamp');
298
- expect(health).toHaveProperty('issues');
299
- expect(health).toHaveProperty('recommendations');
300
-
301
- expect(health.components).toHaveProperty('storage');
302
- expect(health.components).toHaveProperty('index');
303
- expect(health.components).toHaveProperty('cache');
304
-
305
- await db.shutdown();
306
- });
307
- });
308
-
309
- describe('Statistics', () => {
310
- it('should provide backend statistics', async () => {
311
- const db = await createDatabase(':memory:');
312
-
313
- // Add some test data
314
- const entries = [
315
- createDefaultEntry({ key: 'stat1', content: 'content1', namespace: 'stats', type: 'semantic' }),
316
- createDefaultEntry({ key: 'stat2', content: 'content2', namespace: 'stats', type: 'episodic' }),
317
- createDefaultEntry({ key: 'stat3', content: 'content3', namespace: 'stats', type: 'semantic' }),
318
- ];
319
-
320
- for (const entry of entries) {
321
- await db.store(entry);
322
- }
323
-
324
- const stats = await db.getStats();
325
-
326
- expect(stats).toHaveProperty('totalEntries');
327
- expect(stats).toHaveProperty('entriesByNamespace');
328
- expect(stats).toHaveProperty('entriesByType');
329
- expect(stats).toHaveProperty('memoryUsage');
330
- expect(stats).toHaveProperty('avgQueryTime');
331
-
332
- expect(stats.totalEntries).toBe(3);
333
-
334
- await db.shutdown();
335
- });
336
- });
337
-
338
- describe('Error Handling', () => {
339
- it('should handle missing entries gracefully', async () => {
340
- const db = await createDatabase(':memory:');
341
-
342
- const entry = await db.get('non-existent-id');
343
- expect(entry).toBeNull();
344
-
345
- const byKey = await db.getByKey('non-existent-ns', 'non-existent-key');
346
- expect(byKey).toBeNull();
347
-
348
- await db.shutdown();
349
- });
350
-
351
- it('should handle empty queries', async () => {
352
- const db = await createDatabase(':memory:');
353
-
354
- const results = await db.query({
355
- type: 'hybrid',
356
- limit: 10,
357
- });
358
-
359
- expect(results).toEqual([]);
360
-
361
- await db.shutdown();
362
- });
363
- });
364
- });