bunsane 0.3.2 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (220) hide show
  1. package/CHANGELOG.md +471 -370
  2. package/core/BatchLoader.ts +56 -32
  3. package/core/Entity.ts +93 -1020
  4. package/core/EntityHookManager.ts +52 -754
  5. package/core/Logger.ts +10 -0
  6. package/core/RequestContext.ts +94 -85
  7. package/core/RequestLoaders.ts +98 -5
  8. package/core/SchedulerManager.ts +28 -600
  9. package/core/app/cors.ts +2 -11
  10. package/core/app/preparedStatementWarmup.ts +9 -49
  11. package/core/app/requestRouter.ts +9 -8
  12. package/core/app/restRegistry.ts +8 -0
  13. package/core/archetype/fieldResolvers.ts +85 -40
  14. package/core/archetype/relationLoader.ts +135 -92
  15. package/core/cache/CacheManager.ts +91 -302
  16. package/core/cache/CompressionUtils.ts +34 -3
  17. package/core/cache/MemoryCache.ts +40 -37
  18. package/core/cache/RedisCache.ts +8 -7
  19. package/core/cache/health.ts +30 -0
  20. package/core/cache/invalidation.ts +96 -0
  21. package/core/cache/strategies/writeInvalidate.ts +111 -0
  22. package/core/cache/strategies/writeThrough.ts +233 -0
  23. package/core/components/BaseComponent.ts +25 -10
  24. package/core/components/ComponentRegistry.ts +28 -0
  25. package/core/decorators/IndexedField.ts +1 -1
  26. package/core/entity/cacheStrategies.ts +97 -0
  27. package/core/entity/componentAccess.ts +383 -0
  28. package/core/entity/finders.ts +202 -0
  29. package/core/entity/getCacheManager.ts +10 -0
  30. package/core/entity/pendingOps.ts +72 -0
  31. package/core/entity/saveEntity.ts +375 -0
  32. package/core/health.ts +93 -4
  33. package/core/hooks/dispatcher.ts +439 -0
  34. package/core/hooks/guards.ts +155 -0
  35. package/core/hooks/registry.ts +247 -0
  36. package/core/metadata/definitions/Component.ts +1 -1
  37. package/core/metadata/index.ts +15 -4
  38. package/core/middleware/RateLimit.ts +102 -105
  39. package/core/middleware/RequestId.ts +2 -9
  40. package/core/middleware/SecurityHeaders.ts +2 -11
  41. package/core/middleware/headers.ts +28 -0
  42. package/core/remote/OutboxWorker.ts +213 -183
  43. package/core/remote/RemoteManager.ts +401 -400
  44. package/core/remote/StreamConsumer.ts +535 -535
  45. package/core/remote/types.ts +153 -151
  46. package/core/requestScope.ts +34 -0
  47. package/core/scheduler/cronEvaluator.ts +174 -0
  48. package/core/scheduler/lifecycleHooks.ts +21 -0
  49. package/core/scheduler/lockCoordinator.ts +27 -0
  50. package/core/scheduler/metrics.ts +14 -0
  51. package/core/scheduler/taskRunner.ts +420 -0
  52. package/core/validateEnv.ts +10 -0
  53. package/database/DatabaseHelper.ts +128 -101
  54. package/database/IndexingStrategy.ts +72 -2
  55. package/database/PreparedStatementCache.ts +8 -2
  56. package/database/cancellable.ts +35 -22
  57. package/database/index.ts +29 -3
  58. package/database/instrumentedDb.ts +141 -141
  59. package/database/sqlHelpers.ts +3 -1
  60. package/endpoints/archetypes.ts +2 -8
  61. package/endpoints/tables.ts +6 -1
  62. package/gql/index.ts +1 -1
  63. package/gql/schema/index.ts +15 -4
  64. package/gql/visitors/ResolverGeneratorVisitor.ts +25 -4
  65. package/package.json +22 -1
  66. package/query/CTENode.ts +5 -3
  67. package/query/ComponentInclusionNode.ts +245 -14
  68. package/query/OrNode.ts +8 -19
  69. package/query/Query.ts +208 -79
  70. package/query/QueryContext.ts +6 -0
  71. package/query/QueryDAG.ts +7 -2
  72. package/query/membershipSource.ts +66 -0
  73. package/storage/LocalStorageProvider.ts +8 -3
  74. package/studio/dist/assets/index-BMZ67Npg.js +254 -0
  75. package/studio/dist/assets/index-BpbuYz9g.css +1 -0
  76. package/studio/{index.html → dist/index.html} +3 -2
  77. package/swagger/generator.ts +11 -1
  78. package/upload/UploadManager.ts +8 -6
  79. package/utils/uuid.ts +40 -10
  80. package/.claude/scheduled_tasks.lock +0 -1
  81. package/.claude/settings.local.json +0 -47
  82. package/.prettierrc +0 -4
  83. package/.serena/memories/architectural-decision-no-dependency-injection.md +0 -76
  84. package/.serena/memories/architecture.md +0 -154
  85. package/.serena/memories/cache-interface-refactoring-2026-01-24.md +0 -165
  86. package/.serena/memories/code_style_and_conventions.md +0 -76
  87. package/.serena/memories/project_overview.md +0 -43
  88. package/.serena/memories/schema-dsl-plan.md +0 -107
  89. package/.serena/memories/suggested_commands.md +0 -80
  90. package/.serena/memories/typescript-compilation-status.md +0 -54
  91. package/.serena/project.yml +0 -114
  92. package/BunSane.jpg +0 -0
  93. package/CLAUDE.md +0 -198
  94. package/TODO.md +0 -2
  95. package/bun.lock +0 -302
  96. package/bunfig.toml +0 -10
  97. package/docs/RFC_APP_REFACTOR.md +0 -248
  98. package/docs/RFC_REFACTOR_TARGETS.md +0 -251
  99. package/docs/SCALABILITY_PLAN.md +0 -175
  100. package/studio/bun.lock +0 -482
  101. package/studio/package.json +0 -39
  102. package/studio/postcss.config.js +0 -6
  103. package/studio/src/components/DataTable.tsx +0 -211
  104. package/studio/src/components/Layout.tsx +0 -13
  105. package/studio/src/components/PageContainer.tsx +0 -9
  106. package/studio/src/components/PageHeader.tsx +0 -13
  107. package/studio/src/components/SearchBar.tsx +0 -57
  108. package/studio/src/components/Sidebar.tsx +0 -294
  109. package/studio/src/components/ui/button.tsx +0 -56
  110. package/studio/src/components/ui/checkbox.tsx +0 -26
  111. package/studio/src/components/ui/input.tsx +0 -25
  112. package/studio/src/hooks/useDataTable.ts +0 -131
  113. package/studio/src/index.css +0 -36
  114. package/studio/src/lib/api.ts +0 -186
  115. package/studio/src/lib/utils.ts +0 -13
  116. package/studio/src/main.tsx +0 -17
  117. package/studio/src/pages/ArcheType.tsx +0 -239
  118. package/studio/src/pages/Components.tsx +0 -124
  119. package/studio/src/pages/EntityInspector.tsx +0 -302
  120. package/studio/src/pages/QueryRunner.tsx +0 -246
  121. package/studio/src/pages/Table.tsx +0 -94
  122. package/studio/src/pages/Welcome.tsx +0 -241
  123. package/studio/src/routes.tsx +0 -45
  124. package/studio/src/store/archeTypeSettings.ts +0 -30
  125. package/studio/src/store/studio.ts +0 -65
  126. package/studio/src/utils/columnHelpers.tsx +0 -114
  127. package/studio/studio-instructions.md +0 -81
  128. package/studio/tailwind.config.js +0 -77
  129. package/studio/utils.ts +0 -54
  130. package/studio/vite.config.js +0 -19
  131. package/tests/benchmark/BENCHMARK_DATABASES_PLAN.md +0 -338
  132. package/tests/benchmark/bunfig.toml +0 -9
  133. package/tests/benchmark/fixtures/EcommerceComponents.ts +0 -283
  134. package/tests/benchmark/fixtures/EcommerceDataGenerators.ts +0 -301
  135. package/tests/benchmark/fixtures/RelationTracker.ts +0 -159
  136. package/tests/benchmark/fixtures/index.ts +0 -6
  137. package/tests/benchmark/index.ts +0 -22
  138. package/tests/benchmark/noop-preload.ts +0 -3
  139. package/tests/benchmark/query-lateral-benchmark.test.ts +0 -372
  140. package/tests/benchmark/runners/BenchmarkLoader.ts +0 -132
  141. package/tests/benchmark/runners/index.ts +0 -4
  142. package/tests/benchmark/scenarios/query-benchmarks.test.ts +0 -465
  143. package/tests/benchmark/scripts/generate-db.ts +0 -344
  144. package/tests/benchmark/scripts/run-benchmarks.ts +0 -97
  145. package/tests/e2e/http.test.ts +0 -130
  146. package/tests/fixtures/archetypes/TestUserArchetype.ts +0 -21
  147. package/tests/fixtures/components/TestOrder.ts +0 -23
  148. package/tests/fixtures/components/TestProduct.ts +0 -23
  149. package/tests/fixtures/components/TestUser.ts +0 -20
  150. package/tests/fixtures/components/index.ts +0 -6
  151. package/tests/graphql/SchemaGeneration.test.ts +0 -90
  152. package/tests/graphql/builders/ResolverBuilder.test.ts +0 -223
  153. package/tests/graphql/builders/TypeDefBuilder.test.ts +0 -153
  154. package/tests/helpers/MockRedisClient.ts +0 -113
  155. package/tests/helpers/MockRedisStreamServer.ts +0 -448
  156. package/tests/integration/archetype/ArcheType.persistence.test.ts +0 -241
  157. package/tests/integration/cache/CacheInvalidation.test.ts +0 -259
  158. package/tests/integration/entity/Entity.persistence.test.ts +0 -333
  159. package/tests/integration/entity/Entity.saveTimeout.test.ts +0 -110
  160. package/tests/integration/loaders/RequestLoaders.abort.test.ts +0 -82
  161. package/tests/integration/query/Query.abort.test.ts +0 -66
  162. package/tests/integration/query/Query.complexAnalysis.test.ts +0 -557
  163. package/tests/integration/query/Query.edgeCases.test.ts +0 -595
  164. package/tests/integration/query/Query.exec.test.ts +0 -576
  165. package/tests/integration/query/Query.explainAnalyze.test.ts +0 -233
  166. package/tests/integration/query/Query.jsonbArray.test.ts +0 -214
  167. package/tests/integration/remote/dlq.test.ts +0 -175
  168. package/tests/integration/remote/event-dispatch.test.ts +0 -114
  169. package/tests/integration/remote/outbox.test.ts +0 -130
  170. package/tests/integration/remote/rpc.test.ts +0 -177
  171. package/tests/pglite-setup.ts +0 -62
  172. package/tests/setup.ts +0 -164
  173. package/tests/stress/BenchmarkRunner.ts +0 -203
  174. package/tests/stress/DataSeeder.ts +0 -190
  175. package/tests/stress/StressTestReporter.ts +0 -229
  176. package/tests/stress/cursor-perf-test.ts +0 -171
  177. package/tests/stress/fixtures/RealisticComponents.ts +0 -235
  178. package/tests/stress/fixtures/StressTestComponents.ts +0 -58
  179. package/tests/stress/index.ts +0 -7
  180. package/tests/stress/scenarios/query-benchmarks.test.ts +0 -285
  181. package/tests/stress/scenarios/realistic-scenarios.test.ts +0 -1081
  182. package/tests/stress/scenarios/timeout-investigation.test.ts +0 -522
  183. package/tests/unit/BatchLoader.test.ts +0 -196
  184. package/tests/unit/archetype/ArcheType.test.ts +0 -107
  185. package/tests/unit/cache/CacheManager.test.ts +0 -498
  186. package/tests/unit/cache/MemoryCache.test.ts +0 -260
  187. package/tests/unit/cache/RedisCache.test.ts +0 -411
  188. package/tests/unit/database/cancellable.test.ts +0 -81
  189. package/tests/unit/database/instrumentedDb.test.ts +0 -160
  190. package/tests/unit/entity/Entity.components.test.ts +0 -317
  191. package/tests/unit/entity/Entity.drainSideEffects.test.ts +0 -51
  192. package/tests/unit/entity/Entity.reload.test.ts +0 -63
  193. package/tests/unit/entity/Entity.requireComponents.test.ts +0 -72
  194. package/tests/unit/entity/Entity.test.ts +0 -345
  195. package/tests/unit/gql/depthLimit.test.ts +0 -203
  196. package/tests/unit/gql/operationMiddleware.test.ts +0 -293
  197. package/tests/unit/health/Health.test.ts +0 -129
  198. package/tests/unit/middleware/AccessLog.test.ts +0 -37
  199. package/tests/unit/middleware/Middleware.test.ts +0 -98
  200. package/tests/unit/middleware/RequestId.test.ts +0 -54
  201. package/tests/unit/middleware/SecurityHeaders.test.ts +0 -66
  202. package/tests/unit/query/FilterBuilder.test.ts +0 -111
  203. package/tests/unit/query/JsonbArrayBuilder.test.ts +0 -178
  204. package/tests/unit/query/Query.emptyString.test.ts +0 -69
  205. package/tests/unit/query/Query.test.ts +0 -310
  206. package/tests/unit/remote/CircuitBreaker.test.ts +0 -159
  207. package/tests/unit/remote/RemoteError.test.ts +0 -55
  208. package/tests/unit/remote/decorators.test.ts +0 -195
  209. package/tests/unit/remote/metrics.test.ts +0 -115
  210. package/tests/unit/remote/mockRedisStreamServer.test.ts +0 -104
  211. package/tests/unit/scheduler/DistributedLock.test.ts +0 -274
  212. package/tests/unit/scheduler/SchedulerManager.timeBased.test.ts +0 -95
  213. package/tests/unit/schema/schema-integration.test.ts +0 -426
  214. package/tests/unit/schema/schema.test.ts +0 -580
  215. package/tests/unit/storage/S3StorageProvider.test.ts +0 -567
  216. package/tests/unit/upload/RestUpload.test.ts +0 -267
  217. package/tests/unit/validateEnv.test.ts +0 -82
  218. package/tests/utils/entity-tracker.ts +0 -57
  219. package/tests/utils/index.ts +0 -13
  220. package/tests/utils/test-context.ts +0 -149
@@ -1,580 +0,0 @@
1
- import { describe, test, expect } from 'bun:test';
2
- import { z } from 'zod';
3
- import {
4
- t,
5
- SCHEMA_DSL_MARKER,
6
- isSchemaType,
7
- isSchemaInput,
8
- collectNestedTypeDefs,
9
- } from '../../../gql/schema';
10
- import type { SchemaType, InferInput } from '../../../gql/schema';
11
-
12
- // ---------------------------------------------------------------------------
13
- // 1. Scalar Types - toGraphQL()
14
- // ---------------------------------------------------------------------------
15
-
16
- describe('Scalar Types - toGraphQL()', () => {
17
- test('t.string().toGraphQL() returns "String"', () => {
18
- expect(t.string().toGraphQL()).toBe('String');
19
- });
20
-
21
- test('t.string().required().toGraphQL() returns "String!"', () => {
22
- expect(t.string().required().toGraphQL()).toBe('String!');
23
- });
24
-
25
- test('t.int().toGraphQL() returns "Int"', () => {
26
- expect(t.int().toGraphQL()).toBe('Int');
27
- });
28
-
29
- test('t.int().required().toGraphQL() returns "Int!"', () => {
30
- expect(t.int().required().toGraphQL()).toBe('Int!');
31
- });
32
-
33
- test('t.float().toGraphQL() returns "Float"', () => {
34
- expect(t.float().toGraphQL()).toBe('Float');
35
- });
36
-
37
- test('t.float().required().toGraphQL() returns "Float!"', () => {
38
- expect(t.float().required().toGraphQL()).toBe('Float!');
39
- });
40
-
41
- test('t.boolean().toGraphQL() returns "Boolean"', () => {
42
- expect(t.boolean().toGraphQL()).toBe('Boolean');
43
- });
44
-
45
- test('t.boolean().required().toGraphQL() returns "Boolean!"', () => {
46
- expect(t.boolean().required().toGraphQL()).toBe('Boolean!');
47
- });
48
-
49
- test('t.id().toGraphQL() returns "ID"', () => {
50
- expect(t.id().toGraphQL()).toBe('ID');
51
- });
52
-
53
- test('t.id().required().toGraphQL() returns "ID!"', () => {
54
- expect(t.id().required().toGraphQL()).toBe('ID!');
55
- });
56
- });
57
-
58
- // ---------------------------------------------------------------------------
59
- // 2. Scalar Types - toZod()
60
- // ---------------------------------------------------------------------------
61
-
62
- describe('Scalar Types - toZod()', () => {
63
- test('t.string().required().toZod() parses "hello" successfully', () => {
64
- const schema = t.string().required().toZod();
65
- const result = schema.safeParse('hello');
66
- expect(result.success).toBe(true);
67
- });
68
-
69
- test('t.string().toZod() parses undefined successfully (optional)', () => {
70
- const schema = t.string().toZod();
71
- const result = schema.safeParse(undefined);
72
- expect(result.success).toBe(true);
73
- });
74
-
75
- test('t.int().required().toZod() parses 42 successfully', () => {
76
- const schema = t.int().required().toZod();
77
- const result = schema.safeParse(42);
78
- expect(result.success).toBe(true);
79
- });
80
-
81
- test('t.int().required().toZod() rejects 3.14 (not integer)', () => {
82
- const schema = t.int().required().toZod();
83
- const result = schema.safeParse(3.14);
84
- expect(result.success).toBe(false);
85
- });
86
-
87
- test('t.float().required().toZod() parses 3.14 successfully', () => {
88
- const schema = t.float().required().toZod();
89
- const result = schema.safeParse(3.14);
90
- expect(result.success).toBe(true);
91
- });
92
-
93
- test('t.boolean().required().toZod() parses true successfully', () => {
94
- const schema = t.boolean().required().toZod();
95
- const result = schema.safeParse(true);
96
- expect(result.success).toBe(true);
97
- });
98
-
99
- test('t.id().required().toZod() parses "abc-123" successfully', () => {
100
- const schema = t.id().required().toZod();
101
- const result = schema.safeParse('abc-123');
102
- expect(result.success).toBe(true);
103
- });
104
- });
105
-
106
- // ---------------------------------------------------------------------------
107
- // 3. String Constraints
108
- // ---------------------------------------------------------------------------
109
-
110
- describe('String Constraints', () => {
111
- test('minLength(3) rejects "ab" (too short)', () => {
112
- const schema = t.string().minLength(3).required().toZod();
113
- const result = schema.safeParse('ab');
114
- expect(result.success).toBe(false);
115
- });
116
-
117
- test('minLength(3) accepts "abc"', () => {
118
- const schema = t.string().minLength(3).required().toZod();
119
- const result = schema.safeParse('abc');
120
- expect(result.success).toBe(true);
121
- });
122
-
123
- test('maxLength(5) rejects "abcdef"', () => {
124
- const schema = t.string().maxLength(5).required().toZod();
125
- const result = schema.safeParse('abcdef');
126
- expect(result.success).toBe(false);
127
- });
128
-
129
- test('email() accepts "user@example.com"', () => {
130
- const schema = t.string().email().required().toZod();
131
- const result = schema.safeParse('user@example.com');
132
- expect(result.success).toBe(true);
133
- });
134
-
135
- test('email() rejects "not-email"', () => {
136
- const schema = t.string().email().required().toZod();
137
- const result = schema.safeParse('not-email');
138
- expect(result.success).toBe(false);
139
- });
140
-
141
- test('url() accepts "https://example.com"', () => {
142
- const schema = t.string().url().required().toZod();
143
- const result = schema.safeParse('https://example.com');
144
- expect(result.success).toBe(true);
145
- });
146
-
147
- test('uuid() accepts valid UUID', () => {
148
- const schema = t.string().uuid().required().toZod();
149
- const result = schema.safeParse('550e8400-e29b-41d4-a716-446655440000');
150
- expect(result.success).toBe(true);
151
- });
152
-
153
- test('pattern(/^[A-Z]+$/) accepts "ABC"', () => {
154
- const schema = t.string().pattern(/^[A-Z]+$/).required().toZod();
155
- const result = schema.safeParse('ABC');
156
- expect(result.success).toBe(true);
157
- });
158
-
159
- test('pattern(/^[A-Z]+$/) rejects "abc"', () => {
160
- const schema = t.string().pattern(/^[A-Z]+$/).required().toZod();
161
- const result = schema.safeParse('abc');
162
- expect(result.success).toBe(false);
163
- });
164
- });
165
-
166
- // ---------------------------------------------------------------------------
167
- // 4. Number Constraints
168
- // ---------------------------------------------------------------------------
169
-
170
- describe('Number Constraints', () => {
171
- test('t.int().min(1) rejects 0', () => {
172
- const schema = t.int().min(1).required().toZod();
173
- const result = schema.safeParse(0);
174
- expect(result.success).toBe(false);
175
- });
176
-
177
- test('t.int().min(1) accepts 1', () => {
178
- const schema = t.int().min(1).required().toZod();
179
- const result = schema.safeParse(1);
180
- expect(result.success).toBe(true);
181
- });
182
-
183
- test('t.int().max(10) rejects 11', () => {
184
- const schema = t.int().max(10).required().toZod();
185
- const result = schema.safeParse(11);
186
- expect(result.success).toBe(false);
187
- });
188
-
189
- test('t.float().min(0.5).max(9.5) accepts 5.0', () => {
190
- const schema = t.float().min(0.5).max(9.5).required().toZod();
191
- const result = schema.safeParse(5.0);
192
- expect(result.success).toBe(true);
193
- });
194
- });
195
-
196
- // ---------------------------------------------------------------------------
197
- // 5. Nullable modifier
198
- // ---------------------------------------------------------------------------
199
-
200
- describe('Nullable modifier', () => {
201
- test('t.string().nullable().required().toZod() accepts null', () => {
202
- const schema = t.string().nullable().required().toZod();
203
- const result = schema.safeParse(null);
204
- expect(result.success).toBe(true);
205
- });
206
-
207
- test('t.string().required().nullable().toZod() accepts null', () => {
208
- const schema = t.string().required().nullable().toZod();
209
- const result = schema.safeParse(null);
210
- expect(result.success).toBe(true);
211
- });
212
-
213
- test('t.string().required().toZod() rejects null', () => {
214
- const schema = t.string().required().toZod();
215
- const resultNull = schema.safeParse(null);
216
- expect(resultNull.success).toBe(false);
217
- });
218
-
219
- test('t.string().required().toZod() rejects undefined', () => {
220
- const schema = t.string().required().toZod();
221
- const resultUndef = schema.safeParse(undefined);
222
- expect(resultUndef.success).toBe(false);
223
- });
224
- });
225
-
226
- // ---------------------------------------------------------------------------
227
- // 6. ObjectType
228
- // ---------------------------------------------------------------------------
229
-
230
- describe('ObjectType', () => {
231
- const UserInput = t.object({
232
- id: t.id().required(),
233
- name: t.string().required(),
234
- email: t.string().email(),
235
- age: t.int(),
236
- active: t.boolean(),
237
- }, 'UserInput');
238
-
239
- test('toGraphQL() returns the type name', () => {
240
- expect(UserInput.toGraphQL()).toBe('UserInput');
241
- });
242
-
243
- test('required().toGraphQL() returns "TypeName!"', () => {
244
- expect(UserInput.required().toGraphQL()).toBe('UserInput!');
245
- });
246
-
247
- test('toGraphQLTypeDef() generates correct SDL with all field types', () => {
248
- const sdl = UserInput.toGraphQLTypeDef();
249
- expect(sdl).toContain('input UserInput {');
250
- expect(sdl).toContain('id: ID!');
251
- expect(sdl).toContain('name: String!');
252
- expect(sdl).toContain('email: String');
253
- expect(sdl).toContain('age: Int');
254
- expect(sdl).toContain('active: Boolean');
255
- expect(sdl).toContain('}');
256
- });
257
-
258
- test('toZod() validates correct shape', () => {
259
- const schema = UserInput.required().toZod();
260
- const result = schema.safeParse({
261
- id: '123',
262
- name: 'Alice',
263
- email: 'alice@example.com',
264
- age: 30,
265
- active: true,
266
- });
267
- expect(result.success).toBe(true);
268
- });
269
-
270
- test('toZod() rejects missing required fields', () => {
271
- const schema = UserInput.required().toZod();
272
- const result = schema.safeParse({
273
- email: 'alice@example.com',
274
- });
275
- expect(result.success).toBe(false);
276
- });
277
-
278
- test('nested objects generate correct SDL', () => {
279
- const AddressInput = t.object({
280
- street: t.string().required(),
281
- city: t.string().required(),
282
- }, 'AddressInput');
283
-
284
- const PersonInput = t.object({
285
- name: t.string().required(),
286
- address: AddressInput.required(),
287
- }, 'PersonInput');
288
-
289
- const sdl = PersonInput.toGraphQLTypeDef();
290
- expect(sdl).toContain('input PersonInput {');
291
- expect(sdl).toContain('name: String!');
292
- expect(sdl).toContain('address: AddressInput!');
293
- });
294
- });
295
-
296
- // ---------------------------------------------------------------------------
297
- // 7. ListType
298
- // ---------------------------------------------------------------------------
299
-
300
- describe('ListType', () => {
301
- test('t.list(t.string()).toGraphQL() returns "[String]"', () => {
302
- expect(t.list(t.string()).toGraphQL()).toBe('[String]');
303
- });
304
-
305
- test('t.list(t.string().required()).toGraphQL() returns "[String!]"', () => {
306
- expect(t.list(t.string().required()).toGraphQL()).toBe('[String!]');
307
- });
308
-
309
- test('t.list(t.string()).required().toGraphQL() returns "[String]!"', () => {
310
- expect(t.list(t.string()).required().toGraphQL()).toBe('[String]!');
311
- });
312
-
313
- test('t.list(t.string().required()).required().toGraphQL() returns "[String!]!"', () => {
314
- expect(t.list(t.string().required()).required().toGraphQL()).toBe('[String!]!');
315
- });
316
-
317
- test('toZod() validates arrays of strings', () => {
318
- const schema = t.list(t.string().required()).required().toZod();
319
- const result = schema.safeParse(['a', 'b', 'c']);
320
- expect(result.success).toBe(true);
321
- });
322
-
323
- test('toZod() rejects non-array', () => {
324
- const schema = t.list(t.string().required()).required().toZod();
325
- const result = schema.safeParse('not-an-array');
326
- expect(result.success).toBe(false);
327
- });
328
-
329
- test('minItems constraint works', () => {
330
- const schema = t.list(t.string().required()).minItems(2).required().toZod();
331
- const tooFew = schema.safeParse(['one']);
332
- expect(tooFew.success).toBe(false);
333
-
334
- const enough = schema.safeParse(['one', 'two']);
335
- expect(enough.success).toBe(true);
336
- });
337
-
338
- test('maxItems constraint works', () => {
339
- const schema = t.list(t.string().required()).maxItems(2).required().toZod();
340
- const tooMany = schema.safeParse(['a', 'b', 'c']);
341
- expect(tooMany.success).toBe(false);
342
-
343
- const withinLimit = schema.safeParse(['a', 'b']);
344
- expect(withinLimit.success).toBe(true);
345
- });
346
- });
347
-
348
- // ---------------------------------------------------------------------------
349
- // 8. EnumType
350
- // ---------------------------------------------------------------------------
351
-
352
- describe('EnumType', () => {
353
- const StatusEnum = t.enum(['ACTIVE', 'INACTIVE', 'PENDING'] as const, 'Status');
354
-
355
- test('toGraphQL() returns the enum name', () => {
356
- expect(StatusEnum.toGraphQL()).toBe('Status');
357
- });
358
-
359
- test('required().toGraphQL() returns "EnumName!"', () => {
360
- expect(StatusEnum.required().toGraphQL()).toBe('Status!');
361
- });
362
-
363
- test('toGraphQLTypeDef() generates correct enum SDL', () => {
364
- const sdl = StatusEnum.toGraphQLTypeDef();
365
- expect(sdl).toContain('enum Status {');
366
- expect(sdl).toContain('ACTIVE');
367
- expect(sdl).toContain('INACTIVE');
368
- expect(sdl).toContain('PENDING');
369
- expect(sdl).toContain('}');
370
- });
371
-
372
- test('toZod() accepts valid values', () => {
373
- const schema = StatusEnum.required().toZod();
374
- expect(schema.safeParse('ACTIVE').success).toBe(true);
375
- expect(schema.safeParse('INACTIVE').success).toBe(true);
376
- expect(schema.safeParse('PENDING').success).toBe(true);
377
- });
378
-
379
- test('toZod() rejects invalid values', () => {
380
- const schema = StatusEnum.required().toZod();
381
- expect(schema.safeParse('UNKNOWN').success).toBe(false);
382
- expect(schema.safeParse(123).success).toBe(false);
383
- expect(schema.safeParse('').success).toBe(false);
384
- });
385
- });
386
-
387
- // ---------------------------------------------------------------------------
388
- // 9. RefType
389
- // ---------------------------------------------------------------------------
390
-
391
- describe('RefType', () => {
392
- test('t.ref("DateTime").toGraphQL() returns "DateTime"', () => {
393
- expect(t.ref('DateTime').toGraphQL()).toBe('DateTime');
394
- });
395
-
396
- test('t.ref("DateTime").required().toGraphQL() returns "DateTime!"', () => {
397
- expect(t.ref('DateTime').required().toGraphQL()).toBe('DateTime!');
398
- });
399
-
400
- test('t.ref with custom zod schema validates correctly', () => {
401
- const dateRef = t.ref('DateTime', z.string().datetime());
402
- const schema = dateRef.required().toZod();
403
- expect(schema.safeParse('2026-02-06T12:00:00Z').success).toBe(true);
404
- expect(schema.safeParse('not-a-date').success).toBe(false);
405
- });
406
- });
407
-
408
- // ---------------------------------------------------------------------------
409
- // 10. collectNestedTypeDefs
410
- // ---------------------------------------------------------------------------
411
-
412
- describe('collectNestedTypeDefs', () => {
413
- test('collects ObjectType typedef', () => {
414
- const Item = t.object({ name: t.string().required() }, 'Item');
415
- const defs = collectNestedTypeDefs({ item: Item });
416
- expect(defs.size).toBe(1);
417
- expect(defs.get('Item')).toContain('input Item {');
418
- expect(defs.get('Item')).toContain('name: String!');
419
- });
420
-
421
- test('collects EnumType typedef', () => {
422
- const Color = t.enum(['RED', 'GREEN', 'BLUE'] as const, 'Color');
423
- const defs = collectNestedTypeDefs({ color: Color });
424
- expect(defs.size).toBe(1);
425
- expect(defs.get('Color')).toContain('enum Color {');
426
- });
427
-
428
- test('collects nested ObjectType typedefs (depth-first)', () => {
429
- const Inner = t.object({ value: t.int().required() }, 'Inner');
430
- const Outer = t.object({
431
- inner: Inner.required(),
432
- label: t.string().required(),
433
- }, 'Outer');
434
- const defs = collectNestedTypeDefs({ root: Outer });
435
- expect(defs.size).toBe(2);
436
- // Depth-first: Inner appears before Outer in iteration order
437
- const keys = Array.from(defs.keys());
438
- expect(keys[0]).toBe('Inner');
439
- expect(keys[1]).toBe('Outer');
440
- });
441
-
442
- test('collects from ListType elements', () => {
443
- const Tag = t.object({ name: t.string().required() }, 'Tag');
444
- const defs = collectNestedTypeDefs({ tags: t.list(Tag) });
445
- expect(defs.size).toBe(1);
446
- expect(defs.get('Tag')).toContain('input Tag {');
447
- });
448
-
449
- test('deduplicates by type name', () => {
450
- const Shared = t.object({ id: t.id().required() }, 'Shared');
451
- const defs = collectNestedTypeDefs({
452
- first: Shared,
453
- second: Shared,
454
- inList: t.list(Shared),
455
- });
456
- expect(defs.size).toBe(1);
457
- expect(defs.get('Shared')).toContain('input Shared {');
458
- });
459
-
460
- test('scalar types produce no typedefs', () => {
461
- const defs = collectNestedTypeDefs({
462
- name: t.string().required(),
463
- age: t.int(),
464
- score: t.float(),
465
- active: t.boolean(),
466
- id: t.id(),
467
- });
468
- expect(defs.size).toBe(0);
469
- });
470
- });
471
-
472
- // ---------------------------------------------------------------------------
473
- // 11. Detection functions
474
- // ---------------------------------------------------------------------------
475
-
476
- describe('Detection functions', () => {
477
- test('isSchemaType returns true for all t.xxx() builders', () => {
478
- expect(isSchemaType(t.string())).toBe(true);
479
- expect(isSchemaType(t.int())).toBe(true);
480
- expect(isSchemaType(t.float())).toBe(true);
481
- expect(isSchemaType(t.boolean())).toBe(true);
482
- expect(isSchemaType(t.id())).toBe(true);
483
- expect(isSchemaType(t.object({ a: t.string() }, 'X'))).toBe(true);
484
- expect(isSchemaType(t.list(t.string()))).toBe(true);
485
- expect(isSchemaType(t.enum(['A'] as const, 'E'))).toBe(true);
486
- expect(isSchemaType(t.ref('Ref'))).toBe(true);
487
- });
488
-
489
- test('isSchemaType returns true for modified builders', () => {
490
- expect(isSchemaType(t.string().required())).toBe(true);
491
- expect(isSchemaType(t.int().nullable())).toBe(true);
492
- expect(isSchemaType(t.list(t.string()).required())).toBe(true);
493
- });
494
-
495
- test('isSchemaType returns false for plain objects', () => {
496
- expect(isSchemaType({ name: 'test' })).toBe(false);
497
- expect(isSchemaType({})).toBe(false);
498
- });
499
-
500
- test('isSchemaType returns false for Zod schemas', () => {
501
- expect(isSchemaType(z.string())).toBe(false);
502
- expect(isSchemaType(z.object({ a: z.string() }))).toBe(false);
503
- });
504
-
505
- test('isSchemaType returns false for primitives and nullish', () => {
506
- expect(isSchemaType(null)).toBe(false);
507
- expect(isSchemaType(undefined)).toBe(false);
508
- expect(isSchemaType(42)).toBe(false);
509
- expect(isSchemaType('hello')).toBe(false);
510
- });
511
-
512
- test('isSchemaInput returns true for Record of SchemaTypes', () => {
513
- expect(
514
- isSchemaInput({
515
- name: t.string().required(),
516
- age: t.int(),
517
- })
518
- ).toBe(true);
519
- });
520
-
521
- test('isSchemaInput returns false for Zod object (has _def)', () => {
522
- const zodObj = z.object({ a: z.string() });
523
- expect(isSchemaInput(zodObj)).toBe(false);
524
- });
525
-
526
- test('isSchemaInput returns false for null/undefined', () => {
527
- expect(isSchemaInput(null)).toBe(false);
528
- expect(isSchemaInput(undefined)).toBe(false);
529
- });
530
-
531
- test('isSchemaInput returns false for Record of non-SchemaType values', () => {
532
- expect(isSchemaInput({ a: 'string', b: 123 })).toBe(false);
533
- expect(isSchemaInput({ a: z.string() })).toBe(false);
534
- });
535
-
536
- test('isSchemaInput returns false for empty object', () => {
537
- expect(isSchemaInput({})).toBe(false);
538
- });
539
-
540
- test('isSchemaInput returns false for arrays', () => {
541
- expect(isSchemaInput([t.string()])).toBe(false);
542
- });
543
- });
544
-
545
- // ---------------------------------------------------------------------------
546
- // 12. SCHEMA_DSL_MARKER
547
- // ---------------------------------------------------------------------------
548
-
549
- describe('SCHEMA_DSL_MARKER', () => {
550
- test('all builder instances have the marker symbol', () => {
551
- const builders = [
552
- t.string(),
553
- t.int(),
554
- t.float(),
555
- t.boolean(),
556
- t.id(),
557
- t.object({ a: t.string() }, 'Test'),
558
- t.list(t.string()),
559
- t.enum(['A'] as const, 'TestEnum'),
560
- t.ref('Ref'),
561
- ];
562
-
563
- for (const builder of builders) {
564
- expect(SCHEMA_DSL_MARKER in builder).toBe(true);
565
- expect((builder as any)[SCHEMA_DSL_MARKER]).toBe(true);
566
- }
567
- });
568
-
569
- test('marker is a Symbol (unforgeable)', () => {
570
- expect(typeof SCHEMA_DSL_MARKER).toBe('symbol');
571
- const fake = Symbol('SCHEMA_DSL');
572
- expect(fake).not.toBe(SCHEMA_DSL_MARKER);
573
- });
574
-
575
- test('required/nullable variants retain the marker', () => {
576
- expect((t.string().required() as any)[SCHEMA_DSL_MARKER]).toBe(true);
577
- expect((t.string().nullable() as any)[SCHEMA_DSL_MARKER]).toBe(true);
578
- expect((t.int().required().nullable() as any)[SCHEMA_DSL_MARKER]).toBe(true);
579
- });
580
- });