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