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,196 +0,0 @@
1
- /**
2
- * Unit tests for BatchLoader TTL behavior and bounded cache
3
- */
4
- import { describe, test, expect, beforeEach } from 'bun:test';
5
- import { BatchLoader } from '../../core/BatchLoader';
6
-
7
- describe('BatchLoader', () => {
8
- beforeEach(() => {
9
- BatchLoader.clearCache();
10
- });
11
-
12
- describe('getCacheStats()', () => {
13
- test('returns zero stats when cache is empty', () => {
14
- const stats = BatchLoader.getCacheStats();
15
- expect(stats.size).toBe(0);
16
- expect(stats.entries).toBe(0);
17
- expect(stats.expired).toBe(0);
18
- });
19
-
20
- test('includes memory estimate', () => {
21
- const stats = BatchLoader.getCacheStats();
22
- expect(stats.memoryEstimate).toBeDefined();
23
- expect(typeof stats.memoryEstimate).toBe('string');
24
- });
25
- });
26
-
27
- describe('clearCache()', () => {
28
- test('clears all cached entries', () => {
29
- // Access internal cache to set up test data
30
- const cache = (BatchLoader as any).cache;
31
- const now = Date.now();
32
-
33
- // Use the cache's set method to add entries
34
- cache.set('type1\x00value', 'parent1', {
35
- ids: ['a', 'b'],
36
- expiresAt: now + 300000,
37
- lastAccessed: now
38
- });
39
-
40
- expect(BatchLoader.getCacheStats().entries).toBe(1);
41
-
42
- BatchLoader.clearCache();
43
- expect(BatchLoader.getCacheStats().entries).toBe(0);
44
- });
45
- });
46
-
47
- describe('TTL expiry', () => {
48
- test('getCacheStats reports expired entries', () => {
49
- const cache = (BatchLoader as any).cache;
50
- const now = Date.now();
51
-
52
- // One fresh entry
53
- cache.set('type1\x00value', 'parent1', {
54
- ids: ['a'],
55
- expiresAt: now + 300000,
56
- lastAccessed: now
57
- });
58
- // One expired entry
59
- cache.set('type1\x00value', 'parent2', {
60
- ids: ['b'],
61
- expiresAt: now - 1000,
62
- lastAccessed: now - 1000
63
- });
64
-
65
- const stats = BatchLoader.getCacheStats();
66
- expect(stats.entries).toBe(2);
67
- expect(stats.expired).toBe(1);
68
- });
69
-
70
- test('expired entries are counted correctly for multiple type keys', () => {
71
- const cache = (BatchLoader as any).cache;
72
- const now = Date.now();
73
-
74
- // Type 1 entries
75
- cache.set('type1\x00field', 'p1', {
76
- ids: ['a'],
77
- expiresAt: now - 5000,
78
- lastAccessed: now - 5000
79
- });
80
- cache.set('type1\x00field', 'p2', {
81
- ids: ['b'],
82
- expiresAt: now + 300000,
83
- lastAccessed: now
84
- });
85
-
86
- // Type 2 entry
87
- cache.set('type2\x00field', 'p3', {
88
- ids: ['c'],
89
- expiresAt: now - 1000,
90
- lastAccessed: now - 1000
91
- });
92
-
93
- const stats = BatchLoader.getCacheStats();
94
- expect(stats.size).toBe(2);
95
- expect(stats.entries).toBe(3);
96
- expect(stats.expired).toBe(2);
97
- });
98
-
99
- test('all entries fresh means zero expired', () => {
100
- const cache = (BatchLoader as any).cache;
101
- const now = Date.now();
102
-
103
- cache.set('type\x00field', 'p1', {
104
- ids: ['a'],
105
- expiresAt: now + 60000,
106
- lastAccessed: now
107
- });
108
- cache.set('type\x00field', 'p2', {
109
- ids: ['b'],
110
- expiresAt: now + 60000,
111
- lastAccessed: now
112
- });
113
- cache.set('type\x00field', 'p3', {
114
- ids: ['c'],
115
- expiresAt: now + 60000,
116
- lastAccessed: now
117
- });
118
-
119
- const stats = BatchLoader.getCacheStats();
120
- expect(stats.entries).toBe(3);
121
- expect(stats.expired).toBe(0);
122
- });
123
- });
124
-
125
- describe('pruneExpiredEntries()', () => {
126
- test('removes expired entries and returns count', () => {
127
- const cache = (BatchLoader as any).cache;
128
- const now = Date.now();
129
-
130
- // Add mix of fresh and expired entries
131
- cache.set('type\x00field', 'p1', {
132
- ids: ['a'],
133
- expiresAt: now - 5000,
134
- lastAccessed: now - 5000
135
- });
136
- cache.set('type\x00field', 'p2', {
137
- ids: ['b'],
138
- expiresAt: now + 300000,
139
- lastAccessed: now
140
- });
141
- cache.set('type\x00field', 'p3', {
142
- ids: ['c'],
143
- expiresAt: now - 1000,
144
- lastAccessed: now - 1000
145
- });
146
-
147
- expect(BatchLoader.getCacheStats().entries).toBe(3);
148
- expect(BatchLoader.getCacheStats().expired).toBe(2);
149
-
150
- const pruned = BatchLoader.pruneExpiredEntries();
151
- expect(pruned).toBe(2);
152
-
153
- const statsAfter = BatchLoader.getCacheStats();
154
- expect(statsAfter.entries).toBe(1);
155
- expect(statsAfter.expired).toBe(0);
156
- });
157
-
158
- test('returns 0 when no expired entries', () => {
159
- const cache = (BatchLoader as any).cache;
160
- const now = Date.now();
161
-
162
- cache.set('type\x00field', 'p1', {
163
- ids: ['a'],
164
- expiresAt: now + 60000,
165
- lastAccessed: now
166
- });
167
-
168
- const pruned = BatchLoader.pruneExpiredEntries();
169
- expect(pruned).toBe(0);
170
- });
171
- });
172
-
173
- describe('bounded cache behavior', () => {
174
- test('memory estimate increases with entries', () => {
175
- const cache = (BatchLoader as any).cache;
176
- const now = Date.now();
177
-
178
- const statsBefore = BatchLoader.getCacheStats();
179
-
180
- // Add several entries
181
- for (let i = 0; i < 100; i++) {
182
- cache.set(`type${i}\x00field`, `parent${i}`, {
183
- ids: [`id${i}`],
184
- expiresAt: now + 60000,
185
- lastAccessed: now
186
- });
187
- }
188
-
189
- const statsAfter = BatchLoader.getCacheStats();
190
- expect(statsAfter.entries).toBe(100);
191
-
192
- // Memory estimate should reflect the entries
193
- expect(statsAfter.memoryEstimate).toBeDefined();
194
- });
195
- });
196
- });
@@ -1,107 +0,0 @@
1
- /**
2
- * Unit tests for ArcheType system
3
- * Tests archetype definition and basic functionality
4
- */
5
- import { describe, test, expect, beforeAll } from 'bun:test';
6
- import { BaseArcheType, ArcheType, ArcheTypeField } from '../../../core/ArcheType';
7
- import { TestUser, TestProduct, TestOrder } from '../../fixtures/components';
8
- import { TestUserArchetype, TestUserWithOrdersArchetype } from '../../fixtures/archetypes/TestUserArchetype';
9
- import { ensureComponentsRegistered } from '../../utils';
10
-
11
- describe('ArcheType', () => {
12
- beforeAll(async () => {
13
- await ensureComponentsRegistered(TestUser, TestProduct, TestOrder);
14
- });
15
-
16
- describe('ArcheType definition', () => {
17
- test('archetype class extends BaseArcheType', () => {
18
- const archetype = new TestUserArchetype();
19
- expect(archetype).toBeInstanceOf(BaseArcheType);
20
- });
21
-
22
- test('archetype has componentMap', () => {
23
- const archetype = new TestUserArchetype();
24
- expect(archetype.componentMap).toBeDefined();
25
- expect(typeof archetype.componentMap).toBe('object');
26
- });
27
-
28
- test('componentMap contains declared fields', () => {
29
- const archetype = new TestUserArchetype();
30
- expect(archetype.componentMap.user).toBeDefined();
31
- });
32
-
33
- test('archetype with multiple components', () => {
34
- const archetype = new TestUserWithOrdersArchetype();
35
- expect(archetype.componentMap.user).toBeDefined();
36
- expect(archetype.componentMap.order).toBeDefined();
37
- });
38
- });
39
-
40
- describe('createEntity()', () => {
41
- test('creates entity with id', () => {
42
- const archetype = new TestUserArchetype();
43
- const entity = archetype.createEntity();
44
-
45
- expect(entity).toBeDefined();
46
- expect(entity.id).toBeDefined();
47
- expect(entity.id.length).toBeGreaterThan(0);
48
- });
49
-
50
- test('entity is dirty after creation', () => {
51
- const archetype = new TestUserArchetype();
52
- const entity = archetype.createEntity();
53
-
54
- expect((entity as any)._dirty).toBe(true);
55
- });
56
-
57
- test('entity is not persisted after creation', () => {
58
- const archetype = new TestUserArchetype();
59
- const entity = archetype.createEntity();
60
-
61
- expect(entity._persisted).toBe(false);
62
- });
63
- });
64
-
65
- describe('getZodObjectSchema()', () => {
66
- test('returns zod schema for archetype', () => {
67
- const archetype = new TestUserArchetype();
68
- const schema = archetype.getZodObjectSchema();
69
-
70
- expect(schema).toBeDefined();
71
- });
72
- });
73
-
74
- describe('getInputSchema()', () => {
75
- test('returns input schema for archetype', () => {
76
- const archetype = new TestUserArchetype();
77
- const schema = archetype.getInputSchema();
78
-
79
- expect(schema).toBeDefined();
80
- });
81
- });
82
-
83
- describe('getComponentsToLoad()', () => {
84
- test('returns non-empty components array', () => {
85
- const archetype = new TestUserArchetype();
86
- const components = (archetype as any).getComponentsToLoad();
87
-
88
- expect(Array.isArray(components)).toBe(true);
89
- expect(components.length).toBeGreaterThan(0);
90
- expect(components).toContain(TestUser);
91
- });
92
- });
93
-
94
- describe('withValidation()', () => {
95
- test('returns a Zod schema with validations applied', () => {
96
- const archetype = new TestUserArchetype();
97
- const schema = archetype.withValidation({
98
- user: { name: 'Valid', email: 'valid@test.com', age: 25 }
99
- });
100
-
101
- expect(schema).toBeDefined();
102
- // Should return a Zod schema with a shape property
103
- expect(schema.shape).toBeDefined();
104
- expect(typeof schema.safeParse).toBe('function');
105
- });
106
- });
107
- });