bunsane 0.1.4 → 0.2.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 (257) hide show
  1. package/.claude/settings.local.json +47 -0
  2. package/.claude/skills/update-memory.md +74 -0
  3. package/.prettierrc +4 -0
  4. package/.serena/memories/architectural-decision-no-dependency-injection.md +76 -0
  5. package/.serena/memories/architecture.md +154 -0
  6. package/.serena/memories/cache-interface-refactoring-2026-01-24.md +165 -0
  7. package/.serena/memories/code_style_and_conventions.md +76 -0
  8. package/.serena/memories/project_overview.md +43 -0
  9. package/.serena/memories/schema-dsl-plan.md +107 -0
  10. package/.serena/memories/suggested_commands.md +80 -0
  11. package/.serena/memories/typescript-compilation-status.md +54 -0
  12. package/.serena/project.yml +114 -0
  13. package/TODO.md +1 -7
  14. package/bun.lock +150 -4
  15. package/bunfig.toml +10 -0
  16. package/config/cache.config.ts +77 -0
  17. package/config/upload.config.ts +4 -5
  18. package/core/App.ts +870 -123
  19. package/core/ArcheType.ts +2268 -377
  20. package/core/BatchLoader.ts +181 -71
  21. package/core/Config.ts +153 -0
  22. package/core/Decorators.ts +4 -1
  23. package/core/Entity.ts +621 -92
  24. package/core/EntityHookManager.ts +1 -1
  25. package/core/EntityInterface.ts +3 -1
  26. package/core/EntityManager.ts +1 -13
  27. package/core/ErrorHandler.ts +8 -2
  28. package/core/Logger.ts +9 -0
  29. package/core/Middleware.ts +34 -0
  30. package/core/RequestContext.ts +5 -1
  31. package/core/RequestLoaders.ts +227 -93
  32. package/core/SchedulerManager.ts +193 -52
  33. package/core/cache/CacheAnalytics.ts +399 -0
  34. package/core/cache/CacheFactory.ts +145 -0
  35. package/core/cache/CacheManager.ts +520 -0
  36. package/core/cache/CacheProvider.ts +34 -0
  37. package/core/cache/CacheWarmer.ts +157 -0
  38. package/core/cache/CompressionUtils.ts +110 -0
  39. package/core/cache/MemoryCache.ts +251 -0
  40. package/core/cache/MultiLevelCache.ts +180 -0
  41. package/core/cache/NoOpCache.ts +53 -0
  42. package/core/cache/RedisCache.ts +464 -0
  43. package/core/cache/TTLStrategy.ts +254 -0
  44. package/core/cache/index.ts +6 -0
  45. package/core/components/BaseComponent.ts +120 -0
  46. package/core/{ComponentRegistry.ts → components/ComponentRegistry.ts} +148 -54
  47. package/core/components/Decorators.ts +88 -0
  48. package/core/components/Interfaces.ts +7 -0
  49. package/core/components/index.ts +5 -0
  50. package/core/decorators/EntityHooks.ts +0 -3
  51. package/core/decorators/IndexedField.ts +26 -0
  52. package/core/decorators/ScheduledTask.ts +0 -47
  53. package/core/events/EntityLifecycleEvents.ts +1 -1
  54. package/core/health.ts +112 -0
  55. package/core/metadata/definitions/ArcheType.ts +14 -0
  56. package/core/metadata/definitions/Component.ts +9 -0
  57. package/core/metadata/definitions/gqlObject.ts +1 -1
  58. package/core/metadata/index.ts +42 -1
  59. package/core/metadata/metadata-storage.ts +28 -2
  60. package/core/middleware/AccessLog.ts +59 -0
  61. package/core/middleware/RequestId.ts +38 -0
  62. package/core/middleware/SecurityHeaders.ts +62 -0
  63. package/core/middleware/index.ts +3 -0
  64. package/core/scheduler/DistributedLock.ts +266 -0
  65. package/core/scheduler/index.ts +15 -0
  66. package/core/validateEnv.ts +92 -0
  67. package/database/DatabaseHelper.ts +416 -40
  68. package/database/IndexingStrategy.ts +342 -0
  69. package/database/PreparedStatementCache.ts +226 -0
  70. package/database/index.ts +32 -7
  71. package/database/sqlHelpers.ts +14 -2
  72. package/endpoints/archetypes.ts +362 -0
  73. package/endpoints/components.ts +58 -0
  74. package/endpoints/entity.ts +80 -0
  75. package/endpoints/index.ts +27 -0
  76. package/endpoints/query.ts +93 -0
  77. package/endpoints/stats.ts +76 -0
  78. package/endpoints/tables.ts +212 -0
  79. package/endpoints/types.ts +155 -0
  80. package/gql/ArchetypeOperations.ts +32 -86
  81. package/gql/Generator.ts +27 -315
  82. package/gql/GeneratorV2.ts +37 -0
  83. package/gql/builders/InputTypeBuilder.ts +99 -0
  84. package/gql/builders/ResolverBuilder.ts +234 -0
  85. package/gql/builders/TypeDefBuilder.ts +105 -0
  86. package/gql/builders/index.ts +3 -0
  87. package/gql/decorators/Upload.ts +1 -1
  88. package/gql/depthLimit.ts +85 -0
  89. package/gql/graph/GraphNode.ts +224 -0
  90. package/gql/graph/SchemaGraph.ts +278 -0
  91. package/gql/helpers.ts +8 -2
  92. package/gql/index.ts +56 -4
  93. package/gql/middleware.ts +79 -0
  94. package/gql/orchestration/GraphQLSchemaOrchestrator.ts +241 -0
  95. package/gql/orchestration/index.ts +1 -0
  96. package/gql/scanner/ServiceScanner.ts +347 -0
  97. package/gql/schema/index.ts +458 -0
  98. package/gql/strategies/TypeGenerationStrategy.ts +329 -0
  99. package/gql/types.ts +1 -0
  100. package/gql/utils/TypeSignature.ts +220 -0
  101. package/gql/utils/index.ts +1 -0
  102. package/gql/visitors/ArchetypePreprocessorVisitor.ts +80 -0
  103. package/gql/visitors/DeduplicationVisitor.ts +82 -0
  104. package/gql/visitors/GraphVisitor.ts +78 -0
  105. package/gql/visitors/ResolverGeneratorVisitor.ts +122 -0
  106. package/gql/visitors/SchemaGeneratorVisitor.ts +851 -0
  107. package/gql/visitors/TypeCollectorVisitor.ts +79 -0
  108. package/gql/visitors/VisitorComposer.ts +96 -0
  109. package/gql/visitors/index.ts +7 -0
  110. package/package.json +59 -37
  111. package/plugins/index.ts +2 -2
  112. package/query/CTENode.ts +97 -0
  113. package/query/ComponentInclusionNode.ts +689 -0
  114. package/query/FilterBuilder.ts +127 -0
  115. package/query/FilterBuilderRegistry.ts +202 -0
  116. package/query/OrNode.ts +517 -0
  117. package/query/OrQuery.ts +42 -0
  118. package/query/Query.ts +1022 -0
  119. package/query/QueryContext.ts +170 -0
  120. package/query/QueryDAG.ts +122 -0
  121. package/query/QueryNode.ts +65 -0
  122. package/query/SourceNode.ts +53 -0
  123. package/query/builders/FullTextSearchBuilder.ts +236 -0
  124. package/query/index.ts +21 -0
  125. package/scheduler/index.ts +40 -8
  126. package/service/Service.ts +2 -1
  127. package/service/ServiceRegistry.ts +6 -5
  128. package/{core/storage → storage}/LocalStorageProvider.ts +2 -2
  129. package/storage/S3StorageProvider.ts +316 -0
  130. package/{core/storage → storage}/StorageProvider.ts +7 -3
  131. package/studio/bun.lock +482 -0
  132. package/studio/index.html +13 -0
  133. package/studio/package.json +39 -0
  134. package/studio/postcss.config.js +6 -0
  135. package/studio/src/components/DataTable.tsx +211 -0
  136. package/studio/src/components/Layout.tsx +13 -0
  137. package/studio/src/components/PageContainer.tsx +9 -0
  138. package/studio/src/components/PageHeader.tsx +13 -0
  139. package/studio/src/components/SearchBar.tsx +57 -0
  140. package/studio/src/components/Sidebar.tsx +294 -0
  141. package/studio/src/components/ui/button.tsx +56 -0
  142. package/studio/src/components/ui/checkbox.tsx +26 -0
  143. package/studio/src/components/ui/input.tsx +25 -0
  144. package/studio/src/hooks/useDataTable.ts +131 -0
  145. package/studio/src/index.css +36 -0
  146. package/studio/src/lib/api.ts +186 -0
  147. package/studio/src/lib/utils.ts +13 -0
  148. package/studio/src/main.tsx +17 -0
  149. package/studio/src/pages/ArcheType.tsx +239 -0
  150. package/studio/src/pages/Components.tsx +124 -0
  151. package/studio/src/pages/EntityInspector.tsx +302 -0
  152. package/studio/src/pages/QueryRunner.tsx +246 -0
  153. package/studio/src/pages/Table.tsx +94 -0
  154. package/studio/src/pages/Welcome.tsx +241 -0
  155. package/studio/src/routes.tsx +45 -0
  156. package/studio/src/store/archeTypeSettings.ts +30 -0
  157. package/studio/src/store/studio.ts +65 -0
  158. package/studio/src/utils/columnHelpers.tsx +114 -0
  159. package/studio/studio-instructions.md +81 -0
  160. package/studio/tailwind.config.js +77 -0
  161. package/studio/tsconfig.json +24 -0
  162. package/studio/utils.ts +54 -0
  163. package/studio/vite.config.js +19 -0
  164. package/swagger/generator.ts +1 -1
  165. package/tests/e2e/http.test.ts +126 -0
  166. package/tests/fixtures/archetypes/TestUserArchetype.ts +21 -0
  167. package/tests/fixtures/components/TestOrder.ts +23 -0
  168. package/tests/fixtures/components/TestProduct.ts +23 -0
  169. package/tests/fixtures/components/TestUser.ts +20 -0
  170. package/tests/fixtures/components/index.ts +6 -0
  171. package/tests/graphql/SchemaGeneration.test.ts +90 -0
  172. package/tests/graphql/builders/ResolverBuilder.test.ts +223 -0
  173. package/tests/graphql/builders/TypeDefBuilder.test.ts +153 -0
  174. package/tests/integration/archetype/ArcheType.persistence.test.ts +241 -0
  175. package/tests/integration/cache/CacheInvalidation.test.ts +259 -0
  176. package/tests/integration/entity/Entity.persistence.test.ts +333 -0
  177. package/tests/integration/query/Query.exec.test.ts +523 -0
  178. package/tests/pglite-setup.ts +61 -0
  179. package/tests/setup.ts +164 -0
  180. package/tests/stress/BenchmarkRunner.ts +203 -0
  181. package/tests/stress/DataSeeder.ts +190 -0
  182. package/tests/stress/StressTestReporter.ts +229 -0
  183. package/tests/stress/cursor-perf-test.ts +171 -0
  184. package/tests/stress/fixtures/StressTestComponents.ts +58 -0
  185. package/tests/stress/index.ts +7 -0
  186. package/tests/stress/scenarios/query-benchmarks.test.ts +285 -0
  187. package/tests/unit/BatchLoader.test.ts +82 -0
  188. package/tests/unit/archetype/ArcheType.test.ts +107 -0
  189. package/tests/unit/cache/CacheManager.test.ts +347 -0
  190. package/tests/unit/cache/MemoryCache.test.ts +260 -0
  191. package/tests/unit/cache/RedisCache.test.ts +411 -0
  192. package/tests/unit/entity/Entity.components.test.ts +244 -0
  193. package/tests/unit/entity/Entity.test.ts +345 -0
  194. package/tests/unit/gql/depthLimit.test.ts +203 -0
  195. package/tests/unit/gql/operationMiddleware.test.ts +293 -0
  196. package/tests/unit/health/Health.test.ts +129 -0
  197. package/tests/unit/middleware/AccessLog.test.ts +37 -0
  198. package/tests/unit/middleware/Middleware.test.ts +98 -0
  199. package/tests/unit/middleware/RequestId.test.ts +54 -0
  200. package/tests/unit/middleware/SecurityHeaders.test.ts +66 -0
  201. package/tests/unit/query/FilterBuilder.test.ts +111 -0
  202. package/tests/unit/query/Query.test.ts +308 -0
  203. package/tests/unit/scheduler/DistributedLock.test.ts +274 -0
  204. package/tests/unit/schema/schema-integration.test.ts +426 -0
  205. package/tests/unit/schema/schema.test.ts +580 -0
  206. package/tests/unit/storage/S3StorageProvider.test.ts +571 -0
  207. package/tests/unit/upload/RestUpload.test.ts +267 -0
  208. package/tests/unit/validateEnv.test.ts +82 -0
  209. package/tests/utils/entity-tracker.ts +57 -0
  210. package/tests/utils/index.ts +13 -0
  211. package/tests/utils/test-context.ts +149 -0
  212. package/tsconfig.json +5 -1
  213. package/types/archetype.types.ts +6 -0
  214. package/types/hooks.types.ts +1 -1
  215. package/types/query.types.ts +110 -0
  216. package/types/scheduler.types.ts +68 -7
  217. package/types/upload.types.ts +1 -0
  218. package/{core → upload}/FileValidator.ts +10 -1
  219. package/upload/RestUpload.ts +130 -0
  220. package/{core/components → upload}/UploadComponent.ts +11 -11
  221. package/{core → upload}/UploadManager.ts +3 -3
  222. package/upload/index.ts +23 -7
  223. package/utils/UploadHelper.ts +27 -6
  224. package/utils/cronParser.ts +16 -6
  225. package/.github/workflows/deploy-docs.yml +0 -57
  226. package/core/Components.ts +0 -202
  227. package/core/EntityCache.ts +0 -15
  228. package/core/Query.ts +0 -880
  229. package/docs/README.md +0 -149
  230. package/docs/_coverpage.md +0 -36
  231. package/docs/_sidebar.md +0 -23
  232. package/docs/api/core.md +0 -568
  233. package/docs/api/hooks.md +0 -554
  234. package/docs/api/index.md +0 -222
  235. package/docs/api/query.md +0 -678
  236. package/docs/api/service.md +0 -744
  237. package/docs/core-concepts/archetypes.md +0 -512
  238. package/docs/core-concepts/components.md +0 -498
  239. package/docs/core-concepts/entity.md +0 -314
  240. package/docs/core-concepts/hooks.md +0 -683
  241. package/docs/core-concepts/query.md +0 -588
  242. package/docs/core-concepts/services.md +0 -647
  243. package/docs/examples/code-examples.md +0 -425
  244. package/docs/getting-started.md +0 -337
  245. package/docs/index.html +0 -97
  246. package/tests/bench/insert.bench.ts +0 -60
  247. package/tests/bench/relations.bench.ts +0 -270
  248. package/tests/bench/sorting.bench.ts +0 -416
  249. package/tests/component-hooks-simple.test.ts +0 -117
  250. package/tests/component-hooks.test.ts +0 -1461
  251. package/tests/component.test.ts +0 -339
  252. package/tests/errorHandling.test.ts +0 -155
  253. package/tests/hooks.test.ts +0 -667
  254. package/tests/query-sorting.test.ts +0 -101
  255. package/tests/query.test.ts +0 -81
  256. package/tests/relations.test.ts +0 -170
  257. package/tests/scheduler.test.ts +0 -724
@@ -0,0 +1,580 @@
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
+ });