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