@beignet/core 0.0.1 → 0.0.2

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 (274) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/README.md +149 -4
  3. package/dist/application/index.d.ts +93 -9
  4. package/dist/application/index.d.ts.map +1 -1
  5. package/dist/application/index.js +11 -11
  6. package/dist/application/index.js.map +1 -1
  7. package/dist/client/client.d.ts +73 -12
  8. package/dist/client/client.d.ts.map +1 -1
  9. package/dist/client/client.js +37 -12
  10. package/dist/client/client.js.map +1 -1
  11. package/dist/client/index.d.ts +12 -0
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/index.js +6 -0
  14. package/dist/client/index.js.map +1 -1
  15. package/dist/client/types.d.ts +69 -8
  16. package/dist/client/types.d.ts.map +1 -1
  17. package/dist/config/index.d.ts +84 -0
  18. package/dist/config/index.d.ts.map +1 -1
  19. package/dist/config/index.js +36 -0
  20. package/dist/config/index.js.map +1 -1
  21. package/dist/contracts/contract-builder.d.ts +49 -22
  22. package/dist/contracts/contract-builder.d.ts.map +1 -1
  23. package/dist/contracts/contract-builder.js +48 -21
  24. package/dist/contracts/contract-builder.js.map +1 -1
  25. package/dist/contracts/contract-group.d.ts +35 -19
  26. package/dist/contracts/contract-group.d.ts.map +1 -1
  27. package/dist/contracts/contract-group.js +35 -19
  28. package/dist/contracts/contract-group.js.map +1 -1
  29. package/dist/contracts/contract-like.d.ts +4 -4
  30. package/dist/contracts/contract-like.d.ts.map +1 -1
  31. package/dist/contracts/contract-like.js +2 -1
  32. package/dist/contracts/contract-like.js.map +1 -1
  33. package/dist/contracts/index.d.ts +28 -0
  34. package/dist/contracts/index.d.ts.map +1 -1
  35. package/dist/contracts/index.js +12 -0
  36. package/dist/contracts/index.js.map +1 -1
  37. package/dist/contracts/openapi-meta.d.ts +8 -8
  38. package/dist/contracts/openapi-meta.d.ts.map +1 -1
  39. package/dist/contracts/path-template.d.ts +27 -0
  40. package/dist/contracts/path-template.d.ts.map +1 -1
  41. package/dist/contracts/path-template.js +6 -0
  42. package/dist/contracts/path-template.js.map +1 -1
  43. package/dist/contracts/types.d.ts +104 -10
  44. package/dist/contracts/types.d.ts.map +1 -1
  45. package/dist/contracts/types.js +15 -0
  46. package/dist/contracts/types.js.map +1 -1
  47. package/dist/contracts/utils.d.ts +6 -0
  48. package/dist/contracts/utils.d.ts.map +1 -1
  49. package/dist/contracts/utils.js +6 -0
  50. package/dist/contracts/utils.js.map +1 -1
  51. package/dist/domain/entity.d.ts +22 -11
  52. package/dist/domain/entity.d.ts.map +1 -1
  53. package/dist/domain/entity.js +5 -1
  54. package/dist/domain/entity.js.map +1 -1
  55. package/dist/domain/events.d.ts +5 -2
  56. package/dist/domain/events.d.ts.map +1 -1
  57. package/dist/domain/events.js +4 -1
  58. package/dist/domain/events.js.map +1 -1
  59. package/dist/domain/value-object.d.ts +19 -9
  60. package/dist/domain/value-object.d.ts.map +1 -1
  61. package/dist/domain/value-object.js +5 -1
  62. package/dist/domain/value-object.js.map +1 -1
  63. package/dist/errors/catalog.d.ts +40 -16
  64. package/dist/errors/catalog.d.ts.map +1 -1
  65. package/dist/errors/catalog.js +18 -7
  66. package/dist/errors/catalog.js.map +1 -1
  67. package/dist/errors/response.d.ts +16 -4
  68. package/dist/errors/response.d.ts.map +1 -1
  69. package/dist/errors/response.js +3 -3
  70. package/dist/errors/response.js.map +1 -1
  71. package/dist/errors/validation.d.ts +10 -1
  72. package/dist/errors/validation.d.ts.map +1 -1
  73. package/dist/errors/validation.js +3 -0
  74. package/dist/errors/validation.js.map +1 -1
  75. package/dist/events/index.d.ts +133 -0
  76. package/dist/events/index.d.ts.map +1 -1
  77. package/dist/events/index.js +30 -0
  78. package/dist/events/index.js.map +1 -1
  79. package/dist/idempotency/index.d.ts +355 -0
  80. package/dist/idempotency/index.d.ts.map +1 -0
  81. package/dist/idempotency/index.js +360 -0
  82. package/dist/idempotency/index.js.map +1 -0
  83. package/dist/jobs/index.d.ts +110 -0
  84. package/dist/jobs/index.d.ts.map +1 -1
  85. package/dist/jobs/index.js +22 -0
  86. package/dist/jobs/index.js.map +1 -1
  87. package/dist/mail/index.d.ts +149 -0
  88. package/dist/mail/index.d.ts.map +1 -1
  89. package/dist/mail/index.js +30 -0
  90. package/dist/mail/index.js.map +1 -1
  91. package/dist/notifications/index.d.ts +369 -0
  92. package/dist/notifications/index.d.ts.map +1 -0
  93. package/dist/notifications/index.js +310 -0
  94. package/dist/notifications/index.js.map +1 -0
  95. package/dist/openapi/index.d.ts +132 -16
  96. package/dist/openapi/index.d.ts.map +1 -1
  97. package/dist/openapi/index.js +1 -1
  98. package/dist/openapi/index.js.map +1 -1
  99. package/dist/outbox/index.d.ts +469 -0
  100. package/dist/outbox/index.d.ts.map +1 -0
  101. package/dist/outbox/index.js +482 -0
  102. package/dist/outbox/index.js.map +1 -0
  103. package/dist/pagination/index.d.ts +166 -0
  104. package/dist/pagination/index.d.ts.map +1 -0
  105. package/dist/pagination/index.js +96 -0
  106. package/dist/pagination/index.js.map +1 -0
  107. package/dist/ports/audit.d.ts +271 -0
  108. package/dist/ports/audit.d.ts.map +1 -1
  109. package/dist/ports/audit.js +128 -0
  110. package/dist/ports/audit.js.map +1 -1
  111. package/dist/ports/auth.d.ts +70 -0
  112. package/dist/ports/auth.d.ts.map +1 -1
  113. package/dist/ports/auth.js +30 -0
  114. package/dist/ports/auth.js.map +1 -1
  115. package/dist/ports/cache.d.ts +41 -0
  116. package/dist/ports/cache.d.ts.map +1 -1
  117. package/dist/ports/cache.js +10 -0
  118. package/dist/ports/cache.js.map +1 -1
  119. package/dist/ports/clock.d.ts +38 -0
  120. package/dist/ports/clock.d.ts.map +1 -1
  121. package/dist/ports/clock.js +20 -0
  122. package/dist/ports/clock.js.map +1 -1
  123. package/dist/ports/id-generator.d.ts +37 -0
  124. package/dist/ports/id-generator.d.ts.map +1 -1
  125. package/dist/ports/id-generator.js +22 -0
  126. package/dist/ports/id-generator.js.map +1 -1
  127. package/dist/ports/index.d.ts +83 -0
  128. package/dist/ports/index.d.ts.map +1 -1
  129. package/dist/ports/index.js +41 -5
  130. package/dist/ports/index.js.map +1 -1
  131. package/dist/ports/logger.d.ts +56 -0
  132. package/dist/ports/logger.d.ts.map +1 -1
  133. package/dist/ports/logger.js +17 -0
  134. package/dist/ports/logger.js.map +1 -1
  135. package/dist/ports/policy.d.ts +132 -0
  136. package/dist/ports/policy.d.ts.map +1 -1
  137. package/dist/ports/policy.js +45 -0
  138. package/dist/ports/policy.js.map +1 -1
  139. package/dist/ports/rate-limit.d.ts +25 -0
  140. package/dist/ports/rate-limit.d.ts.map +1 -1
  141. package/dist/ports/rate-limit.js +10 -0
  142. package/dist/ports/rate-limit.js.map +1 -1
  143. package/dist/ports/redaction.d.ts +101 -0
  144. package/dist/ports/redaction.d.ts.map +1 -1
  145. package/dist/ports/redaction.js +59 -0
  146. package/dist/ports/redaction.js.map +1 -1
  147. package/dist/ports/storage.d.ts +100 -0
  148. package/dist/ports/storage.d.ts.map +1 -1
  149. package/dist/ports/storage.js +10 -0
  150. package/dist/ports/storage.js.map +1 -1
  151. package/dist/ports/testing.d.ts +47 -0
  152. package/dist/ports/testing.d.ts.map +1 -1
  153. package/dist/ports/testing.js +23 -0
  154. package/dist/ports/testing.js.map +1 -1
  155. package/dist/ports/unit-of-work.d.ts +60 -3
  156. package/dist/ports/unit-of-work.d.ts.map +1 -1
  157. package/dist/ports/unit-of-work.js +11 -2
  158. package/dist/ports/unit-of-work.js.map +1 -1
  159. package/dist/providers/instrumentation.d.ts +204 -0
  160. package/dist/providers/instrumentation.d.ts.map +1 -1
  161. package/dist/providers/instrumentation.js +14 -0
  162. package/dist/providers/instrumentation.js.map +1 -1
  163. package/dist/providers/provider.d.ts +14 -1
  164. package/dist/providers/provider.d.ts.map +1 -1
  165. package/dist/providers/provider.js.map +1 -1
  166. package/dist/schedules/index.d.ts +246 -0
  167. package/dist/schedules/index.d.ts.map +1 -1
  168. package/dist/schedules/index.js +27 -0
  169. package/dist/schedules/index.js.map +1 -1
  170. package/dist/server/health.d.ts +14 -5
  171. package/dist/server/health.d.ts.map +1 -1
  172. package/dist/server/health.js +5 -2
  173. package/dist/server/health.js.map +1 -1
  174. package/dist/server/hooks/auth.d.ts +57 -0
  175. package/dist/server/hooks/auth.d.ts.map +1 -1
  176. package/dist/server/hooks/auth.js.map +1 -1
  177. package/dist/server/hooks/cors.d.ts +27 -0
  178. package/dist/server/hooks/cors.d.ts.map +1 -1
  179. package/dist/server/hooks/cors.js +12 -0
  180. package/dist/server/hooks/cors.js.map +1 -1
  181. package/dist/server/hooks/errors.d.ts +15 -6
  182. package/dist/server/hooks/errors.d.ts.map +1 -1
  183. package/dist/server/hooks/errors.js.map +1 -1
  184. package/dist/server/hooks/index.d.ts +3 -0
  185. package/dist/server/hooks/index.d.ts.map +1 -1
  186. package/dist/server/hooks/index.js +3 -0
  187. package/dist/server/hooks/index.js.map +1 -1
  188. package/dist/server/hooks/logging.d.ts +36 -0
  189. package/dist/server/hooks/logging.d.ts.map +1 -1
  190. package/dist/server/hooks/logging.js +6 -0
  191. package/dist/server/hooks/logging.js.map +1 -1
  192. package/dist/server/hooks/rate-limit.d.ts +33 -0
  193. package/dist/server/hooks/rate-limit.d.ts.map +1 -1
  194. package/dist/server/hooks/rate-limit.js +11 -0
  195. package/dist/server/hooks/rate-limit.js.map +1 -1
  196. package/dist/server/http.d.ts +170 -0
  197. package/dist/server/http.d.ts.map +1 -1
  198. package/dist/server/index.d.ts +18 -0
  199. package/dist/server/index.d.ts.map +1 -1
  200. package/dist/server/index.js +6 -0
  201. package/dist/server/index.js.map +1 -1
  202. package/dist/server/openapi.d.ts +5 -3
  203. package/dist/server/openapi.d.ts.map +1 -1
  204. package/dist/server/openapi.js +4 -2
  205. package/dist/server/openapi.js.map +1 -1
  206. package/dist/server/providers/loadProviderConfig.d.ts +9 -0
  207. package/dist/server/providers/loadProviderConfig.d.ts.map +1 -1
  208. package/dist/server/providers/loadProviderConfig.js +9 -0
  209. package/dist/server/providers/loadProviderConfig.js.map +1 -1
  210. package/dist/server/server.d.ts +107 -8
  211. package/dist/server/server.d.ts.map +1 -1
  212. package/dist/server/server.js +27 -7
  213. package/dist/server/server.js.map +1 -1
  214. package/dist/testing/index.d.ts +167 -0
  215. package/dist/testing/index.d.ts.map +1 -0
  216. package/dist/testing/index.js +119 -0
  217. package/dist/testing/index.js.map +1 -0
  218. package/package.json +21 -1
  219. package/src/application/index.ts +85 -22
  220. package/src/client/client.ts +73 -12
  221. package/src/client/index.ts +12 -0
  222. package/src/client/types.ts +70 -9
  223. package/src/config/index.ts +86 -0
  224. package/src/contracts/contract-builder.ts +49 -22
  225. package/src/contracts/contract-group.ts +35 -19
  226. package/src/contracts/contract-like.ts +4 -4
  227. package/src/contracts/index.ts +28 -1
  228. package/src/contracts/openapi-meta.ts +8 -8
  229. package/src/contracts/path-template.ts +27 -0
  230. package/src/contracts/types.ts +111 -10
  231. package/src/contracts/utils.ts +6 -0
  232. package/src/domain/entity.ts +22 -11
  233. package/src/domain/events.ts +5 -2
  234. package/src/domain/value-object.ts +19 -9
  235. package/src/errors/catalog.ts +40 -16
  236. package/src/errors/response.ts +16 -4
  237. package/src/errors/validation.ts +10 -1
  238. package/src/events/index.ts +134 -0
  239. package/src/idempotency/index.ts +767 -0
  240. package/src/jobs/index.ts +111 -0
  241. package/src/mail/index.ts +149 -0
  242. package/src/notifications/index.ts +771 -0
  243. package/src/openapi/index.ts +133 -16
  244. package/src/outbox/index.ts +1024 -0
  245. package/src/pagination/index.ts +278 -0
  246. package/src/ports/audit.ts +271 -0
  247. package/src/ports/auth.ts +70 -0
  248. package/src/ports/cache.ts +41 -0
  249. package/src/ports/clock.ts +38 -0
  250. package/src/ports/id-generator.ts +37 -0
  251. package/src/ports/index.ts +106 -11
  252. package/src/ports/logger.ts +56 -0
  253. package/src/ports/policy.ts +133 -0
  254. package/src/ports/rate-limit.ts +25 -0
  255. package/src/ports/redaction.ts +101 -0
  256. package/src/ports/storage.ts +100 -0
  257. package/src/ports/testing.ts +47 -0
  258. package/src/ports/unit-of-work.ts +60 -3
  259. package/src/providers/instrumentation.ts +204 -0
  260. package/src/providers/provider.ts +14 -1
  261. package/src/schedules/index.ts +247 -0
  262. package/src/server/health.ts +14 -5
  263. package/src/server/hooks/auth.ts +58 -0
  264. package/src/server/hooks/cors.ts +27 -0
  265. package/src/server/hooks/errors.ts +15 -6
  266. package/src/server/hooks/index.ts +3 -0
  267. package/src/server/hooks/logging.ts +36 -0
  268. package/src/server/hooks/rate-limit.ts +33 -0
  269. package/src/server/http.ts +170 -1
  270. package/src/server/index.ts +18 -1
  271. package/src/server/openapi.ts +5 -3
  272. package/src/server/providers/loadProviderConfig.ts +9 -0
  273. package/src/server/server.ts +107 -9
  274. package/src/testing/index.ts +337 -0
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,UAAU,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,gBAAgB,SAAS,MAAM,GAAG,KAAK,IAAI;IAClE;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzE;;OAEG;IACH,eAAe,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,KAAK,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,KAAK,wBAAwB,CAAC,IAAI,SAAS,MAAM,IAAI,IAAI,SAAS,EAAE,GAChE,IAAI,GACJ,IAAI,SAAS,MAAM,MAAM,EAAE,GACzB,IAAI,GACJ,IAAI,SAAS,IAAI,MAAM,EAAE,GACvB,IAAI,GACJ,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,GAChC,IAAI,GACJ,KAAK,CAAC;AAEhB,KAAK,gBAAgB,CAAC,OAAO,SAAS,MAAM,IAAI,OAAO,SAAS,IAAI,MAAM,IAAI,EAAE,GAC5E,wBAAwB,CAAC,IAAI,CAAC,SAAS,IAAI,GACzC,KAAK,GACL,IAAI,GACN,OAAO,SAAS,IAAI,MAAM,IAAI,GAAG,GAC/B,wBAAwB,CAAC,IAAI,CAAC,SAAS,IAAI,GACzC,KAAK,GACL,IAAI,GACN,KAAK,CAAC;AAEZ,KAAK,cAAc,CAAC,KAAK,SAAS,MAAM,IAAI,MAAM,SAAS,KAAK,GAC5D,KAAK,GACL,KAAK,SAAS,GAAG,MAAM,OAAO,IAAI,MAAM,IAAI,EAAE,GAC5C,gBAAgB,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,GAChD,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAE9B,KAAK,2BAA2B,CAAC,KAAK,SAAS,MAAM,IAAI;IACvD,cAAc,CAAC,KAAK,CAAC;CACtB,SAAS,CAAC,KAAK,CAAC,GACb,SAAS,GACT;KAAG,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,GAAG,kBAAkB;CAAE,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,SAAS,SAAS,kBAAkB,IAC9D,SAAS,CAAC,YAAY,CAAC,SAAS,gBAAgB,GAC5C,UAAU,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,GACnC,2BAA2B,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,SAAS,SAAS,kBAAkB,IACzD,SAAS,CAAC,OAAO,CAAC,SAAS,gBAAgB,GACvC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAC9B,SAAS,CAAC;AAEhB;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,SAAS,SAAS,kBAAkB,IAC3D,sBAAsB,CACpB,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CACzC,SAAS,SAAS,GACf,SAAS,GACT,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,SAAS,SAAS,kBAAkB,IACxD,SAAS,CAAC,QAAQ,CAAC,SAAS,cAAc,GACtC,SAAS,CAAC,MAAM,CAAC,SAAS,gBAAgB,GACxC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAC7B,SAAS,GACX,SAAS,CAAC;AAEhB;;GAEG;AACH,KAAK,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACnD,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,MAAM,EAAE,GACnE,CAAC,GACD,KAAK,CAAC;AACV,KAAK,UAAU,GAAG,QAAQ,CAAC,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC;AAChD,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACjC,CAAC,GACD,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,MAAM,EAAE,GACnC,CAAC,GACD,KAAK,CAAC;AAEZ;;GAEG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI;KAChC,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,UAAU,GAAG,CAAC,GAAG,KAAK;CAC7D,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;GAEG;AACH,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI;KAClC,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,UAAU,GAAG,KAAK,GAAG,CAAC;CAC7D,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,KAAK,iBAAiB,CACpB,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,MAAM,IACpB,OAAO,SAAS,MAAM,UAAU,GAChC,UAAU,CAAC,OAAO,CAAC,GACnB,GAAG,OAAO,EAAE,SAAS,MAAM,UAAU,GACnC,UAAU,CAAC,GAAG,OAAO,EAAE,CAAC,GACxB,KAAK,CAAC;AAEZ;;GAEG;AACH,KAAK,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GACtC,SAAS,GACT,CAAC,SAAS,gBAAgB,GACxB,WAAW,CAAC,CAAC,CAAC,GACd,OAAO,CAAC;AAEd;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,CAAC,SAAS,SAAS,kBAAkB,IACnE,SAAS,CAAC,WAAW,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC,GACzE,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,GAC/C,CAAC,SAAS,MAAM,SAAS,CAAC,WAAW,CAAC,GACpC,iBAAiB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAC5C,OAAO,GACT,OAAO,GACT,OAAO,CAAC;AAEd;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,SAAS,SAAS,kBAAkB,IACjE,SAAS,CAAC,WAAW,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC,GACzE,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,GACjD,CAAC,SAAS,MAAM,SAAS,CAAC,WAAW,CAAC,GACpC,iBAAiB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAC5C,OAAO,GACT,OAAO,GACT,OAAO,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,SAAS,SAAS,kBAAkB,IACvE,SAAS,CAAC,WAAW,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC,GACzE,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,GAC/C,KAAK,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,0BAA0B,CACpC,SAAS,SAAS,kBAAkB,EACpC,OAAO,SAAS,MAAM,IAEtB,SAAS,CAAC,WAAW,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC,GACzE,iBAAiB,CAAC,iBAAiB,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,GACrE,OAAO,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,kCAAkC,CAC5C,SAAS,SAAS,kBAAkB,EACpC,OAAO,SAAS,MAAM,IAEpB,0BAA0B,CAAC,SAAS,EAAE,OAAO,CAAC,GAC9C,iBAAiB,GACjB,MAAM,GACN,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,CAAC,SAAS,SAAS,kBAAkB,IACvE,kBAAkB,CAAC,SAAS,CAAC,GAC7B,iBAAiB,GACjB,MAAM,GACN,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,SAAS,SAAS,kBAAkB,IAAI;IACxE;;OAEG;IACH,EAAE,EAAE,IAAI,CAAC;IACT;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACtC;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,MAAM,IAAI;IACxC;;OAEG;IACH,EAAE,EAAE,KAAK,CAAC;IACV;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,SAAS,SAAS,kBAAkB,EAAE,MAAM,IACnE,qBAAqB,CAAC,SAAS,CAAC,GAChC,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAEhC,KAAK,UAAU,CACb,IAAI,SAAS,MAAM,GAAG,OAAO,GAAG,MAAM,EACtC,KAAK,IACH,KAAK,SAAS,SAAS,GACvB;KAAG,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,SAAS;CAAE,GAC3B,SAAS,SAAS,KAAK,GACrB;KAAG,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK;CAAE,GACvB;KAAG,CAAC,IAAI,IAAI,GAAG,KAAK;CAAE,CAAC;AAE7B,KAAK,QAAQ,CAAC,SAAS,SAAS,kBAAkB,IAAI,UAAU,CAC9D,MAAM,EACN,eAAe,CAAC,SAAS,CAAC,CAC3B,CAAC;AAEF,KAAK,SAAS,CAAC,SAAS,SAAS,kBAAkB,IAAI,UAAU,CAC/D,OAAO,EACP,UAAU,CAAC,SAAS,CAAC,CACtB,CAAC;AAEF,KAAK,QAAQ,CAAC,SAAS,SAAS,kBAAkB,IAAI,UAAU,CAC9D,MAAM,EACN,SAAS,CAAC,SAAS,CAAC,CACrB,CAAC;AAEF,KAAK,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,SAAS,MAAM,IAAI,OAAO,CAC1E,MAAM,QAAQ,EACd,gBAAgB,CACjB,CAAC;AAEF,KAAK,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,SAAS,MAAM,IAAI,IAAI,CACzE,QAAQ,EACR,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAC/C,GACC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAE1E,KAAK,WAAW,CACd,SAAS,SAAS,kBAAkB,EACpC,gBAAgB,SAAS,MAAM,IAE/B,YAAY,CAAC,SAAS,CAAC,SAAS,SAAS,GACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,oBAAoB,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAEtE,KAAK,WAAW,CACd,SAAS,SAAS,kBAAkB,EACpC,gBAAgB,SAAS,MAAM,IAE/B,YAAY,CAAC,SAAS,CAAC,SAAS,SAAS,GACrC;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACpC,eAAe,CAAC,WAAW,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,SAAS,KAAK,GACrE;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;CAAE,GACtD;IAAE,OAAO,EAAE,WAAW,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAA;CAAE,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAC1B,SAAS,SAAS,kBAAkB,EACpC,gBAAgB,SAAS,MAAM,GAAG,KAAK,IACrC,QAAQ,CAAC,SAAS,CAAC,GACrB,SAAS,CAAC,SAAS,CAAC,GACpB,QAAQ,CAAC,SAAS,CAAC,GAAG;IACpB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,SAAS,cAAc,GAAG,QAAQ,GAAG,KAAK,CAAC;IACxE;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,WAAW,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;AAE/C,KAAK,eAAe,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC;CACvE,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,CAClB,SAAS,SAAS,kBAAkB,EACpC,gBAAgB,SAAS,MAAM,GAAG,KAAK,IAEvC,eAAe,CAAC,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,SAAS,KAAK,GACxE,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,GACtD,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC"}
@@ -5,29 +5,71 @@
5
5
  * ArkType, etc.) for Beignet applications and providers.
6
6
  */
7
7
  import type { StandardSchemaV1 } from "@standard-schema/spec";
8
+ /**
9
+ * Any Standard Schema compatible validator.
10
+ */
8
11
  export type StandardSchema = StandardSchemaV1<unknown, unknown>;
12
+ /**
13
+ * Runtime environment object shape.
14
+ */
9
15
  export type RuntimeEnv = Record<string, string | undefined>;
16
+ /**
17
+ * Map of environment variable names to Standard Schema validators.
18
+ */
10
19
  export type EnvSchemaShape = Record<string, StandardSchema>;
11
20
  type EmptyEnvSchemaShape = Record<keyof never, never>;
12
21
  type NoInferType<T> = [T][T extends unknown ? 0 : never];
22
+ /**
23
+ * Infer the parsed output type from a Standard Schema.
24
+ */
13
25
  export type InferOutput<T extends StandardSchemaV1> = StandardSchemaV1.InferOutput<T>;
26
+ /**
27
+ * Infer the parsed output object for an env schema shape.
28
+ */
14
29
  export type InferEnvShape<Shape extends EnvSchemaShape> = {
15
30
  [Key in keyof Shape]: InferOutput<Shape[Key]>;
16
31
  };
32
+ /**
33
+ * Env schema shape constrained to a client prefix.
34
+ */
17
35
  export type ClientEnvSchemaShape<ClientPrefix extends string> = ClientPrefix extends "" ? EnvSchemaShape : Record<`${ClientPrefix}${string}`, StandardSchema>;
18
36
  type ValidateClientEnvShape<ClientPrefix extends string, Client extends EnvSchemaShape> = ClientPrefix extends "" ? Client : {
19
37
  [Key in keyof Client]: Key extends `${ClientPrefix}${string}` ? Client[Key] : never;
20
38
  };
39
+ /**
40
+ * Raw Standard Schema validation issue produced while loading config.
41
+ */
21
42
  export type EnvValidationIssue = StandardSchemaV1.Issue;
43
+ /**
44
+ * Error thrown when Beignet config validation fails.
45
+ */
22
46
  export declare class ConfigValidationError extends Error {
47
+ /**
48
+ * Raw Standard Schema validation issues.
49
+ */
23
50
  readonly issues: readonly EnvValidationIssue[];
24
51
  constructor(issues: readonly EnvValidationIssue[], message?: string);
25
52
  }
53
+ /**
54
+ * Options for reading raw environment variables.
55
+ */
26
56
  export interface ReadEnvOptions {
57
+ /**
58
+ * Runtime environment object. Defaults to `process.env`.
59
+ */
27
60
  env?: RuntimeEnv;
61
+ /**
62
+ * Optional prefix to filter and strip from matching keys.
63
+ */
28
64
  prefix?: string;
65
+ /**
66
+ * Treat empty strings as missing values.
67
+ */
29
68
  emptyStringAsUndefined?: boolean;
30
69
  }
70
+ /**
71
+ * Options for defining a single validated env loader.
72
+ */
31
73
  export interface DefineEnvOptions<Schema extends StandardSchemaV1> {
32
74
  /**
33
75
  * Standard Schema for validating the full environment object.
@@ -56,11 +98,20 @@ export interface DefineEnvOptions<Schema extends StandardSchemaV1> {
56
98
  */
57
99
  onValidationError?: (issues: readonly EnvValidationIssue[]) => never;
58
100
  }
101
+ /**
102
+ * Validated env loader returned by `defineEnv(...)`.
103
+ */
59
104
  export interface EnvInstance<Out> {
105
+ /**
106
+ * Read and validate the environment.
107
+ */
60
108
  load(options?: {
61
109
  env?: RuntimeEnv;
62
110
  }): Out;
63
111
  }
112
+ /**
113
+ * Options for `createEnv(...)`.
114
+ */
64
115
  export interface CreateEnvOptions<Server extends EnvSchemaShape, ClientPrefix extends string, Client extends EnvSchemaShape> {
65
116
  /**
66
117
  * Server-only environment variables. These throw if accessed from a client
@@ -111,12 +162,45 @@ export interface CreateEnvOptions<Server extends EnvSchemaShape, ClientPrefix ex
111
162
  */
112
163
  onInvalidAccess?: (key: string) => never;
113
164
  }
165
+ /**
166
+ * Parsed env object returned by `createEnv(...)`.
167
+ */
114
168
  export type CreateEnvResult<Server extends EnvSchemaShape, Client extends EnvSchemaShape> = Readonly<InferEnvShape<Server> & InferEnvShape<Client>>;
169
+ /**
170
+ * Format Standard Schema issues into a single readable message.
171
+ */
115
172
  export declare function formatStandardSchemaIssues(issues: readonly StandardSchemaV1.Issue[]): string;
173
+ /**
174
+ * Read raw environment variables, optionally filtering by prefix.
175
+ *
176
+ * When a prefix is provided, matching keys are stripped before being returned.
177
+ */
116
178
  export declare function readEnv({ env, prefix, emptyStringAsUndefined, }?: ReadEnvOptions): Record<string, string | undefined>;
179
+ /**
180
+ * Validate input with a synchronous Standard Schema.
181
+ *
182
+ * Throws when the schema returns a promise because env loading is synchronous.
183
+ */
117
184
  export declare function parseStandardSchemaSync<Schema extends StandardSchemaV1>(schema: Schema, input: unknown): InferOutput<Schema>;
185
+ /**
186
+ * Validate input with a Standard Schema that may be synchronous or async.
187
+ */
118
188
  export declare function parseStandardSchemaAsync<Schema extends StandardSchemaV1>(schema: Schema, input: unknown): Promise<InferOutput<Schema>>;
189
+ /**
190
+ * Define a reusable validated env loader.
191
+ *
192
+ * This is useful for provider config and app-level config objects that are
193
+ * loaded from a prefixed subset of the environment.
194
+ */
119
195
  export declare function defineEnv<Schema extends StandardSchemaV1>(options: DefineEnvOptions<Schema>): EnvInstance<InferOutput<Schema>>;
196
+ /**
197
+ * Create a server/client split env object.
198
+ *
199
+ * Server variables are available only on the server. Client variables must use
200
+ * `clientPrefix` when provided. Validation is synchronous, empty strings are
201
+ * treated as undefined by default, and client access to server-only keys throws
202
+ * through the returned proxy.
203
+ */
120
204
  export declare function createEnv<const ClientPrefix extends string = "", Server extends EnvSchemaShape = EmptyEnvSchemaShape, Client extends EnvSchemaShape = EmptyEnvSchemaShape>(options: CreateEnvOptions<Server, ClientPrefix, Client>): CreateEnvResult<Server, Client>;
121
205
  export {};
122
206
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}
@@ -4,7 +4,13 @@
4
4
  * Environment-first configuration layer using Standard Schema (Zod, Valibot,
5
5
  * ArkType, etc.) for Beignet applications and providers.
6
6
  */
7
+ /**
8
+ * Error thrown when Beignet config validation fails.
9
+ */
7
10
  export class ConfigValidationError extends Error {
11
+ /**
12
+ * Raw Standard Schema validation issues.
13
+ */
8
14
  issues;
9
15
  constructor(issues, message) {
10
16
  super(message ?? formatStandardSchemaIssues(issues));
@@ -50,6 +56,9 @@ function prependIssuePath(key, issue) {
50
56
  path: [{ key }, ...(issue.path ?? [])],
51
57
  };
52
58
  }
59
+ /**
60
+ * Format Standard Schema issues into a single readable message.
61
+ */
53
62
  export function formatStandardSchemaIssues(issues) {
54
63
  return issues
55
64
  .map((issue) => {
@@ -58,6 +67,11 @@ export function formatStandardSchemaIssues(issues) {
58
67
  })
59
68
  .join("; ");
60
69
  }
70
+ /**
71
+ * Read raw environment variables, optionally filtering by prefix.
72
+ *
73
+ * When a prefix is provided, matching keys are stripped before being returned.
74
+ */
61
75
  export function readEnv({ env = defaultRuntimeEnv(), prefix, emptyStringAsUndefined = false, } = {}) {
62
76
  const raw = {};
63
77
  for (const [key, value] of Object.entries(env)) {
@@ -82,6 +96,11 @@ function validationResultValue(result) {
82
96
  }
83
97
  throw new Error("Invalid Standard Schema result: missing value");
84
98
  }
99
+ /**
100
+ * Validate input with a synchronous Standard Schema.
101
+ *
102
+ * Throws when the schema returns a promise because env loading is synchronous.
103
+ */
85
104
  export function parseStandardSchemaSync(schema, input) {
86
105
  const validate = schema?.["~standard"]?.validate;
87
106
  if (typeof validate !== "function") {
@@ -93,6 +112,9 @@ export function parseStandardSchemaSync(schema, input) {
93
112
  }
94
113
  return validationResultValue(result);
95
114
  }
115
+ /**
116
+ * Validate input with a Standard Schema that may be synchronous or async.
117
+ */
96
118
  export async function parseStandardSchemaAsync(schema, input) {
97
119
  const validate = schema?.["~standard"]?.validate;
98
120
  if (typeof validate !== "function") {
@@ -109,6 +131,12 @@ function wrapEnvError(err, prefix) {
109
131
  }
110
132
  return new Error(`[Beignet env] Invalid environment${prefix ? ` for prefix "${prefix}"` : ""}: ${String(err)}`);
111
133
  }
134
+ /**
135
+ * Define a reusable validated env loader.
136
+ *
137
+ * This is useful for provider config and app-level config objects that are
138
+ * loaded from a prefixed subset of the environment.
139
+ */
112
140
  export function defineEnv(options) {
113
141
  const { schema, prefix, runtimeEnv, emptyStringAsUndefined = false, skipValidation = false, onValidationError, } = options;
114
142
  function load({ env = runtimeEnv ?? defaultRuntimeEnv(), } = {}) {
@@ -164,6 +192,14 @@ function validateRuntimeEnvStrict(runtimeEnv, keys) {
164
192
  return;
165
193
  throw new Error(`[Beignet env] runtimeEnvStrict is missing declared keys: ${missing.join(", ")}`);
166
194
  }
195
+ /**
196
+ * Create a server/client split env object.
197
+ *
198
+ * Server variables are available only on the server. Client variables must use
199
+ * `clientPrefix` when provided. Validation is synchronous, empty strings are
200
+ * treated as undefined by default, and client access to server-only keys throws
201
+ * through the returned proxy.
202
+ */
167
203
  export function createEnv(options) {
168
204
  const server = (options.server ?? {});
169
205
  const client = (options.client ?? {});
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}
@@ -2,8 +2,12 @@ import type { StandardSchemaV1 } from "@standard-schema/spec";
2
2
  import type { OpenAPIOperationMeta } from "./openapi-meta";
3
3
  import type { BodyHttpMethod, ContractErrorResponses, ContractHeaderSchemas, ContractMeta, ContractResponses, HttpContractConfig, HttpMethod, ResponsesFromErrorDefinitions, StandardSchema } from "./types";
4
4
  /**
5
- * Contract builder for constructing HTTP contracts in a fluent API style
6
- * Schemas are accessible via the .schema property for introspection
5
+ * Fluent builder for one HTTP contract.
6
+ *
7
+ * A contract describes the transport boundary for one endpoint: method, path,
8
+ * request schemas, response schemas, metadata, and route-owned catalog errors.
9
+ * Builder methods are immutable; each call returns a new builder with narrower
10
+ * types.
7
11
  */
8
12
  export declare class ContractBuilder<TMethod extends HttpMethod, TPathParams extends StandardSchema | null, TQuery extends StandardSchema | null, TBody extends StandardSchema | null, THeaders extends ContractHeaderSchemas, TResponses extends ContractResponses, TMeta extends ContractMeta, TPath extends string = string> {
9
13
  readonly kind: "http";
@@ -20,7 +24,10 @@ export declare class ContractBuilder<TMethod extends HttpMethod, TPathParams ext
20
24
  private readonly _meta;
21
25
  constructor(config: HttpContractConfig<TMethod, TPathParams, TQuery, TBody, TResponses, TMeta, TPath, THeaders>);
22
26
  /**
23
- * Access schemas for introspection
27
+ * Request and response schemas attached to this contract.
28
+ *
29
+ * Server adapters use these for validation. Client and frontend integrations
30
+ * use them for local validation and type inference.
24
31
  */
25
32
  get schema(): {
26
33
  pathParams: TPathParams;
@@ -30,71 +37,84 @@ export declare class ContractBuilder<TMethod extends HttpMethod, TPathParams ext
30
37
  responses: TResponses;
31
38
  };
32
39
  /**
33
- * Get response schemas for introspection
40
+ * Response schemas keyed by HTTP status code.
34
41
  */
35
42
  get responseSchemas(): TResponses;
36
43
  /**
37
- * Get the URL path template
44
+ * URL path template for this contract.
38
45
  */
39
46
  get pathTemplate(): TPath;
40
47
  /**
41
- * Get the URL path (alias for pathTemplate)
48
+ * URL path template alias.
42
49
  */
43
50
  get path(): TPath;
44
51
  /**
45
- * Get contract metadata
52
+ * Metadata consumed by hooks, OpenAPI generation, and app conventions.
46
53
  */
47
54
  get metadata(): TMeta;
48
55
  /**
49
- * Get the contract as an HttpContractConfig object
50
- * Use this when passing to adapters that expect the plain config type
56
+ * Plain contract config consumed by framework internals and integrations.
51
57
  */
52
58
  get config(): HttpContractConfig<TMethod, TPathParams, TQuery, TBody, TResponses, TMeta, TPath, THeaders>;
53
59
  /**
54
- * Set path parameters schema (chainable builder method)
60
+ * Attach a schema for dynamic path parameters.
61
+ *
62
+ * The schema validates parameters parsed from path templates such as
63
+ * `/posts/:id` or `/posts/[id]`.
55
64
  */
56
65
  pathParams<TNewPathParams extends StandardSchemaV1>(schema: TNewPathParams): ContractBuilder<TMethod, TNewPathParams, TQuery, TBody, THeaders, TResponses, TMeta, TPath>;
57
66
  /**
58
- * Set query parameters schema (chainable builder method)
67
+ * Attach a schema for query parameters.
59
68
  */
60
69
  query<TNewQuery extends StandardSchemaV1>(schema: TNewQuery): ContractBuilder<TMethod, TPathParams, TNewQuery, TBody, THeaders, TResponses, TMeta, TPath>;
61
70
  /**
62
- * Set request body schema (chainable builder method)
63
- * Only available on POST, PUT, and PATCH contracts.
71
+ * Attach a schema for a JSON request body.
72
+ *
73
+ * This method is only available on POST, PUT, and PATCH contracts.
64
74
  */
65
75
  body<TNewBody extends StandardSchemaV1>(this: ContractBuilder<BodyHttpMethod, StandardSchema | null, StandardSchema | null, StandardSchema | null, ContractHeaderSchemas, ContractResponses, ContractMeta, TPath>, schema: TNewBody): ContractBuilder<TMethod, TPathParams, TQuery, TNewBody, THeaders, TResponses, TMeta, TPath>;
66
76
  /**
67
- * Add request header schema (chainable).
77
+ * Attach a request header schema.
68
78
  *
69
79
  * Multiple schemas are evaluated in declaration order and their parsed
70
- * outputs are merged. This keeps group-level headers library-agnostic.
80
+ * outputs are merged. This lets a contract inherit shared group headers and
81
+ * still declare route-specific headers.
71
82
  */
72
83
  headers<TNewHeaders extends StandardSchemaV1>(schema: TNewHeaders): ContractBuilder<TMethod, TPathParams, TQuery, TBody, THeaders extends readonly StandardSchema[] ? readonly [...THeaders, TNewHeaders] : THeaders extends StandardSchema ? readonly [THeaders, TNewHeaders] : readonly [TNewHeaders], TResponses, TMeta, TPath>;
73
84
  /**
74
- * Add or replace response schemas by status code (chainable).
85
+ * Add or replace route-owned response schemas by status code.
86
+ *
87
+ * These schemas describe business responses returned by route handlers.
88
+ * Framework-owned errors such as request validation failures do not need to be
89
+ * declared here.
90
+ *
75
91
  * Use `null` for void/empty responses such as 204 No Content.
76
92
  */
77
93
  responses<TNewResponses extends ContractResponses>(responseSchemas: TNewResponses): ContractBuilder<TMethod, TPathParams, TQuery, TBody, THeaders, Omit<TResponses, keyof TNewResponses> & TNewResponses, TMeta, TPath>;
78
94
  /**
79
95
  * Declare route-owned application errors from an error catalog.
80
96
  *
81
- * Catalog errors use Beignet's standard error response envelope. Use
82
- * `.responses()` when a route needs a custom error response body.
97
+ * Catalog errors use Beignet's standard error response envelope and remain
98
+ * distinguishable from framework-owned errors. Use `.responses()` when a
99
+ * route needs a custom error response body instead of catalog semantics.
83
100
  */
84
101
  errors<TErrorDefs extends ContractErrorResponses>(errorDefs: TErrorDefs): ContractBuilder<TMethod, TPathParams, TQuery, TBody, THeaders, Omit<TResponses, keyof ResponsesFromErrorDefinitions<TErrorDefs>> & ResponsesFromErrorDefinitions<TErrorDefs>, Omit<TMeta, "errors"> & {
85
102
  errors: TErrorDefs;
86
103
  }, TPath>;
87
104
  /**
88
- * Set or merge contract metadata (chainable builder method)
105
+ * Merge metadata into this contract.
106
+ *
107
+ * Hooks and tooling can read metadata for concerns such as auth, rate limits,
108
+ * idempotency, OpenAPI, or app-specific conventions.
89
109
  */
90
110
  meta<TNewMeta extends ContractMeta>(newMeta: TNewMeta): ContractBuilder<TMethod, TPathParams, TQuery, TBody, THeaders, TResponses, Omit<TMeta, keyof TNewMeta> & TNewMeta, TPath>;
91
111
  /**
92
- * Set or merge OpenAPI metadata for this operation (chainable)
112
+ * Merge OpenAPI operation metadata into this contract.
93
113
  */
94
114
  openapi(patch: Partial<OpenAPIOperationMeta>): ContractBuilder<TMethod, TPathParams, TQuery, TBody, THeaders, TResponses, TMeta, TPath>;
95
115
  }
96
116
  /**
97
- * Options for creating a contract with the factory function
117
+ * Options for creating one contract with `createContract(...)`.
98
118
  */
99
119
  export type CreateContractOptions<TMethod extends HttpMethod = HttpMethod, TPath extends string = string> = {
100
120
  /** HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS) */
@@ -105,7 +125,11 @@ export type CreateContractOptions<TMethod extends HttpMethod = HttpMethod, TPath
105
125
  name?: string;
106
126
  };
107
127
  /**
108
- * Create a new HTTP contract with the builder pattern.
128
+ * Create a new HTTP contract builder.
129
+ *
130
+ * Most apps prefer `createContractGroup().namespace(...).prefix(...)` for
131
+ * related feature contracts. Use this lower-level factory when a standalone
132
+ * contract is clearer.
109
133
  *
110
134
  * @example
111
135
  * ```ts
@@ -116,6 +140,9 @@ export type CreateContractOptions<TMethod extends HttpMethod = HttpMethod, TPath
116
140
  * .pathParams(z.object({ id: z.string() }))
117
141
  * .responses({ 200: TodoSchema });
118
142
  * ```
143
+ *
144
+ * @param options - HTTP method, path template, and optional contract name.
145
+ * @returns A fluent contract builder.
119
146
  */
120
147
  export declare function createContract<TMethod extends HttpMethod, const TPath extends string>(options: CreateContractOptions<TMethod, TPath>): ContractBuilder<TMethod, null, null, null, null, Record<never, never>, ContractMeta, TPath>;
121
148
  //# sourceMappingURL=contract-builder.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"contract-builder.d.ts","sourceRoot":"","sources":["../../src/contracts/contract-builder.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"contract-builder.d.ts","sourceRoot":"","sources":["../../src/contracts/contract-builder.ts"],"names":[],"mappings":"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"}