bunsane 0.3.2 → 0.5.0

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 (220) hide show
  1. package/CHANGELOG.md +471 -370
  2. package/core/BatchLoader.ts +56 -32
  3. package/core/Entity.ts +93 -1020
  4. package/core/EntityHookManager.ts +52 -754
  5. package/core/Logger.ts +10 -0
  6. package/core/RequestContext.ts +94 -85
  7. package/core/RequestLoaders.ts +98 -5
  8. package/core/SchedulerManager.ts +28 -600
  9. package/core/app/cors.ts +2 -11
  10. package/core/app/preparedStatementWarmup.ts +9 -49
  11. package/core/app/requestRouter.ts +9 -8
  12. package/core/app/restRegistry.ts +8 -0
  13. package/core/archetype/fieldResolvers.ts +85 -40
  14. package/core/archetype/relationLoader.ts +135 -92
  15. package/core/cache/CacheManager.ts +91 -302
  16. package/core/cache/CompressionUtils.ts +34 -3
  17. package/core/cache/MemoryCache.ts +40 -37
  18. package/core/cache/RedisCache.ts +8 -7
  19. package/core/cache/health.ts +30 -0
  20. package/core/cache/invalidation.ts +96 -0
  21. package/core/cache/strategies/writeInvalidate.ts +111 -0
  22. package/core/cache/strategies/writeThrough.ts +233 -0
  23. package/core/components/BaseComponent.ts +25 -10
  24. package/core/components/ComponentRegistry.ts +28 -0
  25. package/core/decorators/IndexedField.ts +1 -1
  26. package/core/entity/cacheStrategies.ts +97 -0
  27. package/core/entity/componentAccess.ts +383 -0
  28. package/core/entity/finders.ts +202 -0
  29. package/core/entity/getCacheManager.ts +10 -0
  30. package/core/entity/pendingOps.ts +72 -0
  31. package/core/entity/saveEntity.ts +375 -0
  32. package/core/health.ts +93 -4
  33. package/core/hooks/dispatcher.ts +439 -0
  34. package/core/hooks/guards.ts +155 -0
  35. package/core/hooks/registry.ts +247 -0
  36. package/core/metadata/definitions/Component.ts +1 -1
  37. package/core/metadata/index.ts +15 -4
  38. package/core/middleware/RateLimit.ts +102 -105
  39. package/core/middleware/RequestId.ts +2 -9
  40. package/core/middleware/SecurityHeaders.ts +2 -11
  41. package/core/middleware/headers.ts +28 -0
  42. package/core/remote/OutboxWorker.ts +213 -183
  43. package/core/remote/RemoteManager.ts +401 -400
  44. package/core/remote/StreamConsumer.ts +535 -535
  45. package/core/remote/types.ts +153 -151
  46. package/core/requestScope.ts +34 -0
  47. package/core/scheduler/cronEvaluator.ts +174 -0
  48. package/core/scheduler/lifecycleHooks.ts +21 -0
  49. package/core/scheduler/lockCoordinator.ts +27 -0
  50. package/core/scheduler/metrics.ts +14 -0
  51. package/core/scheduler/taskRunner.ts +420 -0
  52. package/core/validateEnv.ts +10 -0
  53. package/database/DatabaseHelper.ts +128 -101
  54. package/database/IndexingStrategy.ts +72 -2
  55. package/database/PreparedStatementCache.ts +8 -2
  56. package/database/cancellable.ts +35 -22
  57. package/database/index.ts +29 -3
  58. package/database/instrumentedDb.ts +141 -141
  59. package/database/sqlHelpers.ts +3 -1
  60. package/endpoints/archetypes.ts +2 -8
  61. package/endpoints/tables.ts +6 -1
  62. package/gql/index.ts +1 -1
  63. package/gql/schema/index.ts +15 -4
  64. package/gql/visitors/ResolverGeneratorVisitor.ts +25 -4
  65. package/package.json +22 -1
  66. package/query/CTENode.ts +5 -3
  67. package/query/ComponentInclusionNode.ts +245 -14
  68. package/query/OrNode.ts +8 -19
  69. package/query/Query.ts +208 -79
  70. package/query/QueryContext.ts +6 -0
  71. package/query/QueryDAG.ts +7 -2
  72. package/query/membershipSource.ts +66 -0
  73. package/storage/LocalStorageProvider.ts +8 -3
  74. package/studio/dist/assets/index-BMZ67Npg.js +254 -0
  75. package/studio/dist/assets/index-BpbuYz9g.css +1 -0
  76. package/studio/{index.html → dist/index.html} +3 -2
  77. package/swagger/generator.ts +11 -1
  78. package/upload/UploadManager.ts +8 -6
  79. package/utils/uuid.ts +40 -10
  80. package/.claude/scheduled_tasks.lock +0 -1
  81. package/.claude/settings.local.json +0 -47
  82. package/.prettierrc +0 -4
  83. package/.serena/memories/architectural-decision-no-dependency-injection.md +0 -76
  84. package/.serena/memories/architecture.md +0 -154
  85. package/.serena/memories/cache-interface-refactoring-2026-01-24.md +0 -165
  86. package/.serena/memories/code_style_and_conventions.md +0 -76
  87. package/.serena/memories/project_overview.md +0 -43
  88. package/.serena/memories/schema-dsl-plan.md +0 -107
  89. package/.serena/memories/suggested_commands.md +0 -80
  90. package/.serena/memories/typescript-compilation-status.md +0 -54
  91. package/.serena/project.yml +0 -114
  92. package/BunSane.jpg +0 -0
  93. package/CLAUDE.md +0 -198
  94. package/TODO.md +0 -2
  95. package/bun.lock +0 -302
  96. package/bunfig.toml +0 -10
  97. package/docs/RFC_APP_REFACTOR.md +0 -248
  98. package/docs/RFC_REFACTOR_TARGETS.md +0 -251
  99. package/docs/SCALABILITY_PLAN.md +0 -175
  100. package/studio/bun.lock +0 -482
  101. package/studio/package.json +0 -39
  102. package/studio/postcss.config.js +0 -6
  103. package/studio/src/components/DataTable.tsx +0 -211
  104. package/studio/src/components/Layout.tsx +0 -13
  105. package/studio/src/components/PageContainer.tsx +0 -9
  106. package/studio/src/components/PageHeader.tsx +0 -13
  107. package/studio/src/components/SearchBar.tsx +0 -57
  108. package/studio/src/components/Sidebar.tsx +0 -294
  109. package/studio/src/components/ui/button.tsx +0 -56
  110. package/studio/src/components/ui/checkbox.tsx +0 -26
  111. package/studio/src/components/ui/input.tsx +0 -25
  112. package/studio/src/hooks/useDataTable.ts +0 -131
  113. package/studio/src/index.css +0 -36
  114. package/studio/src/lib/api.ts +0 -186
  115. package/studio/src/lib/utils.ts +0 -13
  116. package/studio/src/main.tsx +0 -17
  117. package/studio/src/pages/ArcheType.tsx +0 -239
  118. package/studio/src/pages/Components.tsx +0 -124
  119. package/studio/src/pages/EntityInspector.tsx +0 -302
  120. package/studio/src/pages/QueryRunner.tsx +0 -246
  121. package/studio/src/pages/Table.tsx +0 -94
  122. package/studio/src/pages/Welcome.tsx +0 -241
  123. package/studio/src/routes.tsx +0 -45
  124. package/studio/src/store/archeTypeSettings.ts +0 -30
  125. package/studio/src/store/studio.ts +0 -65
  126. package/studio/src/utils/columnHelpers.tsx +0 -114
  127. package/studio/studio-instructions.md +0 -81
  128. package/studio/tailwind.config.js +0 -77
  129. package/studio/utils.ts +0 -54
  130. package/studio/vite.config.js +0 -19
  131. package/tests/benchmark/BENCHMARK_DATABASES_PLAN.md +0 -338
  132. package/tests/benchmark/bunfig.toml +0 -9
  133. package/tests/benchmark/fixtures/EcommerceComponents.ts +0 -283
  134. package/tests/benchmark/fixtures/EcommerceDataGenerators.ts +0 -301
  135. package/tests/benchmark/fixtures/RelationTracker.ts +0 -159
  136. package/tests/benchmark/fixtures/index.ts +0 -6
  137. package/tests/benchmark/index.ts +0 -22
  138. package/tests/benchmark/noop-preload.ts +0 -3
  139. package/tests/benchmark/query-lateral-benchmark.test.ts +0 -372
  140. package/tests/benchmark/runners/BenchmarkLoader.ts +0 -132
  141. package/tests/benchmark/runners/index.ts +0 -4
  142. package/tests/benchmark/scenarios/query-benchmarks.test.ts +0 -465
  143. package/tests/benchmark/scripts/generate-db.ts +0 -344
  144. package/tests/benchmark/scripts/run-benchmarks.ts +0 -97
  145. package/tests/e2e/http.test.ts +0 -130
  146. package/tests/fixtures/archetypes/TestUserArchetype.ts +0 -21
  147. package/tests/fixtures/components/TestOrder.ts +0 -23
  148. package/tests/fixtures/components/TestProduct.ts +0 -23
  149. package/tests/fixtures/components/TestUser.ts +0 -20
  150. package/tests/fixtures/components/index.ts +0 -6
  151. package/tests/graphql/SchemaGeneration.test.ts +0 -90
  152. package/tests/graphql/builders/ResolverBuilder.test.ts +0 -223
  153. package/tests/graphql/builders/TypeDefBuilder.test.ts +0 -153
  154. package/tests/helpers/MockRedisClient.ts +0 -113
  155. package/tests/helpers/MockRedisStreamServer.ts +0 -448
  156. package/tests/integration/archetype/ArcheType.persistence.test.ts +0 -241
  157. package/tests/integration/cache/CacheInvalidation.test.ts +0 -259
  158. package/tests/integration/entity/Entity.persistence.test.ts +0 -333
  159. package/tests/integration/entity/Entity.saveTimeout.test.ts +0 -110
  160. package/tests/integration/loaders/RequestLoaders.abort.test.ts +0 -82
  161. package/tests/integration/query/Query.abort.test.ts +0 -66
  162. package/tests/integration/query/Query.complexAnalysis.test.ts +0 -557
  163. package/tests/integration/query/Query.edgeCases.test.ts +0 -595
  164. package/tests/integration/query/Query.exec.test.ts +0 -576
  165. package/tests/integration/query/Query.explainAnalyze.test.ts +0 -233
  166. package/tests/integration/query/Query.jsonbArray.test.ts +0 -214
  167. package/tests/integration/remote/dlq.test.ts +0 -175
  168. package/tests/integration/remote/event-dispatch.test.ts +0 -114
  169. package/tests/integration/remote/outbox.test.ts +0 -130
  170. package/tests/integration/remote/rpc.test.ts +0 -177
  171. package/tests/pglite-setup.ts +0 -62
  172. package/tests/setup.ts +0 -164
  173. package/tests/stress/BenchmarkRunner.ts +0 -203
  174. package/tests/stress/DataSeeder.ts +0 -190
  175. package/tests/stress/StressTestReporter.ts +0 -229
  176. package/tests/stress/cursor-perf-test.ts +0 -171
  177. package/tests/stress/fixtures/RealisticComponents.ts +0 -235
  178. package/tests/stress/fixtures/StressTestComponents.ts +0 -58
  179. package/tests/stress/index.ts +0 -7
  180. package/tests/stress/scenarios/query-benchmarks.test.ts +0 -285
  181. package/tests/stress/scenarios/realistic-scenarios.test.ts +0 -1081
  182. package/tests/stress/scenarios/timeout-investigation.test.ts +0 -522
  183. package/tests/unit/BatchLoader.test.ts +0 -196
  184. package/tests/unit/archetype/ArcheType.test.ts +0 -107
  185. package/tests/unit/cache/CacheManager.test.ts +0 -498
  186. package/tests/unit/cache/MemoryCache.test.ts +0 -260
  187. package/tests/unit/cache/RedisCache.test.ts +0 -411
  188. package/tests/unit/database/cancellable.test.ts +0 -81
  189. package/tests/unit/database/instrumentedDb.test.ts +0 -160
  190. package/tests/unit/entity/Entity.components.test.ts +0 -317
  191. package/tests/unit/entity/Entity.drainSideEffects.test.ts +0 -51
  192. package/tests/unit/entity/Entity.reload.test.ts +0 -63
  193. package/tests/unit/entity/Entity.requireComponents.test.ts +0 -72
  194. package/tests/unit/entity/Entity.test.ts +0 -345
  195. package/tests/unit/gql/depthLimit.test.ts +0 -203
  196. package/tests/unit/gql/operationMiddleware.test.ts +0 -293
  197. package/tests/unit/health/Health.test.ts +0 -129
  198. package/tests/unit/middleware/AccessLog.test.ts +0 -37
  199. package/tests/unit/middleware/Middleware.test.ts +0 -98
  200. package/tests/unit/middleware/RequestId.test.ts +0 -54
  201. package/tests/unit/middleware/SecurityHeaders.test.ts +0 -66
  202. package/tests/unit/query/FilterBuilder.test.ts +0 -111
  203. package/tests/unit/query/JsonbArrayBuilder.test.ts +0 -178
  204. package/tests/unit/query/Query.emptyString.test.ts +0 -69
  205. package/tests/unit/query/Query.test.ts +0 -310
  206. package/tests/unit/remote/CircuitBreaker.test.ts +0 -159
  207. package/tests/unit/remote/RemoteError.test.ts +0 -55
  208. package/tests/unit/remote/decorators.test.ts +0 -195
  209. package/tests/unit/remote/metrics.test.ts +0 -115
  210. package/tests/unit/remote/mockRedisStreamServer.test.ts +0 -104
  211. package/tests/unit/scheduler/DistributedLock.test.ts +0 -274
  212. package/tests/unit/scheduler/SchedulerManager.timeBased.test.ts +0 -95
  213. package/tests/unit/schema/schema-integration.test.ts +0 -426
  214. package/tests/unit/schema/schema.test.ts +0 -580
  215. package/tests/unit/storage/S3StorageProvider.test.ts +0 -567
  216. package/tests/unit/upload/RestUpload.test.ts +0 -267
  217. package/tests/unit/validateEnv.test.ts +0 -82
  218. package/tests/utils/entity-tracker.ts +0 -57
  219. package/tests/utils/index.ts +0 -13
  220. package/tests/utils/test-context.ts +0 -149
@@ -1,267 +0,0 @@
1
- import { describe, it, expect, beforeEach, mock, spyOn } from "bun:test";
2
- import {
3
- parseFormData,
4
- handleUpload,
5
- uploadResponse,
6
- uploadErrorResponse,
7
- } from "../../../upload/RestUpload";
8
- import { UploadManager } from "../../../upload/UploadManager";
9
- import type { UploadResult } from "../../../types/upload.types";
10
-
11
- function createMultipartRequest(
12
- files: { name: string; content: string; type: string; fieldName?: string }[],
13
- fields?: Record<string, string>,
14
- ): Request {
15
- const formData = new FormData();
16
- for (const f of files) {
17
- const file = new File([f.content], f.name, { type: f.type });
18
- formData.append(f.fieldName ?? "file", file);
19
- }
20
- if (fields) {
21
- for (const [k, v] of Object.entries(fields)) {
22
- formData.append(k, v);
23
- }
24
- }
25
- return new Request("http://localhost/upload", {
26
- method: "POST",
27
- body: formData,
28
- });
29
- }
30
-
31
- describe("parseFormData", () => {
32
- it("extracts files and text fields", async () => {
33
- const req = createMultipartRequest(
34
- [{ name: "photo.png", content: "imagedata", type: "image/png" }],
35
- { description: "My photo", tag: "avatar" },
36
- );
37
-
38
- const { files, fields } = await parseFormData(req);
39
- expect(files).toHaveLength(1);
40
- expect(files[0]!.file.name).toBe("photo.png");
41
- expect(files[0]!.fieldName).toBe("file");
42
- expect(fields["description"]).toBe("My photo");
43
- expect(fields["tag"]).toBe("avatar");
44
- });
45
-
46
- it("handles multiple files", async () => {
47
- const req = createMultipartRequest([
48
- { name: "a.png", content: "a", type: "image/png", fieldName: "photos" },
49
- { name: "b.jpg", content: "b", type: "image/jpeg", fieldName: "photos" },
50
- ]);
51
-
52
- const { files } = await parseFormData(req);
53
- expect(files).toHaveLength(2);
54
- expect(files[0]!.file.name).toBe("a.png");
55
- expect(files[1]!.file.name).toBe("b.jpg");
56
- });
57
-
58
- it("throws for non-multipart Content-Type", async () => {
59
- const req = new Request("http://localhost/upload", {
60
- method: "POST",
61
- body: JSON.stringify({ data: "test" }),
62
- headers: { "Content-Type": "application/json" },
63
- });
64
-
65
- await expect(parseFormData(req)).rejects.toThrow(
66
- "Invalid Content-Type: expected multipart/form-data",
67
- );
68
- });
69
-
70
- it("returns empty files array when no files in form", async () => {
71
- const formData = new FormData();
72
- formData.append("name", "test");
73
- const req = new Request("http://localhost/upload", {
74
- method: "POST",
75
- body: formData,
76
- });
77
-
78
- const { files, fields } = await parseFormData(req);
79
- expect(files).toHaveLength(0);
80
- expect(fields.name).toBe("test");
81
- });
82
- });
83
-
84
- describe("handleUpload", () => {
85
- const successResult: UploadResult = {
86
- success: true,
87
- uploadId: "uid-1",
88
- fileName: "test.png",
89
- originalFileName: "photo.png",
90
- mimeType: "image/png",
91
- size: 1024,
92
- path: "uploads/test.png",
93
- url: "/uploads/test.png",
94
- };
95
-
96
- const failResult: UploadResult = {
97
- success: false,
98
- error: {
99
- uploadId: "uid-2",
100
- code: "VALIDATION_FAILED",
101
- message: "File too large",
102
- },
103
- };
104
-
105
- let uploadFileSpy: ReturnType<typeof spyOn>;
106
-
107
- beforeEach(() => {
108
- uploadFileSpy = spyOn(
109
- UploadManager.getInstance(),
110
- "uploadFile",
111
- ).mockResolvedValue(successResult);
112
- uploadFileSpy.mockClear();
113
- });
114
-
115
- it("pipes files through UploadManager", async () => {
116
- const req = createMultipartRequest([
117
- { name: "photo.png", content: "data", type: "image/png" },
118
- ]);
119
-
120
- const result = await handleUpload(req);
121
- expect(result.success).toBe(true);
122
- expect(result.totalFiles).toBe(1);
123
- expect(result.successCount).toBe(1);
124
- expect(result.failureCount).toBe(0);
125
- expect(result.files).toHaveLength(1);
126
- expect(uploadFileSpy).toHaveBeenCalledTimes(1);
127
- });
128
-
129
- it("enforces maxFiles limit", async () => {
130
- const req = createMultipartRequest([
131
- { name: "a.png", content: "a", type: "image/png" },
132
- { name: "b.png", content: "b", type: "image/png" },
133
- { name: "c.png", content: "c", type: "image/png" },
134
- ]);
135
-
136
- await expect(handleUpload(req, { maxFiles: 2 })).rejects.toThrow(
137
- "Too many files: received 3, maximum is 2",
138
- );
139
- });
140
-
141
- it("filters by fieldNames", async () => {
142
- const req = createMultipartRequest([
143
- { name: "a.png", content: "a", type: "image/png", fieldName: "avatar" },
144
- { name: "b.png", content: "b", type: "image/png", fieldName: "banner" },
145
- ]);
146
-
147
- const result = await handleUpload(req, { fieldNames: ["avatar"] });
148
- expect(result.totalFiles).toBe(1);
149
- expect(uploadFileSpy).toHaveBeenCalledTimes(1);
150
- });
151
-
152
- it("passes config and storageProvider to UploadManager", async () => {
153
- const req = createMultipartRequest([
154
- { name: "a.png", content: "a", type: "image/png" },
155
- ]);
156
- const config = { maxFileSize: 5_000_000 };
157
-
158
- await handleUpload(req, { config, storageProvider: "s3" });
159
- expect(uploadFileSpy).toHaveBeenCalledWith(
160
- expect.any(File),
161
- config,
162
- "s3",
163
- );
164
- });
165
-
166
- it("reports partial failures correctly", async () => {
167
- let callCount = 0;
168
- uploadFileSpy.mockImplementation(async () => {
169
- callCount++;
170
- return callCount === 1 ? successResult : failResult;
171
- });
172
-
173
- const req = createMultipartRequest([
174
- { name: "a.png", content: "a", type: "image/png" },
175
- { name: "b.png", content: "b", type: "image/png" },
176
- ]);
177
-
178
- const result = await handleUpload(req);
179
- expect(result.success).toBe(false);
180
- expect(result.successCount).toBe(1);
181
- expect(result.failureCount).toBe(1);
182
- });
183
-
184
- it("includes text fields in result", async () => {
185
- const req = createMultipartRequest(
186
- [{ name: "a.png", content: "a", type: "image/png" }],
187
- { title: "My Upload" },
188
- );
189
-
190
- const result = await handleUpload(req);
191
- expect(result.fields.title).toBe("My Upload");
192
- });
193
- });
194
-
195
- describe("uploadResponse", () => {
196
- it("returns 200 for all-success", () => {
197
- const result = {
198
- success: true,
199
- files: [],
200
- fields: {},
201
- totalFiles: 2,
202
- successCount: 2,
203
- failureCount: 0,
204
- };
205
-
206
- const res = uploadResponse(result);
207
- expect(res.status).toBe(200);
208
- expect(res.headers.get("Content-Type")).toBe("application/json");
209
- });
210
-
211
- it("returns 207 for partial success", () => {
212
- const result = {
213
- success: false,
214
- files: [],
215
- fields: {},
216
- totalFiles: 2,
217
- successCount: 1,
218
- failureCount: 1,
219
- };
220
-
221
- const res = uploadResponse(result);
222
- expect(res.status).toBe(207);
223
- });
224
-
225
- it("returns 400 when all failed", () => {
226
- const result = {
227
- success: false,
228
- files: [],
229
- fields: {},
230
- totalFiles: 2,
231
- successCount: 0,
232
- failureCount: 2,
233
- };
234
-
235
- const res = uploadResponse(result);
236
- expect(res.status).toBe(400);
237
- });
238
- });
239
-
240
- describe("uploadErrorResponse", () => {
241
- it("returns error JSON with default status", async () => {
242
- const res = uploadErrorResponse(new Error("Bad file"));
243
- expect(res.status).toBe(400);
244
-
245
- const body = await res.json();
246
- expect(body.error).toBe("Bad file");
247
- expect(body.code).toBe("UPLOAD_FAILED");
248
- });
249
-
250
- it("uses custom code and status", async () => {
251
- const res = uploadErrorResponse(
252
- new Error("Too big"),
253
- "FILE_TOO_LARGE",
254
- 413,
255
- );
256
- expect(res.status).toBe(413);
257
-
258
- const body = await res.json();
259
- expect(body.code).toBe("FILE_TOO_LARGE");
260
- });
261
-
262
- it("handles non-Error values", async () => {
263
- const res = uploadErrorResponse("something went wrong");
264
- const body = await res.json();
265
- expect(body.error).toBe("Unknown upload error");
266
- });
267
- });
@@ -1,82 +0,0 @@
1
- import { describe, test, expect, beforeEach, afterEach } from "bun:test";
2
- import { validateEnv } from "../../core/validateEnv";
3
-
4
- describe("validateEnv", () => {
5
- let savedEnv: NodeJS.ProcessEnv;
6
-
7
- beforeEach(() => {
8
- savedEnv = { ...process.env };
9
- // Clear all DB-related env vars
10
- delete process.env.DB_CONNECTION_URL;
11
- delete process.env.POSTGRES_HOST;
12
- delete process.env.POSTGRES_USER;
13
- delete process.env.POSTGRES_PASSWORD;
14
- delete process.env.POSTGRES_DB;
15
- delete process.env.POSTGRES_PORT;
16
- delete process.env.POSTGRES_MAX_CONNECTIONS;
17
- delete process.env.APP_PORT;
18
- delete process.env.NODE_ENV;
19
- delete process.env.GRAPHQL_MAX_DEPTH;
20
- });
21
-
22
- afterEach(() => {
23
- process.env = savedEnv;
24
- });
25
-
26
- test("passes with DB_CONNECTION_URL", () => {
27
- process.env.DB_CONNECTION_URL = "postgres://user:pass@localhost:5432/db";
28
- expect(() => validateEnv()).not.toThrow();
29
- });
30
-
31
- test("passes with POSTGRES_HOST + POSTGRES_USER + POSTGRES_DB", () => {
32
- process.env.POSTGRES_HOST = "localhost";
33
- process.env.POSTGRES_USER = "user";
34
- process.env.POSTGRES_DB = "testdb";
35
- expect(() => validateEnv()).not.toThrow();
36
- });
37
-
38
- test("throws when neither DB connection method provided", () => {
39
- expect(() => validateEnv()).toThrow("Database connection required");
40
- });
41
-
42
- test("throws for non-numeric APP_PORT", () => {
43
- process.env.DB_CONNECTION_URL = "postgres://user:pass@localhost:5432/db";
44
- process.env.APP_PORT = "abc";
45
- expect(() => validateEnv()).toThrow("APP_PORT must be numeric");
46
- });
47
-
48
- test("throws for invalid NODE_ENV", () => {
49
- process.env.DB_CONNECTION_URL = "postgres://user:pass@localhost:5432/db";
50
- process.env.NODE_ENV = "staging";
51
- expect(() => validateEnv()).toThrow("Environment validation failed");
52
- });
53
-
54
- test("passes when optional vars omitted", () => {
55
- process.env.DB_CONNECTION_URL = "postgres://user:pass@localhost:5432/db";
56
- // No APP_PORT, NODE_ENV, POSTGRES_PORT, POSTGRES_MAX_CONNECTIONS
57
- expect(() => validateEnv()).not.toThrow();
58
- });
59
-
60
- test("throws for non-numeric POSTGRES_PORT", () => {
61
- process.env.DB_CONNECTION_URL = "postgres://user:pass@localhost:5432/db";
62
- process.env.POSTGRES_PORT = "not-a-number";
63
- expect(() => validateEnv()).toThrow("POSTGRES_PORT must be numeric");
64
- });
65
-
66
- test("throws for non-numeric POSTGRES_MAX_CONNECTIONS", () => {
67
- process.env.DB_CONNECTION_URL = "postgres://user:pass@localhost:5432/db";
68
- process.env.POSTGRES_MAX_CONNECTIONS = "many";
69
- expect(() => validateEnv()).toThrow(
70
- "POSTGRES_MAX_CONNECTIONS must be numeric",
71
- );
72
- });
73
-
74
- test("passes with valid optional numeric fields", () => {
75
- process.env.DB_CONNECTION_URL = "postgres://user:pass@localhost:5432/db";
76
- process.env.APP_PORT = "3000";
77
- process.env.POSTGRES_PORT = "5432";
78
- process.env.POSTGRES_MAX_CONNECTIONS = "20";
79
- process.env.GRAPHQL_MAX_DEPTH = "15";
80
- expect(() => validateEnv()).not.toThrow();
81
- });
82
- });
@@ -1,57 +0,0 @@
1
- /**
2
- * Entity tracker for automatic cleanup in tests
3
- */
4
- import { Entity } from '../../core/Entity';
5
-
6
- /**
7
- * Tracks entities created during a test for cleanup
8
- */
9
- export class EntityTracker {
10
- private entities: Entity[] = [];
11
-
12
- /**
13
- * Track an entity for cleanup after the test
14
- */
15
- track(entity: Entity): Entity {
16
- this.entities.push(entity);
17
- return entity;
18
- }
19
-
20
- /**
21
- * Create and track a new entity
22
- */
23
- create(id?: string): Entity {
24
- const entity = new Entity(id);
25
- return this.track(entity);
26
- }
27
-
28
- /**
29
- * Clean up all tracked entities (soft delete by default)
30
- */
31
- async cleanup(hardDelete: boolean = true): Promise<void> {
32
- for (const entity of this.entities) {
33
- try {
34
- if (entity._persisted) {
35
- await entity.delete(hardDelete);
36
- }
37
- } catch {
38
- // Ignore cleanup errors - entity may already be deleted
39
- }
40
- }
41
- this.entities = [];
42
- }
43
-
44
- /**
45
- * Get count of tracked entities
46
- */
47
- get count(): number {
48
- return this.entities.length;
49
- }
50
-
51
- /**
52
- * Get all tracked entities
53
- */
54
- get all(): Entity[] {
55
- return [...this.entities];
56
- }
57
- }
@@ -1,13 +0,0 @@
1
- /**
2
- * Re-export all test utilities
3
- */
4
- export { EntityTracker } from './entity-tracker';
5
- export {
6
- createTestContext,
7
- createTestContextWithoutCache,
8
- ensureComponentRegistered,
9
- ensureComponentsRegistered,
10
- generateTestId,
11
- delay,
12
- type TestContext
13
- } from './test-context';
@@ -1,149 +0,0 @@
1
- /**
2
- * Test context factory for setting up and tearing down test environments
3
- */
4
- import { beforeEach, afterEach } from 'bun:test';
5
- import { EntityTracker } from './entity-tracker';
6
- import { CacheManager } from '../../core/cache';
7
- import EntityManager from '../../core/EntityManager';
8
- import { ComponentRegistry } from '../../core/components';
9
- import db from '../../database';
10
- import { preparedStatementCache } from '../../database/PreparedStatementCache';
11
-
12
- export interface TestContext {
13
- tracker: EntityTracker;
14
- cacheManager: CacheManager;
15
- db: typeof db;
16
- }
17
-
18
- /**
19
- * Creates a test context with automatic setup and cleanup
20
- *
21
- * Usage:
22
- * ```typescript
23
- * describe('My Test', () => {
24
- * const ctx = createTestContext();
25
- *
26
- * test('should work', async () => {
27
- * const entity = ctx.tracker.create();
28
- * entity.add(MyComponent, { value: 'test' });
29
- * await entity.save();
30
- * // Entity will be automatically cleaned up after test
31
- * });
32
- * });
33
- * ```
34
- */
35
- export function createTestContext(): TestContext {
36
- const tracker = new EntityTracker();
37
- let cacheManager: CacheManager;
38
-
39
- beforeEach(async () => {
40
- // Ensure EntityManager is ready
41
- (EntityManager as any).dbReady = true;
42
-
43
- // Initialize cache with memory provider
44
- cacheManager = CacheManager.getInstance();
45
- await cacheManager.initialize({
46
- enabled: true,
47
- provider: 'memory',
48
- strategy: 'write-through',
49
- defaultTTL: 3600000,
50
- entity: { enabled: true, ttl: 3600000 },
51
- component: { enabled: true, ttl: 1800000 },
52
- query: { enabled: false, ttl: 300000, maxSize: 10000 }
53
- });
54
-
55
- // Clear cache before each test
56
- await cacheManager.getProvider().clear();
57
-
58
- // Clear prepared statement cache to prevent cache pollution between tests
59
- preparedStatementCache.clear();
60
- });
61
-
62
- afterEach(async () => {
63
- // Clean up tracked entities
64
- await tracker.cleanup();
65
-
66
- // Clear cache after test
67
- try {
68
- await cacheManager?.getProvider().clear();
69
- } catch {
70
- // Ignore
71
- }
72
- });
73
-
74
- return {
75
- tracker,
76
- get cacheManager() {
77
- return CacheManager.getInstance();
78
- },
79
- db
80
- };
81
- }
82
-
83
- /**
84
- * Creates a test context with cache disabled
85
- */
86
- export function createTestContextWithoutCache(): TestContext {
87
- const tracker = new EntityTracker();
88
-
89
- beforeEach(async () => {
90
- (EntityManager as any).dbReady = true;
91
- const cacheManager = CacheManager.getInstance();
92
- await cacheManager.initialize({
93
- enabled: false,
94
- provider: 'memory',
95
- strategy: 'write-through',
96
- defaultTTL: 0,
97
- entity: { enabled: false, ttl: 0 },
98
- component: { enabled: false, ttl: 0 },
99
- query: { enabled: false, ttl: 0, maxSize: 10000 }
100
- });
101
- });
102
-
103
- afterEach(async () => {
104
- await tracker.cleanup();
105
- });
106
-
107
- return {
108
- tracker,
109
- get cacheManager() {
110
- return CacheManager.getInstance();
111
- },
112
- db
113
- };
114
- }
115
-
116
- /**
117
- * Ensures a component is registered before running tests
118
- */
119
- export async function ensureComponentRegistered(
120
- componentClass: new (...args: any[]) => any
121
- ): Promise<void> {
122
- const componentName = componentClass.name;
123
- await ComponentRegistry.getReadyPromise(componentName);
124
- }
125
-
126
- /**
127
- * Ensures multiple components are registered before running tests
128
- */
129
- export async function ensureComponentsRegistered(
130
- ...componentClasses: Array<new (...args: any[]) => any>
131
- ): Promise<void> {
132
- await Promise.all(componentClasses.map(c => ensureComponentRegistered(c)));
133
- }
134
-
135
- /**
136
- * Generates a unique test ID
137
- */
138
- export function generateTestId(prefix: string = 'test'): string {
139
- const timestamp = Date.now().toString(36);
140
- const random = Math.random().toString(36).substring(2, 8);
141
- return `${prefix}-${timestamp}-${random}`;
142
- }
143
-
144
- /**
145
- * Creates a delay (useful for testing async operations)
146
- */
147
- export function delay(ms: number): Promise<void> {
148
- return new Promise(resolve => setTimeout(resolve, ms));
149
- }