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,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
- });