bunsane 0.3.1 → 0.4.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 (224) hide show
  1. package/CHANGELOG.md +445 -318
  2. package/config/cache.config.ts +35 -1
  3. package/core/App.ts +24 -1064
  4. package/core/ArcheType.ts +78 -2110
  5. package/core/BatchLoader.ts +56 -32
  6. package/core/Entity.ts +85 -1043
  7. package/core/EntityHookManager.ts +52 -754
  8. package/core/Logger.ts +10 -0
  9. package/core/RequestContext.ts +64 -6
  10. package/core/RequestLoaders.ts +187 -36
  11. package/core/SchedulerManager.ts +28 -600
  12. package/core/app/bootstrap.ts +133 -0
  13. package/core/app/cors.ts +85 -0
  14. package/core/app/graphqlSetup.ts +56 -0
  15. package/core/app/healthEndpoints.ts +31 -0
  16. package/core/app/metricsCollector.ts +27 -0
  17. package/core/app/preparedStatementWarmup.ts +15 -0
  18. package/core/app/processHandlers.ts +43 -0
  19. package/core/app/requestRouter.ts +310 -0
  20. package/core/app/restRegistry.ts +80 -0
  21. package/core/app/shutdown.ts +97 -0
  22. package/core/app/studioRouter.ts +83 -0
  23. package/core/archetype/customTypes.ts +100 -0
  24. package/core/archetype/decorators.ts +171 -0
  25. package/core/archetype/fieldResolvers.ts +666 -0
  26. package/core/archetype/helpers.ts +29 -0
  27. package/core/archetype/relationLoader.ts +161 -0
  28. package/core/archetype/schemaBuilder.ts +141 -0
  29. package/core/archetype/weaver.ts +218 -0
  30. package/core/archetype/zodSchemaBuilder.ts +527 -0
  31. package/core/cache/CacheManager.ts +173 -267
  32. package/core/cache/CompressionUtils.ts +34 -3
  33. package/core/cache/MemoryCache.ts +40 -37
  34. package/core/cache/RedisCache.ts +4 -4
  35. package/core/cache/health.ts +30 -0
  36. package/core/cache/invalidation.ts +96 -0
  37. package/core/cache/strategies/writeInvalidate.ts +111 -0
  38. package/core/cache/strategies/writeThrough.ts +233 -0
  39. package/core/components/BaseComponent.ts +16 -8
  40. package/core/components/ComponentRegistry.ts +28 -0
  41. package/core/decorators/IndexedField.ts +1 -1
  42. package/core/entity/cacheStrategies.ts +97 -0
  43. package/core/entity/componentAccess.ts +364 -0
  44. package/core/entity/finders.ts +202 -0
  45. package/core/entity/pendingOps.ts +72 -0
  46. package/core/entity/saveEntity.ts +377 -0
  47. package/core/hooks/dispatcher.ts +439 -0
  48. package/core/hooks/guards.ts +155 -0
  49. package/core/hooks/registry.ts +247 -0
  50. package/core/metadata/definitions/Component.ts +1 -1
  51. package/core/metadata/index.ts +15 -4
  52. package/core/middleware/AccessLog.ts +8 -1
  53. package/core/middleware/RateLimit.ts +102 -105
  54. package/core/middleware/RequestId.ts +2 -9
  55. package/core/middleware/SecurityHeaders.ts +2 -11
  56. package/core/middleware/headers.ts +28 -0
  57. package/core/remote/OutboxWorker.ts +213 -183
  58. package/core/remote/RemoteManager.ts +401 -400
  59. package/core/remote/types.ts +153 -151
  60. package/core/requestScope.ts +34 -0
  61. package/core/scheduler/cronEvaluator.ts +174 -0
  62. package/core/scheduler/lifecycleHooks.ts +21 -0
  63. package/core/scheduler/lockCoordinator.ts +27 -0
  64. package/core/scheduler/metrics.ts +14 -0
  65. package/core/scheduler/taskRunner.ts +420 -0
  66. package/database/DatabaseHelper.ts +128 -101
  67. package/database/IndexingStrategy.ts +72 -2
  68. package/database/PreparedStatementCache.ts +20 -5
  69. package/database/cancellable.ts +35 -0
  70. package/database/index.ts +15 -3
  71. package/database/instrumentedDb.ts +141 -0
  72. package/endpoints/archetypes.ts +2 -8
  73. package/endpoints/tables.ts +6 -1
  74. package/gql/index.ts +1 -1
  75. package/gql/visitors/ResolverGeneratorVisitor.ts +25 -4
  76. package/package.json +22 -1
  77. package/query/CTENode.ts +5 -3
  78. package/query/ComponentInclusionNode.ts +240 -13
  79. package/query/OrNode.ts +6 -5
  80. package/query/Query.ts +203 -59
  81. package/query/QueryContext.ts +6 -0
  82. package/query/QueryDAG.ts +7 -2
  83. package/query/membershipSource.ts +66 -0
  84. package/storage/LocalStorageProvider.ts +8 -3
  85. package/studio/dist/assets/index-BMZ67Npg.js +254 -0
  86. package/studio/dist/assets/index-BpbuYz9g.css +1 -0
  87. package/studio/{index.html → dist/index.html} +3 -2
  88. package/swagger/generator.ts +11 -1
  89. package/upload/UploadManager.ts +8 -6
  90. package/utils/uuid.ts +40 -10
  91. package/.claude/settings.local.json +0 -47
  92. package/.prettierrc +0 -4
  93. package/.serena/memories/architectural-decision-no-dependency-injection.md +0 -76
  94. package/.serena/memories/architecture.md +0 -154
  95. package/.serena/memories/cache-interface-refactoring-2026-01-24.md +0 -165
  96. package/.serena/memories/code_style_and_conventions.md +0 -76
  97. package/.serena/memories/project_overview.md +0 -43
  98. package/.serena/memories/schema-dsl-plan.md +0 -107
  99. package/.serena/memories/suggested_commands.md +0 -80
  100. package/.serena/memories/typescript-compilation-status.md +0 -54
  101. package/.serena/project.yml +0 -114
  102. package/BunSane.jpg +0 -0
  103. package/CLAUDE.md +0 -198
  104. package/TODO.md +0 -2
  105. package/bun.lock +0 -302
  106. package/bunfig.toml +0 -10
  107. package/docs/SCALABILITY_PLAN.md +0 -175
  108. package/studio/bun.lock +0 -482
  109. package/studio/package.json +0 -39
  110. package/studio/postcss.config.js +0 -6
  111. package/studio/src/components/DataTable.tsx +0 -211
  112. package/studio/src/components/Layout.tsx +0 -13
  113. package/studio/src/components/PageContainer.tsx +0 -9
  114. package/studio/src/components/PageHeader.tsx +0 -13
  115. package/studio/src/components/SearchBar.tsx +0 -57
  116. package/studio/src/components/Sidebar.tsx +0 -294
  117. package/studio/src/components/ui/button.tsx +0 -56
  118. package/studio/src/components/ui/checkbox.tsx +0 -26
  119. package/studio/src/components/ui/input.tsx +0 -25
  120. package/studio/src/hooks/useDataTable.ts +0 -131
  121. package/studio/src/index.css +0 -36
  122. package/studio/src/lib/api.ts +0 -186
  123. package/studio/src/lib/utils.ts +0 -13
  124. package/studio/src/main.tsx +0 -17
  125. package/studio/src/pages/ArcheType.tsx +0 -239
  126. package/studio/src/pages/Components.tsx +0 -124
  127. package/studio/src/pages/EntityInspector.tsx +0 -302
  128. package/studio/src/pages/QueryRunner.tsx +0 -246
  129. package/studio/src/pages/Table.tsx +0 -94
  130. package/studio/src/pages/Welcome.tsx +0 -241
  131. package/studio/src/routes.tsx +0 -45
  132. package/studio/src/store/archeTypeSettings.ts +0 -30
  133. package/studio/src/store/studio.ts +0 -65
  134. package/studio/src/utils/columnHelpers.tsx +0 -114
  135. package/studio/studio-instructions.md +0 -81
  136. package/studio/tailwind.config.js +0 -77
  137. package/studio/utils.ts +0 -54
  138. package/studio/vite.config.js +0 -19
  139. package/tests/benchmark/BENCHMARK_DATABASES_PLAN.md +0 -338
  140. package/tests/benchmark/bunfig.toml +0 -9
  141. package/tests/benchmark/fixtures/EcommerceComponents.ts +0 -283
  142. package/tests/benchmark/fixtures/EcommerceDataGenerators.ts +0 -301
  143. package/tests/benchmark/fixtures/RelationTracker.ts +0 -159
  144. package/tests/benchmark/fixtures/index.ts +0 -6
  145. package/tests/benchmark/index.ts +0 -22
  146. package/tests/benchmark/noop-preload.ts +0 -3
  147. package/tests/benchmark/query-lateral-benchmark.test.ts +0 -372
  148. package/tests/benchmark/runners/BenchmarkLoader.ts +0 -132
  149. package/tests/benchmark/runners/index.ts +0 -4
  150. package/tests/benchmark/scenarios/query-benchmarks.test.ts +0 -465
  151. package/tests/benchmark/scripts/generate-db.ts +0 -344
  152. package/tests/benchmark/scripts/run-benchmarks.ts +0 -97
  153. package/tests/e2e/http.test.ts +0 -130
  154. package/tests/fixtures/archetypes/TestUserArchetype.ts +0 -21
  155. package/tests/fixtures/components/TestOrder.ts +0 -23
  156. package/tests/fixtures/components/TestProduct.ts +0 -23
  157. package/tests/fixtures/components/TestUser.ts +0 -20
  158. package/tests/fixtures/components/index.ts +0 -6
  159. package/tests/graphql/SchemaGeneration.test.ts +0 -90
  160. package/tests/graphql/builders/ResolverBuilder.test.ts +0 -223
  161. package/tests/graphql/builders/TypeDefBuilder.test.ts +0 -153
  162. package/tests/helpers/MockRedisClient.ts +0 -113
  163. package/tests/helpers/MockRedisStreamServer.ts +0 -448
  164. package/tests/integration/archetype/ArcheType.persistence.test.ts +0 -241
  165. package/tests/integration/cache/CacheInvalidation.test.ts +0 -259
  166. package/tests/integration/entity/Entity.persistence.test.ts +0 -333
  167. package/tests/integration/entity/Entity.saveTimeout.test.ts +0 -110
  168. package/tests/integration/query/Query.complexAnalysis.test.ts +0 -557
  169. package/tests/integration/query/Query.edgeCases.test.ts +0 -595
  170. package/tests/integration/query/Query.exec.test.ts +0 -576
  171. package/tests/integration/query/Query.explainAnalyze.test.ts +0 -233
  172. package/tests/integration/query/Query.jsonbArray.test.ts +0 -214
  173. package/tests/integration/remote/dlq.test.ts +0 -175
  174. package/tests/integration/remote/event-dispatch.test.ts +0 -114
  175. package/tests/integration/remote/outbox.test.ts +0 -130
  176. package/tests/integration/remote/rpc.test.ts +0 -177
  177. package/tests/pglite-setup.ts +0 -62
  178. package/tests/setup.ts +0 -164
  179. package/tests/stress/BenchmarkRunner.ts +0 -203
  180. package/tests/stress/DataSeeder.ts +0 -190
  181. package/tests/stress/StressTestReporter.ts +0 -229
  182. package/tests/stress/cursor-perf-test.ts +0 -171
  183. package/tests/stress/fixtures/RealisticComponents.ts +0 -235
  184. package/tests/stress/fixtures/StressTestComponents.ts +0 -58
  185. package/tests/stress/index.ts +0 -7
  186. package/tests/stress/scenarios/query-benchmarks.test.ts +0 -285
  187. package/tests/stress/scenarios/realistic-scenarios.test.ts +0 -1081
  188. package/tests/stress/scenarios/timeout-investigation.test.ts +0 -522
  189. package/tests/unit/BatchLoader.test.ts +0 -196
  190. package/tests/unit/archetype/ArcheType.test.ts +0 -107
  191. package/tests/unit/cache/CacheManager.test.ts +0 -367
  192. package/tests/unit/cache/MemoryCache.test.ts +0 -260
  193. package/tests/unit/cache/RedisCache.test.ts +0 -411
  194. package/tests/unit/entity/Entity.components.test.ts +0 -317
  195. package/tests/unit/entity/Entity.drainSideEffects.test.ts +0 -51
  196. package/tests/unit/entity/Entity.reload.test.ts +0 -63
  197. package/tests/unit/entity/Entity.requireComponents.test.ts +0 -72
  198. package/tests/unit/entity/Entity.test.ts +0 -345
  199. package/tests/unit/gql/depthLimit.test.ts +0 -203
  200. package/tests/unit/gql/operationMiddleware.test.ts +0 -293
  201. package/tests/unit/health/Health.test.ts +0 -129
  202. package/tests/unit/middleware/AccessLog.test.ts +0 -37
  203. package/tests/unit/middleware/Middleware.test.ts +0 -98
  204. package/tests/unit/middleware/RequestId.test.ts +0 -54
  205. package/tests/unit/middleware/SecurityHeaders.test.ts +0 -66
  206. package/tests/unit/query/FilterBuilder.test.ts +0 -111
  207. package/tests/unit/query/JsonbArrayBuilder.test.ts +0 -178
  208. package/tests/unit/query/Query.emptyString.test.ts +0 -69
  209. package/tests/unit/query/Query.test.ts +0 -310
  210. package/tests/unit/remote/CircuitBreaker.test.ts +0 -159
  211. package/tests/unit/remote/RemoteError.test.ts +0 -55
  212. package/tests/unit/remote/decorators.test.ts +0 -195
  213. package/tests/unit/remote/metrics.test.ts +0 -115
  214. package/tests/unit/remote/mockRedisStreamServer.test.ts +0 -104
  215. package/tests/unit/scheduler/DistributedLock.test.ts +0 -274
  216. package/tests/unit/scheduler/SchedulerManager.timeBased.test.ts +0 -95
  217. package/tests/unit/schema/schema-integration.test.ts +0 -426
  218. package/tests/unit/schema/schema.test.ts +0 -580
  219. package/tests/unit/storage/S3StorageProvider.test.ts +0 -567
  220. package/tests/unit/upload/RestUpload.test.ts +0 -267
  221. package/tests/unit/validateEnv.test.ts +0 -82
  222. package/tests/utils/entity-tracker.ts +0 -57
  223. package/tests/utils/index.ts +0 -13
  224. 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
- }