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,345 +0,0 @@
1
- /**
2
- * Unit tests for Entity class
3
- * Tests core entity functionality without database interaction
4
- */
5
- import { describe, test, expect, beforeAll } from 'bun:test';
6
- import { Entity } from '../../../core/Entity';
7
- import { TestUser, TestProduct } from '../../fixtures/components';
8
- import { ensureComponentsRegistered } from '../../utils';
9
-
10
- describe('Entity', () => {
11
- beforeAll(async () => {
12
- await ensureComponentsRegistered(TestUser, TestProduct);
13
- });
14
-
15
- describe('constructor', () => {
16
- test('generates a UUID when no id is provided', () => {
17
- const entity = new Entity();
18
- expect(entity.id).toBeDefined();
19
- expect(entity.id.length).toBeGreaterThan(0);
20
- // UUIDv7 format check
21
- expect(entity.id).toMatch(/^[0-9a-f-]{36}$/i);
22
- });
23
-
24
- test('uses provided id when given', () => {
25
- const customId = '12345678-1234-1234-1234-123456789abc';
26
- const entity = new Entity(customId);
27
- expect(entity.id).toBe(customId);
28
- });
29
-
30
- test('generates UUID when empty string is provided', () => {
31
- const entity = new Entity('');
32
- expect(entity.id).toBeDefined();
33
- expect(entity.id.length).toBeGreaterThan(0);
34
- expect(entity.id).not.toBe('');
35
- });
36
-
37
- test('generates UUID when whitespace string is provided', () => {
38
- const entity = new Entity(' ');
39
- expect(entity.id).toBeDefined();
40
- expect(entity.id.trim().length).toBeGreaterThan(0);
41
- });
42
-
43
- test('sets dirty flag to true initially', () => {
44
- const entity = new Entity();
45
- expect((entity as any)._dirty).toBe(true);
46
- });
47
-
48
- test('sets persisted flag to false initially', () => {
49
- const entity = new Entity();
50
- expect(entity._persisted).toBe(false);
51
- });
52
- });
53
-
54
- describe('add()', () => {
55
- test('adds a component to the entity', () => {
56
- const entity = new Entity();
57
- entity.add(TestUser, { name: 'John', email: 'john@example.com', age: 30 });
58
-
59
- const components = entity.componentList();
60
- expect(components.length).toBe(1);
61
- expect(components[0]).toBeInstanceOf(TestUser);
62
- });
63
-
64
- test('adds component with provided data', () => {
65
- const entity = new Entity();
66
- entity.add(TestUser, { name: 'Jane', email: 'jane@example.com', age: 25 });
67
-
68
- const component = entity.getInMemory(TestUser);
69
- expect(component).toBeDefined();
70
- expect(component?.name).toBe('Jane');
71
- expect(component?.email).toBe('jane@example.com');
72
- expect(component?.age).toBe(25);
73
- });
74
-
75
- test('adds component without data (defaults)', () => {
76
- const entity = new Entity();
77
- entity.add(TestUser);
78
-
79
- const components = entity.componentList();
80
- expect(components.length).toBe(1);
81
- });
82
-
83
- test('marks entity as dirty after adding component', () => {
84
- const entity = new Entity();
85
- entity.setDirty(false);
86
- entity.add(TestUser, { name: 'Test', email: 'test@test.com', age: 20 });
87
- expect((entity as any)._dirty).toBe(true);
88
- });
89
-
90
- test('allows adding multiple different components', () => {
91
- const entity = new Entity();
92
- entity.add(TestUser, { name: 'User', email: 'user@test.com', age: 30 });
93
- entity.add(TestProduct, { sku: 'SKU123', name: 'Product', price: 99.99, inStock: true });
94
-
95
- const components = entity.componentList();
96
- expect(components.length).toBe(2);
97
- expect(entity.getInMemory(TestUser)).toBeDefined();
98
- expect(entity.getInMemory(TestProduct)).toBeDefined();
99
- });
100
-
101
- test('returns this for method chaining', () => {
102
- const entity = new Entity();
103
- const result = entity.add(TestUser, { name: 'Test', email: 'test@test.com', age: 20 });
104
- expect(result).toBe(entity);
105
- });
106
- });
107
-
108
- describe('getInMemory()', () => {
109
- test('returns component if already loaded', () => {
110
- const entity = new Entity();
111
- entity.add(TestUser, { name: 'Test', email: 'test@test.com', age: 25 });
112
-
113
- const component = entity.getInMemory(TestUser);
114
- expect(component).toBeDefined();
115
- expect(component?.name).toBe('Test');
116
- });
117
-
118
- test('returns undefined if component not loaded', () => {
119
- const entity = new Entity();
120
- const component = entity.getInMemory(TestUser);
121
- expect(component).toBeUndefined();
122
- });
123
-
124
- test('returns correct component type', () => {
125
- const entity = new Entity();
126
- entity.add(TestUser, { name: 'Test', email: 'test@test.com', age: 25 });
127
- entity.add(TestProduct, { sku: 'SKU123', name: 'Product', price: 50, inStock: true });
128
-
129
- const user = entity.getInMemory(TestUser);
130
- const product = entity.getInMemory(TestProduct);
131
-
132
- expect(user).toBeInstanceOf(TestUser);
133
- expect(product).toBeInstanceOf(TestProduct);
134
- });
135
- });
136
-
137
- describe('hasInMemory()', () => {
138
- test('returns true if component is loaded', () => {
139
- const entity = new Entity();
140
- entity.add(TestUser, { name: 'Test', email: 'test@test.com', age: 25 });
141
- expect(entity.hasInMemory(TestUser)).toBe(true);
142
- });
143
-
144
- test('returns false if component is not loaded', () => {
145
- const entity = new Entity();
146
- expect(entity.hasInMemory(TestUser)).toBe(false);
147
- });
148
- });
149
-
150
- describe('remove()', () => {
151
- test('removes a component from the entity', () => {
152
- const entity = new Entity();
153
- entity.add(TestUser, { name: 'Test', email: 'test@test.com', age: 25 });
154
-
155
- expect(entity.hasInMemory(TestUser)).toBe(true);
156
- const removed = entity.remove(TestUser);
157
- expect(removed).toBe(true);
158
- expect(entity.hasInMemory(TestUser)).toBe(false);
159
- });
160
-
161
- test('returns false if component was not present', () => {
162
- const entity = new Entity();
163
- const removed = entity.remove(TestUser);
164
- expect(removed).toBe(false);
165
- });
166
-
167
- test('marks entity as dirty after removing component', () => {
168
- const entity = new Entity();
169
- entity.add(TestUser, { name: 'Test', email: 'test@test.com', age: 25 });
170
- entity.setDirty(false);
171
-
172
- entity.remove(TestUser);
173
- expect((entity as any)._dirty).toBe(true);
174
- });
175
-
176
- test('tracks removed component for wasRemoved check', () => {
177
- const entity = new Entity();
178
- entity.add(TestUser, { name: 'Test', email: 'test@test.com', age: 25 });
179
- entity.remove(TestUser);
180
-
181
- expect(entity.wasRemoved(TestUser)).toBe(true);
182
- });
183
- });
184
-
185
- describe('wasRemoved()', () => {
186
- test('returns false for component that was never added', () => {
187
- const entity = new Entity();
188
- expect(entity.wasRemoved(TestUser)).toBe(false);
189
- });
190
-
191
- test('returns false for component that is still present', () => {
192
- const entity = new Entity();
193
- entity.add(TestUser, { name: 'Test', email: 'test@test.com', age: 25 });
194
- expect(entity.wasRemoved(TestUser)).toBe(false);
195
- });
196
-
197
- test('returns true for removed component', () => {
198
- const entity = new Entity();
199
- entity.add(TestUser, { name: 'Test', email: 'test@test.com', age: 25 });
200
- entity.remove(TestUser);
201
- expect(entity.wasRemoved(TestUser)).toBe(true);
202
- });
203
- });
204
-
205
- describe('componentList()', () => {
206
- test('returns empty array for entity without components', () => {
207
- const entity = new Entity();
208
- expect(entity.componentList()).toEqual([]);
209
- });
210
-
211
- test('returns all added components', () => {
212
- const entity = new Entity();
213
- entity.add(TestUser, { name: 'User', email: 'user@test.com', age: 30 });
214
- entity.add(TestProduct, { sku: 'SKU', name: 'Product', price: 10, inStock: true });
215
-
216
- const components = entity.componentList();
217
- expect(components.length).toBe(2);
218
- });
219
- });
220
-
221
- describe('setPersisted() / setDirty()', () => {
222
- test('setPersisted updates _persisted flag', () => {
223
- const entity = new Entity();
224
- expect(entity._persisted).toBe(false);
225
- entity.setPersisted(true);
226
- expect(entity._persisted).toBe(true);
227
- });
228
-
229
- test('setDirty updates _dirty flag', () => {
230
- const entity = new Entity();
231
- expect((entity as any)._dirty).toBe(true);
232
- entity.setDirty(false);
233
- expect((entity as any)._dirty).toBe(false);
234
- });
235
- });
236
-
237
- describe('serialize()', () => {
238
- test('serializes entity with id and components', () => {
239
- const entity = new Entity('test-id-123');
240
- entity.add(TestUser, { name: 'John', email: 'john@example.com', age: 30 });
241
-
242
- const serialized = entity.serialize();
243
-
244
- expect(serialized.id).toBe('test-id-123');
245
- expect(serialized.components).toBeDefined();
246
- expect(serialized.components.TestUser).toBeDefined();
247
- expect(serialized.components.TestUser.name).toBe('John');
248
- expect(serialized.components.TestUser.email).toBe('john@example.com');
249
- });
250
-
251
- test('serializes multiple components', () => {
252
- const entity = new Entity();
253
- entity.add(TestUser, { name: 'User', email: 'user@test.com', age: 25 });
254
- entity.add(TestProduct, { sku: 'SKU123', name: 'Product', price: 99.99, inStock: true });
255
-
256
- const serialized = entity.serialize();
257
-
258
- expect(Object.keys(serialized.components).length).toBe(2);
259
- expect(serialized.components.TestUser).toBeDefined();
260
- expect(serialized.components.TestProduct).toBeDefined();
261
- });
262
-
263
- test('serializes empty entity', () => {
264
- const entity = new Entity('empty-entity');
265
- const serialized = entity.serialize();
266
-
267
- expect(serialized.id).toBe('empty-entity');
268
- expect(serialized.components).toEqual({});
269
- });
270
- });
271
-
272
- describe('deserialize()', () => {
273
- test('deserializes entity from serialized data', () => {
274
- const entity = new Entity();
275
- entity.add(TestUser, { name: 'John', email: 'john@example.com', age: 30 });
276
- const serialized = entity.serialize();
277
-
278
- const deserialized = Entity.deserialize(serialized);
279
-
280
- expect(deserialized.id).toBe(entity.id);
281
- expect(deserialized._persisted).toBe(true);
282
- expect((deserialized as any)._dirty).toBe(false);
283
- });
284
-
285
- test('returns same entity if already an Entity instance', () => {
286
- const entity = new Entity();
287
- const result = Entity.deserialize(entity);
288
- expect(result).toBe(entity);
289
- });
290
-
291
- test('deserializes with multiple components', () => {
292
- const entity = new Entity();
293
- entity.add(TestUser, { name: 'User', email: 'user@test.com', age: 25 });
294
- entity.add(TestProduct, { sku: 'SKU123', name: 'Product', price: 50, inStock: true });
295
- const serialized = entity.serialize();
296
-
297
- const deserialized = Entity.deserialize(serialized);
298
-
299
- expect(deserialized.componentList().length).toBe(2);
300
- });
301
- });
302
-
303
- describe('Clone()', () => {
304
- test('creates a new entity with new id', () => {
305
- const entity = new Entity('original-id');
306
- entity.add(TestUser, { name: 'Original', email: 'original@test.com', age: 30 });
307
-
308
- const clone = Entity.Clone(entity);
309
-
310
- expect(clone.id).not.toBe(entity.id);
311
- expect(clone._persisted).toBe(false);
312
- expect((clone as any)._dirty).toBe(true);
313
- });
314
-
315
- test('clones component data', () => {
316
- const entity = new Entity();
317
- entity.add(TestUser, { name: 'Original', email: 'original@test.com', age: 30 });
318
-
319
- const clone = Entity.Clone(entity);
320
- const clonedUser = clone.getInMemory(TestUser);
321
-
322
- expect(clonedUser?.name).toBe('Original');
323
- expect(clonedUser?.email).toBe('original@test.com');
324
- });
325
-
326
- test('cloned components have new ids', () => {
327
- const entity = new Entity();
328
- entity.add(TestUser, { name: 'Original', email: 'original@test.com', age: 30 });
329
- const originalUser = entity.getInMemory(TestUser);
330
-
331
- const clone = Entity.Clone(entity);
332
- const clonedUser = clone.getInMemory(TestUser);
333
-
334
- expect(clonedUser?.id).not.toBe(originalUser?.id);
335
- });
336
- });
337
-
338
- describe('Create()', () => {
339
- test('creates a new entity instance', () => {
340
- const entity = Entity.Create();
341
- expect(entity).toBeInstanceOf(Entity);
342
- expect(entity.id).toBeDefined();
343
- });
344
- });
345
- });
@@ -1,203 +0,0 @@
1
- import { describe, test, expect } from "bun:test";
2
- import {
3
- GraphQLSchema,
4
- GraphQLObjectType,
5
- GraphQLString,
6
- GraphQLList,
7
- validate,
8
- parse,
9
- } from "graphql";
10
- import { depthLimitRule } from "../../../gql/depthLimit";
11
-
12
- // Build a test schema with nested types: Query -> user -> friends -> friends -> ...
13
- const UserType: GraphQLObjectType = new GraphQLObjectType({
14
- name: "User",
15
- fields: () => ({
16
- name: { type: GraphQLString },
17
- email: { type: GraphQLString },
18
- friends: { type: new GraphQLList(UserType) },
19
- }),
20
- });
21
-
22
- const schema = new GraphQLSchema({
23
- query: new GraphQLObjectType({
24
- name: "Query",
25
- fields: {
26
- user: { type: UserType },
27
- },
28
- }),
29
- });
30
-
31
- function validateQuery(query: string, maxDepth: number) {
32
- const doc = parse(query);
33
- const rule = depthLimitRule(maxDepth);
34
- return validate(schema, doc, [rule]);
35
- }
36
-
37
- describe("depthLimitRule", () => {
38
- test("allows queries within depth limit", () => {
39
- const query = `{ user { name } }`;
40
- const errors = validateQuery(query, 3);
41
- expect(errors).toHaveLength(0);
42
- });
43
-
44
- test("allows queries at exact depth boundary", () => {
45
- // depth: user(1) -> name(2) = 2
46
- const query = `{ user { name } }`;
47
- const errors = validateQuery(query, 2);
48
- expect(errors).toHaveLength(0);
49
- });
50
-
51
- test("rejects queries exceeding depth limit", () => {
52
- // depth: user(1) -> friends(2) -> friends(3) -> name(4) = 4
53
- const query = `{ user { friends { friends { name } } } }`;
54
- const errors = validateQuery(query, 3);
55
- expect(errors).toHaveLength(1);
56
- expect(errors[0]!.message).toContain("exceeds maximum allowed depth");
57
- });
58
-
59
- test("handles deeply nested queries", () => {
60
- // depth 5
61
- const query = `{
62
- user {
63
- friends {
64
- friends {
65
- friends {
66
- name
67
- }
68
- }
69
- }
70
- }
71
- }`;
72
- const errors = validateQuery(query, 2);
73
- expect(errors).toHaveLength(1);
74
- expect(errors[0]!.message).toContain("depth 5");
75
- expect(errors[0]!.message).toContain("maximum allowed depth of 2");
76
- });
77
-
78
- test("handles named fragments correctly", () => {
79
- // The fragment expands to depth: friends(2) -> name(3)
80
- // Total: user(1) -> friends(2) -> name(3) = 3
81
- const query = `
82
- fragment FriendFields on User {
83
- name
84
- }
85
- { user { friends { ...FriendFields } } }
86
- `;
87
- const errors = validateQuery(query, 3);
88
- expect(errors).toHaveLength(0);
89
- });
90
-
91
- test("rejects named fragments that cause depth violation", () => {
92
- // fragment expands: friends -> friends -> name (3 levels from fragment root)
93
- // Total: user(1) -> friends(2) -> friends(3) -> name(4) = 4
94
- const query = `
95
- fragment DeepFriends on User {
96
- friends { friends { name } }
97
- }
98
- { user { ...DeepFriends } }
99
- `;
100
- const errors = validateQuery(query, 3);
101
- expect(errors).toHaveLength(1);
102
- });
103
-
104
- test("handles inline fragments correctly", () => {
105
- // Inline fragments don't increment depth
106
- // depth: user(1) -> ... on User -> name(2) = 2
107
- const query = `{
108
- user {
109
- ... on User {
110
- name
111
- }
112
- }
113
- }`;
114
- const errors = validateQuery(query, 2);
115
- expect(errors).toHaveLength(0);
116
- });
117
-
118
- test("handles inline fragments with nested fields", () => {
119
- // user(1) -> ... on User -> friends(2) -> name(3) = 3
120
- const query = `{
121
- user {
122
- ... on User {
123
- friends { name }
124
- }
125
- }
126
- }`;
127
- const errors = validateQuery(query, 3);
128
- expect(errors).toHaveLength(0);
129
-
130
- const errorsStrict = validateQuery(query, 2);
131
- expect(errorsStrict).toHaveLength(1);
132
- });
133
-
134
- test("depth 1 only allows scalar root fields", () => {
135
- // user -> name = depth 2
136
- const query = `{ user { name } }`;
137
- const errors = validateQuery(query, 1);
138
- expect(errors).toHaveLength(1);
139
- });
140
-
141
- test("multiple operations are each checked independently", () => {
142
- const query = `
143
- query Shallow { user { name } }
144
- query Deep { user { friends { friends { friends { name } } } } }
145
- `;
146
- // maxDepth 2 should pass Shallow (depth=2) but fail Deep (depth=5)
147
- const errors = validateQuery(query, 2);
148
- expect(errors).toHaveLength(1);
149
- });
150
-
151
- test("allows introspection queries regardless of depth", () => {
152
- // Real introspection queries go 13+ levels deep
153
- const query = `{
154
- __schema {
155
- types {
156
- name
157
- fields {
158
- name
159
- type {
160
- name
161
- ofType {
162
- name
163
- ofType {
164
- name
165
- ofType {
166
- name
167
- }
168
- }
169
- }
170
- }
171
- }
172
- }
173
- }
174
- }`;
175
- // depth=8, limit=3 — should still pass because it's introspection
176
- const errors = validateQuery(query, 3);
177
- expect(errors).toHaveLength(0);
178
- });
179
-
180
- test("allows __type introspection queries", () => {
181
- const query = `{
182
- __type(name: "User") {
183
- name
184
- fields {
185
- name
186
- type { name ofType { name ofType { name } } }
187
- }
188
- }
189
- }`;
190
- const errors = validateQuery(query, 2);
191
- expect(errors).toHaveLength(0);
192
- });
193
-
194
- test("still limits mixed queries with introspection and user fields", () => {
195
- // If a query mixes __schema with user fields, it's NOT pure introspection
196
- const query = `{
197
- __schema { types { name } }
198
- user { friends { friends { friends { name } } } }
199
- }`;
200
- const errors = validateQuery(query, 3);
201
- expect(errors).toHaveLength(1);
202
- });
203
- });