@classytic/arc 2.45.1 → 2.46.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 (321) hide show
  1. package/README.md +1 -1
  2. package/dist/{EventTransport-CiicKz2Z.d.mts → EventTransport-CYEoCJGe.d.mts} +0 -2
  3. package/dist/{EventTransport-4b0noGwa.mjs → EventTransport-DNgD9NP4.mjs} +3 -4
  4. package/dist/{HookSystem-4pABQnGn.mjs → HookSystem-DRbPzEcP.mjs} +3 -4
  5. package/dist/{QueryCache--5uAuYPW.d.mts → QueryCache-DdvrGG8Q.d.mts} +1 -3
  6. package/dist/{ResourceRegistry-BBaN_Ne-.mjs → ResourceRegistry-Douk51fa.mjs} +15 -4
  7. package/dist/{acquire-kiZzy5bX.mjs → acquire-RbtvDg9s.mjs} +2 -3
  8. package/dist/{actionPermissions-BLnbDA6g.mjs → actionPermissions-De0AJ7hm.mjs} +37 -42
  9. package/dist/audit/index.d.mts +2 -10
  10. package/dist/audit/index.mjs +8 -12
  11. package/dist/auth/audit.d.mts +0 -2
  12. package/dist/auth/audit.mjs +2 -3
  13. package/dist/auth/index.d.mts +9 -17
  14. package/dist/auth/index.mjs +26 -29
  15. package/dist/auth/redis-session.d.mts +2 -4
  16. package/dist/auth/redis-session.mjs +2 -3
  17. package/dist/{authorizationDecision-CVlaTjAX.mjs → authorizationDecision-DeZMrHcm.mjs} +5 -6
  18. package/dist/{base-CZyixEQR.d.mts → base-HXNgPQww.d.mts} +1 -7
  19. package/dist/{boundedMap-DSy7KkeX.mjs → boundedMap-2WBh3gM9.mjs} +2 -3
  20. package/dist/{buildHandler-B4IhILv9.mjs → buildHandler-DxVOOBpw.mjs} +5 -6
  21. package/dist/cache/index.d.mts +4 -10
  22. package/dist/cache/index.mjs +5 -6
  23. package/dist/{caching-DqakP2vY.mjs → caching-BYRwYrUo.mjs} +3 -4
  24. package/dist/{claimed-XoiVrWZ2.mjs → claimed-DYlELdnm.mjs} +2 -3
  25. package/dist/cleanup/index.d.mts +9 -18
  26. package/dist/cleanup/index.mjs +12 -20
  27. package/dist/cli/commands/describe.d.mts +1 -3
  28. package/dist/cli/commands/describe.mjs +4 -5
  29. package/dist/cli/commands/docs.d.mts +1 -3
  30. package/dist/cli/commands/docs.mjs +4 -5
  31. package/dist/cli/commands/doctor.d.mts +1 -3
  32. package/dist/cli/commands/doctor.mjs +2 -3
  33. package/dist/cli/commands/generate.d.mts +1 -1
  34. package/dist/cli/commands/generate.mjs +2 -2
  35. package/dist/cli/commands/init.d.mts +1 -1
  36. package/dist/cli/commands/init.mjs +2 -2
  37. package/dist/cli/commands/introspect.d.mts +1 -3
  38. package/dist/cli/commands/introspect.mjs +3 -4
  39. package/dist/cli/index.d.mts +2 -2
  40. package/dist/cli/index.mjs +3 -3
  41. package/dist/{constants-CtWkmWn3.mjs → constants-CHZMUwBW.mjs} +2 -3
  42. package/dist/context/index.d.mts +0 -8
  43. package/dist/context/index.mjs +6 -7
  44. package/dist/core/index.d.mts +3 -3
  45. package/dist/core/index.mjs +8 -8
  46. package/dist/{core-Cro2v5a7.mjs → core-D9rS2BxO.mjs} +9 -12
  47. package/dist/{createActionRouter-k-gwiPv6.mjs → createActionRouter-0qkCRzTL.mjs} +7 -8
  48. package/dist/{createAggregationRouter-BqWqhAPG.mjs → createAggregationRouter-CUf5Esd9.mjs} +9 -10
  49. package/dist/{createApp-Dw7L72Hz.mjs → createApp-DZIXfDKD.mjs} +49 -62
  50. package/dist/{createMcpServer-DSztofa9.d.mts → createMcpServer-DeVpqQF-.d.mts} +1 -3
  51. package/dist/{defineAggregation-pxbd7BBK.mjs → defineAggregation-bmKQ4NmC.mjs} +2 -3
  52. package/dist/{defineResource-DwgEjLCO.mjs → defineResource-CGmdmGwh.mjs} +78 -29
  53. package/dist/discovery/index.d.mts +1 -3
  54. package/dist/discovery/index.mjs +2 -3
  55. package/dist/docs/index.d.mts +8 -8
  56. package/dist/docs/index.mjs +4 -5
  57. package/dist/{elevation-B9wF2Z1F.mjs → elevation-CzhqAyVN.mjs} +9 -10
  58. package/dist/{elevation-BW2J3tNj.d.mts → elevation-DPD0hcU-.d.mts} +0 -2
  59. package/dist/encryption/index.d.mts +1 -7
  60. package/dist/encryption/index.mjs +8 -13
  61. package/dist/{errorHandler--4rSMMvq.d.mts → errorHandler-B9r88jZV.d.mts} +8 -3
  62. package/dist/{errorHandler-Dr2nG0Ui.mjs → errorHandler-dFyGOEoB.mjs} +16 -6
  63. package/dist/{errors-BtHzrSA6.mjs → errors-BY8vzlP4.mjs} +2 -3
  64. package/dist/{errors-JYc9vwqE.d.mts → errors-DTo0me1o.d.mts} +0 -2
  65. package/dist/{eventPlugin-BtmA4-3P.d.mts → eventPlugin-BY38F6yK.d.mts} +1 -7
  66. package/dist/{eventPlugin-Dvs7OBw8.mjs → eventPlugin-eMhAPtQA.mjs} +10 -12
  67. package/dist/{eventTypes-BVoCTG5c.mjs → eventTypes-Do2KYeJx.mjs} +5 -8
  68. package/dist/events/index.d.mts +4 -16
  69. package/dist/events/index.mjs +8 -9
  70. package/dist/events/transports/redis-stream-entry.d.mts +1 -1
  71. package/dist/events/transports/redis-stream-entry.mjs +5 -6
  72. package/dist/events/transports/redis.d.mts +2 -4
  73. package/dist/events/transports/redis.mjs +3 -4
  74. package/dist/{externalPaths-CmGOxOtD.d.mts → externalPaths-BOqdq5wr.d.mts} +0 -2
  75. package/dist/factory/index.d.mts +4 -14
  76. package/dist/factory/index.mjs +12 -18
  77. package/dist/{fastify-augmentation-DRlCIWE9.d.mts → fastify-augmentation-Dtn0IIRn.d.mts} +4 -10
  78. package/dist/{fields-BBSpf8pS.d.mts → fields-JTkrtO-r.d.mts} +0 -2
  79. package/dist/{fields-C1e_7Fwi.mjs → fields-LnbCcvsw.mjs} +2 -3
  80. package/dist/{filter-merge-xaiEKtz8.mjs → filter-merge-BAWi019Q.mjs} +2 -3
  81. package/dist/{generate-DCGuEbqI.d.mts → generate-C-g_KOkV.d.mts} +0 -4
  82. package/dist/{generate-DJiJMaXN.mjs → generate-oXoDnpJf.mjs} +7 -12
  83. package/dist/{headers-Dr-wt6Tr.mjs → headers-DBd3Qheo.mjs} +3 -4
  84. package/dist/{health-DkkWbJtQ.mjs → health-BlJu9GXS.mjs} +2 -3
  85. package/dist/{health-BLYn_Hds.mjs → health-Dp-3EC9o.mjs} +4 -7
  86. package/dist/hooks/index.d.mts +1 -1
  87. package/dist/hooks/index.mjs +2 -2
  88. package/dist/idempotency/index.d.mts +3 -9
  89. package/dist/idempotency/index.mjs +10 -13
  90. package/dist/idempotency/redis.d.mts +1 -1
  91. package/dist/idempotency/redis.mjs +3 -4
  92. package/dist/{index-Bxriq3so.d.mts → index-B5i9-vuP.d.mts} +4 -26
  93. package/dist/{index-Chgz3d0i.d.mts → index-BAXDo5eE.d.mts} +1 -7
  94. package/dist/{index-Beg3aNnK.d.mts → index-BTxzJ_MN.d.mts} +67 -25
  95. package/dist/{index-CUJvoyw3.d.mts → index-Bqfo8hLz.d.mts} +2 -24
  96. package/dist/{index-uhkUA5-U.d.mts → index-CUdaoCYt.d.mts} +13 -23
  97. package/dist/{index-WH7xgvxS.d.mts → index-DyJFTJLA.d.mts} +31 -92
  98. package/dist/index.d.mts +7 -9
  99. package/dist/index.mjs +12 -13
  100. package/dist/{init-CW3kJqNW.mjs → init-BOaNkLYb.mjs} +18 -35
  101. package/dist/{init-Cscs4lab.d.mts → init-CV2_Fw3H.d.mts} +0 -4
  102. package/dist/integrations/event-gateway.d.mts +3 -5
  103. package/dist/integrations/event-gateway.mjs +3 -4
  104. package/dist/integrations/index.d.mts +3 -3
  105. package/dist/integrations/index.mjs +1 -1
  106. package/dist/integrations/jobs/index.d.mts +1 -1
  107. package/dist/integrations/jobs/index.mjs +7 -11
  108. package/dist/integrations/mcp/index.d.mts +7 -39
  109. package/dist/integrations/mcp/index.mjs +8 -14
  110. package/dist/integrations/mcp/testing.d.mts +3 -5
  111. package/dist/integrations/mcp/testing.mjs +3 -4
  112. package/dist/integrations/streamline.d.mts +1 -3
  113. package/dist/integrations/streamline.mjs +4 -5
  114. package/dist/integrations/webhooks.d.mts +2 -4
  115. package/dist/integrations/webhooks.mjs +4 -5
  116. package/dist/integrations/websocket-pushref-redis.d.mts +2 -4
  117. package/dist/integrations/websocket-pushref-redis.mjs +2 -3
  118. package/dist/integrations/websocket-redis.d.mts +2 -4
  119. package/dist/integrations/websocket-redis.mjs +2 -3
  120. package/dist/integrations/websocket.d.mts +2 -2
  121. package/dist/integrations/websocket.mjs +13 -24
  122. package/dist/{interface-JJzwH4Ro.d.mts → interface-BmExzQRD.d.mts} +0 -2
  123. package/dist/{interface-BOk3YnTz.d.mts → interface-WR1U0K7t.d.mts} +0 -2
  124. package/dist/{jsonBody-DPU8yYwA.mjs → jsonBody-DpRpKR_K.mjs} +3 -4
  125. package/dist/{keys-Dgn6OYhl.mjs → keys-FBz6Ull-.mjs} +2 -3
  126. package/dist/{loadResources-BtKj6P1P.mjs → loadResources-Bx1sKPnF.mjs} +4 -5
  127. package/dist/{loadResourcesFromEntry-Bmq6TnB7.mjs → loadResourcesFromEntry-b_jcqbxh.mjs} +3 -4
  128. package/dist/logger/index.d.mts +1 -3
  129. package/dist/logger/index.mjs +2 -2
  130. package/dist/{logger-qQNLlOAU.mjs → logger-CbFcIEBZ.mjs} +3 -5
  131. package/dist/{mcpPlugin-DDfe8jAP.mjs → mcpPlugin-yix548XX.mjs} +41 -60
  132. package/dist/{memory-C0Blueoh.mjs → memory-Bgw5dn8N.mjs} +4 -5
  133. package/dist/{metrics-DYka72iN.mjs → metrics-CZDQWVjS.mjs} +4 -5
  134. package/dist/middleware/index.d.mts +1 -5
  135. package/dist/middleware/index.mjs +4 -5
  136. package/dist/migrations/index.d.mts +0 -2
  137. package/dist/migrations/index.mjs +3 -4
  138. package/dist/{module-BszSyWbd.mjs → module-Dsc_nKL5.mjs} +2 -3
  139. package/dist/{multiTenant-CAtYlW6H.d.mts → multiTenant-XCxAUlru.d.mts} +1 -5
  140. package/dist/{multipartBody-RHvIkNmc.mjs → multipartBody-B85ek8Kj.mjs} +2 -3
  141. package/dist/observeSend-BK-JN1jK.mjs +20 -0
  142. package/dist/{openapi-BrFPc3Ny.mjs → openapi-Co7hl073.mjs} +18 -28
  143. package/dist/outbox-admin/index.d.mts +2 -4
  144. package/dist/outbox-admin/index.mjs +6 -7
  145. package/dist/{outbox-module-gZCHoE4H.d.mts → outbox-module-XvUThpqn.d.mts} +2 -8
  146. package/dist/{outbox-module-DF4Bu_Qa.mjs → outbox-module-mg9kDYkd.mjs} +13 -17
  147. package/dist/permissions/index.d.mts +4 -4
  148. package/dist/permissions/index.mjs +7 -7
  149. package/dist/{permissions-DN1CWH56.mjs → permissions-A1oKtpiC.mjs} +19 -29
  150. package/dist/{pipe-B8uq865o.mjs → pipe-Czpw9U2n.mjs} +3 -4
  151. package/dist/pipeline/index.d.mts +1 -9
  152. package/dist/pipeline/index.mjs +5 -8
  153. package/dist/{plan-DUGfynNg.mjs → plan-KVseuBCL.mjs} +5 -9
  154. package/dist/{plugin-ByU3h-bR.mjs → plugin-DTWt_8C3.mjs} +130 -62
  155. package/dist/plugins/index.d.mts +8 -16
  156. package/dist/plugins/index.mjs +22 -26
  157. package/dist/plugins/response-cache.d.mts +2 -4
  158. package/dist/plugins/response-cache.mjs +10 -10
  159. package/dist/plugins/tracing-entry.d.mts +1 -1
  160. package/dist/plugins/tracing-entry.mjs +3 -4
  161. package/dist/{pluralize-Cdya8zYt.mjs → pluralize-msB9X3yw.mjs} +2 -3
  162. package/dist/presets/filesUpload.d.mts +4 -6
  163. package/dist/presets/filesUpload.mjs +6 -7
  164. package/dist/presets/index.d.mts +3 -19
  165. package/dist/presets/index.mjs +2 -2
  166. package/dist/presets/multiTenant.d.mts +1 -1
  167. package/dist/presets/multiTenant.mjs +7 -7
  168. package/dist/presets/search.d.mts +3 -5
  169. package/dist/presets/search.mjs +3 -4
  170. package/dist/{presets-CCOlKTZw.mjs → presets-qKCehiJM.mjs} +11 -18
  171. package/dist/{projection-BGty6ie4.mjs → projection-ClBqtsIw.mjs} +3 -4
  172. package/dist/{pushref-registry-UxCkoA4C.d.mts → pushref-registry-d86QUaSq.d.mts} +0 -6
  173. package/dist/{queryCachePlugin-B7itTkWu.mjs → queryCachePlugin-3gJj5Rbz.mjs} +8 -10
  174. package/dist/{queryCachePlugin-C2lZjTxk.d.mts → queryCachePlugin-DYQUyeJ9.d.mts} +2 -4
  175. package/dist/{rateLimitKey-DBWO59H9.mjs → rateLimitKey-Kro---xl.mjs} +2 -3
  176. package/dist/{realtime-_59Rlje8.mjs → realtime-Ber8uJN2.mjs} +17 -19
  177. package/dist/{redis-BDgv9Glw.d.mts → redis-RpDMemdm.d.mts} +2 -4
  178. package/dist/{redis-stream-BMk-bpQS.d.mts → redis-stream-CS1N9dwM.d.mts} +1 -3
  179. package/dist/{redisShapes-CQksY67q.d.mts → redisShapes-CqBXTn_s.d.mts} +0 -2
  180. package/dist/registry/index.d.mts +2 -12
  181. package/dist/registry/index.mjs +3 -3
  182. package/dist/{registry-uG4wr541.mjs → registry-BA-_vFYk.mjs} +7 -12
  183. package/dist/{renewingLease-CiU3ZynH.mjs → renewingLease-CMY8YOcc.mjs} +2 -3
  184. package/dist/{replyHelpers-Dr2pnXZg.mjs → replyHelpers-DK9P_XSz.mjs} +3 -4
  185. package/dist/{requestContext-DBKIdmDi.mjs → requestContext-GYO_0gEw.mjs} +2 -3
  186. package/dist/{requirement-CbiLdQ1n.d.mts → requirement-CTRQjjQx.d.mts} +0 -2
  187. package/dist/{requirement-DxOaghWD.mjs → requirement-DeNjZIH3.mjs} +2 -3
  188. package/dist/{resourceRateLimit-Wf6d6FL9.d.mts → resourceRateLimit-DCWglD7V.d.mts} +1 -3
  189. package/dist/{resourceRateLimit-BBdj5yRq.mjs → resourceRateLimit-tHLbrtWc.mjs} +3 -4
  190. package/dist/{rolldown-runtime-DpVPUeXF.mjs → rolldown-runtime-Kv1fZdLg.mjs} +2 -3
  191. package/dist/{routeValidator-BNTqM1Eh.mjs → routeValidator-C_H5NanI.mjs} +2 -3
  192. package/dist/{runtimeCapabilities-D_3eUO6V.mjs → runtimeCapabilities-DWqbxkyw.mjs} +2 -3
  193. package/dist/{schedules-CVS7c1nv.mjs → schedules-eO_RzhCU.mjs} +132 -9
  194. package/dist/{schemaConverter-BQbg7loK.mjs → schemaConverter-DBJrPZN4.mjs} +3 -4
  195. package/dist/{schemaIR-CUI3hPQR.mjs → schemaIR-CEScKT2v.mjs} +3 -4
  196. package/dist/schemas/index.d.mts +0 -2
  197. package/dist/schemas/index.mjs +2 -3
  198. package/dist/scim/index.d.mts +0 -12
  199. package/dist/scim/index.mjs +10 -18
  200. package/dist/scope/index.d.mts +2 -6
  201. package/dist/scope/index.mjs +5 -5
  202. package/dist/{scope-DFXngazv.mjs → scope-B-Sm9m_E.mjs} +5 -6
  203. package/dist/{sessionManager-qimlKV0P.d.mts → sessionManager-CdvDF04x.d.mts} +2 -4
  204. package/dist/{shutdown-BCXCwghd.mjs → shutdown-DzLFbe27.mjs} +2 -3
  205. package/dist/{simpleEqualityMatcher-5jOzYQ_L.mjs → simpleEqualityMatcher-DOJhwQ8g.mjs} +2 -3
  206. package/dist/{sse-BilBz766.mjs → sse-2972pVwV.mjs} +8 -9
  207. package/dist/{sseStream-BG_uJL6J.mjs → sseStream-AWLEeNV-.mjs} +3 -4
  208. package/dist/{storage-Cx9Sz3Ou.d.mts → storage-odC5MNKN.d.mts} +0 -2
  209. package/dist/{store-helpers-CzLZdVa1.mjs → store-helpers-VzjgVTkM.mjs} +2 -3
  210. package/dist/{streaming-DgUvMWlv.mjs → streaming-DvraWW6x.mjs} +2 -3
  211. package/dist/{subscriberIdentity-EWnIZ-U8.mjs → subscriberIdentity-Bya56jsg.mjs} +2 -3
  212. package/dist/{tenancy-CVMvO5DH.mjs → tenancy-DSa_0hhw.mjs} +3 -4
  213. package/dist/{tenantPreparation-DIH-GX4g.mjs → tenantPreparation-BrpkQre3.mjs} +5 -6
  214. package/dist/testing/cleanupStoreContract.d.mts +2 -4
  215. package/dist/testing/cleanupStoreContract.mjs +2 -3
  216. package/dist/testing/index.d.mts +6 -32
  217. package/dist/testing/index.mjs +24 -37
  218. package/dist/testing/outboxStoreContract.d.mts +1 -3
  219. package/dist/testing/outboxStoreContract.mjs +3 -4
  220. package/dist/testing/requiredPorts.d.mts +2 -4
  221. package/dist/testing/requiredPorts.mjs +3 -4
  222. package/dist/testing/storageContract.d.mts +2 -4
  223. package/dist/testing/storageContract.mjs +2 -3
  224. package/dist/{timing-q9NITK04.mjs → timing-6rQTuCwg.mjs} +3 -5
  225. package/dist/{tracing-Dro5eH6j.d.mts → tracing-JSFiBl5r.d.mts} +0 -2
  226. package/dist/{transactionContext-NHmhDIOF.mjs → transactionContext-DaxYUEgH.mjs} +2 -3
  227. package/dist/{typeGuards-CPYR9RCg.mjs → typeGuards-UKnX8wPX.mjs} +2 -3
  228. package/dist/types/index.d.mts +4 -4
  229. package/dist/types/index.mjs +1 -1
  230. package/dist/types/storage.d.mts +1 -1
  231. package/dist/types/storage.mjs +1 -1
  232. package/dist/{types-ByHn9rEO.d.mts → types-0Dqlbgn8.d.mts} +0 -2
  233. package/dist/{types-D3Ixsh00.d.mts → types-BYEb_dLW.d.mts} +2 -4
  234. package/dist/{types-BJ-2XqVF.d.mts → types-BeEJm-DV.d.mts} +114 -14
  235. package/dist/{types-DVLddu2q.d.mts → types-C0YJAiL0.d.mts} +0 -2
  236. package/dist/{types-BI4sbUJ3.mjs → types-CuGjhn83.mjs} +5 -6
  237. package/dist/{types-Ddl9OjmE.d.mts → types-DnkIALZ8.d.mts} +0 -4
  238. package/dist/usage/index.d.mts +2 -10
  239. package/dist/usage/index.mjs +8 -12
  240. package/dist/{userHelpers-oBTU3a_k.mjs → userHelpers-oX5_mOVs.mjs} +2 -3
  241. package/dist/utils/index.d.mts +5 -39
  242. package/dist/utils/index.mjs +12 -12
  243. package/dist/{utils-BmE8zRrh.mjs → utils-CjjGOT4E.mjs} +20 -30
  244. package/dist/{validate-Dby08LhR.mjs → validate-4RlTKOJb.mjs} +5 -7
  245. package/dist/{versioning-P6JMNcJr.mjs → versioning-Dk2-19La.mjs} +4 -5
  246. package/dist/{versioning-Bqm_57Qt.d.mts → versioning-S18y2-0C.d.mts} +1 -15
  247. package/dist/{websocket-Cs4awVyD.d.mts → websocket-BGuc-WVZ.d.mts} +1 -15
  248. package/dist/{workScope-BcMLKa3G.mjs → workScope-DoBsoVo4.mjs} +3 -4
  249. package/llms.txt +37 -30
  250. package/package.json +9 -8
  251. package/skills/arc/SKILL.md +65 -844
  252. package/skills/arc/references/agent-auth.md +82 -193
  253. package/skills/arc/references/api-reference.md +41 -245
  254. package/skills/arc/references/auth-api-keys.md +99 -0
  255. package/skills/arc/references/auth-better-auth-overlay.md +87 -0
  256. package/skills/arc/references/auth-better-auth.md +78 -0
  257. package/skills/arc/references/auth-permissions.md +100 -0
  258. package/skills/arc/references/auth-strategies.md +122 -0
  259. package/skills/arc/references/boot.md +80 -0
  260. package/skills/arc/references/enterprise-auth.md +65 -81
  261. package/skills/arc/references/events-outbox.md +90 -0
  262. package/skills/arc/references/events.md +75 -440
  263. package/skills/arc/references/integrations-jobs.md +74 -0
  264. package/skills/arc/references/integrations-realtime.md +84 -0
  265. package/skills/arc/references/integrations-webhooks.md +71 -0
  266. package/skills/arc/references/integrations-workflows.md +47 -0
  267. package/skills/arc/references/mcp-auth.md +83 -0
  268. package/skills/arc/references/mcp-custom-tools.md +125 -0
  269. package/skills/arc/references/mcp-setup.md +115 -0
  270. package/skills/arc/references/mcp-testing.md +63 -0
  271. package/skills/arc/references/multi-tenancy.md +56 -230
  272. package/skills/arc/references/permissions-scope.md +81 -0
  273. package/skills/arc/references/production-api.md +119 -0
  274. package/skills/arc/references/production-audit.md +101 -0
  275. package/skills/arc/references/production-boot.md +91 -0
  276. package/skills/arc/references/production-caching.md +63 -0
  277. package/skills/arc/references/production-distributed.md +75 -0
  278. package/skills/arc/references/production-idempotency.md +83 -0
  279. package/skills/arc/references/production-observability.md +83 -0
  280. package/skills/arc/references/production-realtime.md +70 -0
  281. package/skills/arc/references/production-reliability.md +100 -0
  282. package/skills/arc/references/production-shutdown.md +43 -0
  283. package/skills/arc/references/querying.md +76 -0
  284. package/skills/arc/references/resources.md +97 -0
  285. package/skills/arc/references/schedules.md +79 -0
  286. package/skills/arc/references/scim.md +61 -208
  287. package/skills/arc/references/tenancy-scope-install.md +82 -0
  288. package/skills/arc/references/testing.md +101 -144
  289. package/skills/arc/references/usage-cleanup-capabilities.md +45 -0
  290. package/skills/arc/references/validation.md +91 -0
  291. package/skills/arc/references/writes-hooks-errors.md +80 -0
  292. package/skills/arc-code-review/SKILL.md +67 -114
  293. package/skills/arc-code-review/references/arc-cheatsheet.md +68 -167
  294. package/skills/arc-code-review/references/mongokit-repositories.md +104 -0
  295. package/skills/arc-code-review/references/recipe-events-cache-jobs.md +112 -0
  296. package/skills/arc-code-review/references/recipe-resource.md +100 -0
  297. package/skills/arc-code-review/references/recipe-schemas-fields.md +93 -0
  298. package/skills/arc-code-review/references/recipe-scope-permissions.md +82 -0
  299. package/skills/arc-code-review/references/scaffolding.md +61 -198
  300. package/skills/arc-code-review/references/severity.md +49 -102
  301. package/skills/arc-code-review/references/smells-auth-scope.md +80 -0
  302. package/skills/arc-code-review/references/smells-data-events.md +66 -0
  303. package/skills/arc-code-review/references/smells-imports-style.md +59 -0
  304. package/skills/arc-code-review/references/smells-platform.md +89 -0
  305. package/skills/arc-code-review/references/smells-routes-schemas.md +66 -0
  306. package/skills/arc-module-publishing/SKILL.md +82 -208
  307. package/skills/arc-module-publishing/references/action-presets-and-plugins.md +87 -0
  308. package/skills/arc-module-publishing/references/build-and-types.md +73 -0
  309. package/skills/arc-module-publishing/references/module-lifecycle.md +101 -0
  310. package/skills/arc-module-publishing/references/package-manifest.md +34 -122
  311. package/skills/arc-module-publishing/references/publishing-workflow.md +44 -140
  312. package/skills/arc-module-publishing/references/resource-assembly.md +102 -0
  313. package/skills/arc-module-publishing/references/testing-packages.md +82 -0
  314. package/skills/arc/references/auth.md +0 -729
  315. package/skills/arc/references/integrations.md +0 -452
  316. package/skills/arc/references/mcp.md +0 -691
  317. package/skills/arc/references/production.md +0 -835
  318. package/skills/arc-code-review/references/anti-patterns.md +0 -1008
  319. package/skills/arc-code-review/references/migration-recipes.md +0 -649
  320. package/skills/arc-code-review/references/mongokit-migration.md +0 -360
  321. package/skills/arc-module-publishing/references/authoring-modules.md +0 -327
@@ -0,0 +1,112 @@
1
+ # Recipe: events, cache, schedules, idempotency, MCP
2
+
3
+ ## Events
4
+
5
+ Before: `await eventBus.emit("order.created", ...)` in POST, forgotten in PATCH.
6
+ After: nothing. Arc emits `order.created`, `order.updated`, `order.deleted` after every CRUD write (`arcPlugins.emitEvents` defaults on). Subscribe through module `eventHandlers` or `fastify.events`. Types: `@classytic/primitives/events`. At-least-once delivery: `EventOutbox` and `createOutboxModule` from `@classytic/arc/events` with an outbox store (`repositoryAsOutboxStore`); verify a store with `runOutboxStoreContract` from `@classytic/arc/testing/outbox`. Use `RedisStreamTransport` from `@classytic/arc/events/redis-stream` for a durable transport with consumer groups.
7
+
8
+ ## Cache
9
+
10
+ Before: `redis.get("products-list")`, `redis.del("products-list")` after writes.
11
+ After:
12
+
13
+ ```ts
14
+ const app = await createApp({
15
+ arcPlugins: { queryCache: true },
16
+ stores: { queryCache: new RedisCacheStore({ client }) },
17
+ resources: [productResource],
18
+ });
19
+
20
+ defineResource({
21
+ name: "product",
22
+ adapter,
23
+ cache: { staleTime: 30, gcTime: 300, tags: ["catalog"], invalidateOn: { "category.*": ["catalog"] } },
24
+ });
25
+ ```
26
+
27
+ Writes bump the resource version; the next read sees fresh data. `RedisCacheStore` is from `@classytic/arc/cache`; omit `stores.queryCache` for the in-memory default.
28
+
29
+ ## Recurring jobs
30
+
31
+ Interval job with multi-replica safety:
32
+
33
+ ```ts
34
+ import { schedulesPlugin } from "@classytic/arc/plugins";
35
+ import { createMongoLockAdapter } from "@classytic/mongokit/lock";
36
+
37
+ await app.register(schedulesPlugin, {
38
+ lock: createMongoLockAdapter({ connection }),
39
+ schedules: [{ name: "outbox-sweep", every: 30_000, jitterMs: 5_000, handler: async (f) => sweep(f) }],
40
+ });
41
+ ```
42
+
43
+ Once per local day (replaces timers plus marker rows):
44
+
45
+ ```ts
46
+ schedules: [{
47
+ name: "daily-digest",
48
+ every: 60_000,
49
+ daily: { hour: 8, minute: 30, zone: "Asia/Dhaka", ledger: dailyLedger },
50
+ handler: async (f, ctx) => sendDigest(f, ctx?.day), // ctx.day is YYYY-MM-DD in that zone
51
+ }],
52
+ ```
53
+
54
+ The host implements `DailyLedger` once, in a repository file. `claimDay` must be atomic across replicas: a unique index on `(key, civilDate)`, losing insert returns `false`.
55
+
56
+ ```ts
57
+ import type { DailyLedger } from "@classytic/arc/plugins";
58
+ import { isDuplicateKeyError } from "@classytic/mongokit";
59
+
60
+ export const dailyLedger: DailyLedger = {
61
+ async claimDay(key, civilDate) {
62
+ try {
63
+ await LedgerModel.create({ key, civilDate });
64
+ return true;
65
+ } catch (err) {
66
+ if (isDuplicateKeyError(err)) return false;
67
+ throw err;
68
+ }
69
+ },
70
+ async releaseDay(key, civilDate) {
71
+ await LedgerModel.deleteOne({ key, civilDate });
72
+ },
73
+ };
74
+ ```
75
+
76
+ Tests use `createMemoryDailyLedger()` and an injected `clock`. Optional knobs: `catchUpWindowMs`, `staleAfterMs`, `completeDay`. A module ships its jobs as `scheduledJobs`; locking is configured in `arcPlugins.schedules`. Calendar cron expressions and durable retries stay in `jobsPlugin` from `@classytic/arc/integrations/jobs`.
77
+
78
+ ## Idempotency
79
+
80
+ Before: `Idempotency.findOne({ key })` inside the handler.
81
+ After:
82
+
83
+ ```ts
84
+ import { idempotencyPlugin } from "@classytic/arc/idempotency";
85
+
86
+ await app.register(idempotencyPlugin, { repository: idempotencyRepo, ttlMs: 24 * 3600_000 });
87
+ defineResource({ name: "payment", adapter, idempotency: { required: ["create"] } });
88
+ ```
89
+
90
+ A keyless create then answers 400 `arc.idempotency_key_required`, a keyed retry replays the stored response. The repository needs `getOne`, `deleteMany`, `findOneAndUpdate`; mongokit's `createIdempotencyStore` (`@classytic/mongokit/idempotency`) provides a ready store.
91
+
92
+ ## MCP
93
+
94
+ Before: 200 lines of `setRequestHandler(CallToolRequestSchema, ...)`.
95
+ After:
96
+
97
+ ```ts
98
+ import { mcpPlugin } from "@classytic/arc/mcp";
99
+
100
+ await app.register(mcpPlugin, { resources: [productResource, orderResource], auth: false });
101
+ ```
102
+
103
+ CRUD, custom routes and actions become tools; permissions and field rules carry over. `mcp: false` on a resource opts it out.
104
+
105
+ ## Tests
106
+
107
+ Before: hand-started `MongoMemoryServer`, hand-built auth headers.
108
+ After: `createTestApp` and `expectArc` from `@classytic/arc/testing`; `createHttpTestHarness(resource)` generates CRUD, permission and validation tests; module packages use `bootModuleApp`.
109
+
110
+ ```ts
111
+ const ctx = await createTestApp({ resources: [productResource], authMode: "jwt", connectMongoose: true });
112
+ ```
@@ -0,0 +1,100 @@
1
+ # Recipe: hand-rolled CRUD to `defineResource`
2
+
3
+ ## Before (about 170 lines per entity)
4
+
5
+ ```ts
6
+ fastify.get("/products", async (req) => {
7
+ const page = Math.max(1, Number(req.query.page) || 1);
8
+ const filters: any = {};
9
+ if (req.query.status) filters.status = req.query.status;
10
+ if (req.user) filters.organizationId = req.user.orgId;
11
+ const items = await Product.find(filters).skip((page - 1) * 20).limit(20).lean();
12
+ return { items, total: await Product.countDocuments(filters), page };
13
+ });
14
+ fastify.post("/products", async (req, reply) => {
15
+ if (!req.user?.roles.includes("admin")) throw fastify.httpErrors.forbidden();
16
+ const data = createBody.parse(req.body);
17
+ const item = await Product.create({ ...data, organizationId: req.user.orgId });
18
+ await fastify.events.emit("product.created", { id: item._id });
19
+ return reply.code(201).send(item);
20
+ });
21
+ // plus GET /:id, PATCH /:id, DELETE /:id with the same glue
22
+ ```
23
+
24
+ ## After (about 30 lines)
25
+
26
+ ```ts
27
+ import { defineResource, allowPublic, requireRoles } from "@classytic/arc";
28
+ import { crudInput } from "@classytic/arc/core";
29
+ import { createMongooseAdapter } from "@classytic/mongokit/adapter";
30
+ import { createRepository } from "@classytic/mongokit";
31
+ import { z } from "zod";
32
+ import { Product } from "./product.model.js";
33
+
34
+ const productRepo = createRepository(Product, { softDelete: true, timestamps: true });
35
+
36
+ const create = z.strictObject({
37
+ name: z.string().trim().min(1),
38
+ price: z.number().min(0),
39
+ status: z.enum(["draft", "active", "archived"]).default("draft"),
40
+ });
41
+
42
+ export const productResource = defineResource({
43
+ name: "product",
44
+ adapter: createMongooseAdapter(Product, productRepo),
45
+ presets: ["softDelete", { name: "multiTenant", tenantField: "organizationId" }],
46
+ permissions: {
47
+ list: allowPublic(),
48
+ get: allowPublic(),
49
+ create: requireRoles(["admin"]),
50
+ update: requireRoles(["admin"]),
51
+ delete: requireRoles(["admin"]),
52
+ },
53
+ ...crudInput({ create, update: create.partial(), parse: true }),
54
+ schemaOptions: { fieldRules: { organizationId: { systemManaged: true } } },
55
+ });
56
+ ```
57
+
58
+ ```ts
59
+ import { createApp } from "@classytic/arc/factory";
60
+
61
+ const app = await createApp({
62
+ auth: { type: "jwt", jwt: { secret: process.env.JWT_SECRET! } },
63
+ resources: [productResource],
64
+ });
65
+ ```
66
+
67
+ What arc now owns: five routes, filters, sort, pagination, tenant scoping, role checks, 400/403/404 error contract, `product.created|updated|deleted` events, OpenAPI and MCP derivation from the same declaration.
68
+
69
+ ## Presets in one place
70
+
71
+ | Hand-rolled | Preset | Notes |
72
+ |---|---|---|
73
+ | `/deleted`, restore handler, `deletedAt` filter | `"softDelete"` | adds `GET /deleted`, `POST /:id/restore`; repo filters via `softDelete: true` |
74
+ | `GET /slug/:slug` | `{ name: "slugLookup", slugField: "slug" }` | |
75
+ | children and tree routes | `"tree"` | |
76
+ | `bulkCreate`, `bulkUpdate`, `bulkDelete` | `"bulk"` | |
77
+ | tenant filter on every query | `{ name: "multiTenant", tenantField }` | or `tenantFields` for several levels |
78
+ | owner filter on every query | `{ name: "ownedByUser", ownerField: "authorId" }` | |
79
+ | manual audit writes | `"audited"` | or `audit: true` |
80
+
81
+ ## Slim custom controller
82
+
83
+ Prefer none. To compose preset behavior in a class instead of rewriting methods:
84
+
85
+ ```ts
86
+ import { BaseCrudController, BulkMixin, SoftDeleteMixin } from "@classytic/arc";
87
+
88
+ class OrderController extends SoftDeleteMixin(BulkMixin(BaseCrudController)) {}
89
+ ```
90
+
91
+ Pass `tenantField` and `idField` to `super(...)` and mirror them on `defineResource`. A domain verb that must keep arc's sanitize, tenant and hook pipeline belongs in `actions` or `writes`, not a controller override.
92
+
93
+ ## Rollout order for a large project
94
+
95
+ 1. Auth and scope accessors first: they unlock declarative permissions.
96
+ 2. Adapters and repositories before resources.
97
+ 3. Convert one thin resource end to end, then the rest; fold presets into the resource that needs them.
98
+ 4. Keep old routes alongside new ones behind a path prefix for one release; cut over after consumers confirm.
99
+ 5. Run `arc docs` and diff against the hand-kept spec.
100
+ 6. Delete the old code when the sweep shows zero R1, A1, A2 hits.
@@ -0,0 +1,93 @@
1
+ # Recipe: schemas, parsing, fields, errors
2
+
3
+ ## One zod v4 declaration, three consumers
4
+
5
+ AJV validates what JSON Schema can express, a preHandler runs the same schema and replaces `body`, `query`, `params` with the parsed value (trim, defaults, refine apply), and OpenAPI plus MCP derive from the declaration. A failed parse is a 400 `arc.validation_error` with field `details`.
6
+
7
+ ### Custom route
8
+
9
+ ```ts
10
+ import { parsed, routeInput } from "@classytic/arc/core";
11
+ import { z } from "zod";
12
+
13
+ const body = z.object({ title: z.string().trim().min(2), tags: z.array(z.string()).default([]) });
14
+ const query = z.object({ limit: z.coerce.number().int().min(1).default(10) });
15
+
16
+ routes: [{
17
+ method: "POST",
18
+ path: "/echo",
19
+ permissions: allowPublic(),
20
+ ...routeInput({ body, querystring: query, response: { 200: z.object({ title: z.string() }) } }),
21
+ rawHandler: async (req, reply) => reply.send({ title: parsed(body, req.body).title }),
22
+ }],
23
+ ```
24
+
25
+ Smell removed: `body.parse(req.body)` at the top of each handler. A plain JSON Schema in a slot is validated by AJV only.
26
+
27
+ ### CRUD writes
28
+
29
+ ```ts
30
+ const create = z.strictObject({ name: z.string().trim().min(1), rank: z.number().default(1) });
31
+ defineResource({ name: "gadget", adapter, ...crudInput({ create, update: create.partial(), parse: true }) });
32
+ ```
33
+
34
+ `crudInput` returns `customSchemas`, `openApiSchemas` and, with `parse: true`, create and update middlewares. It also writes `middlewares`: merge your own with `middlewares: { create: [...mine, ...crud.middlewares.create] }`. A `.default()` field stays optional on the wire. `z.strictObject` refuses unknown keys.
35
+
36
+ ### Actions
37
+
38
+ ```ts
39
+ import { defineAction, noPayloadSchema } from "@classytic/arc/core";
40
+
41
+ actions: {
42
+ close: defineAction({
43
+ schema: z.object({ note: z.string().trim().min(2), urgent: z.boolean().default(false) }),
44
+ parse: true,
45
+ permissions: requireRoles(["admin"]),
46
+ handler: async (id, data, req) => svc.close(id, data.note), // data is the parsed output
47
+ }),
48
+ archive: defineAction({ schema: noPayloadSchema, permissions: requireRoles(["admin"]), handler: async (id) => svc.archive(id) }),
49
+ },
50
+ // POST /tickets/:id/action { "action": "close", "note": "done" }
51
+ ```
52
+
53
+ The action `schema` IS the body schema. `schema: { body: X }` has no `type` or `properties`, validates nothing and logs `schema.slot_wrapper`; with `strictSchemas: true` on the resource it fails at define time. Without `parse: true` the handler sees what AJV accepted, untouched.
54
+
55
+ ## Hide and gate fields
56
+
57
+ ```ts
58
+ import { defineResource, fields } from "@classytic/arc";
59
+
60
+ defineResource({
61
+ name: "user",
62
+ adapter,
63
+ schemaOptions: { fieldRules: { password: { hidden: true }, mfaSecret: { hidden: true }, organizationId: { systemManaged: true } } },
64
+ fields: {
65
+ salary: fields.visibleTo(["admin", "hr"]),
66
+ email: fields.redactFor(["viewer"], "***"),
67
+ role: fields.writableBy(["admin"]),
68
+ },
69
+ });
70
+ ```
71
+
72
+ `hidden` applies at serialization for REST and MCP and works with lean reads. `onFieldWriteDenied` defaults to `"reject"` (403 with the denied list); leave it for sensitive resources. Other `fieldRules` flags: `immutable`, `immutableAfterCreate`, `optional`, `nullable`, `preserveForElevated`, `minLength`, `maxLength`, `min`, `max`, `pattern`, `enum`, `description`.
73
+
74
+ ## Errors
75
+
76
+ ```ts
77
+ import { createDomainError, defineErrorMapper, NotFoundError } from "@classytic/arc/utils";
78
+
79
+ throw new NotFoundError("order"); // 404
80
+ throw createDomainError("order.already_paid", "Order already paid", 409);
81
+
82
+ createApp({
83
+ errorHandler: {
84
+ errorMappers: [defineErrorMapper({ type: BillingError, toResponse: (e) => ({ status: e.status, code: e.code, message: e.message }) })],
85
+ },
86
+ });
87
+ ```
88
+
89
+ Unknown routes answer the ErrorContract 404 `arc.not_found` by default. Delete custom `setNotFoundHandler`; to change it set `errorHandler: { notFound: fn }`, to own it `notFound: false`.
90
+
91
+ ## Unified list responses
92
+
93
+ `reply.sendList()` (via `replyHelpersPlugin`) wraps repo-core's `toCanonicalList`; types come from `@classytic/repo-core/pagination`. Do not hand-build `{ items, total, pages }`.
@@ -0,0 +1,82 @@
1
+ # Recipe: permissions, scope, tenancy
2
+
3
+ ## Inline checks to declarative permissions
4
+
5
+ Before:
6
+
7
+ ```ts
8
+ fastify.patch("/posts/:id", async (req) => {
9
+ if (!req.user) throw fastify.httpErrors.unauthorized();
10
+ const post = await Post.findById(req.params.id);
11
+ const isAuthor = post.authorId.toString() === req.user.id;
12
+ if (!isAuthor && !req.user.roles?.includes("admin")) throw fastify.httpErrors.forbidden();
13
+ });
14
+ ```
15
+
16
+ After:
17
+
18
+ ```ts
19
+ import { anyOf, defineResource, requireOwnership, requireRoles } from "@classytic/arc";
20
+
21
+ defineResource({
22
+ name: "post",
23
+ adapter,
24
+ permissions: {
25
+ update: anyOf(requireRoles(["admin"]), requireOwnership("authorId")),
26
+ delete: requireRoles(["admin"]),
27
+ },
28
+ });
29
+ ```
30
+
31
+ `requireOwnership` grants with a data policy `{ authorId: userId }`, so the repository query is scoped to the caller's rows; admins pass without it. A permission returns `boolean` or a decision with `filters`/`scope`; combinators: `allOf`, `anyOf`, `not`, `when`, `denyAll`.
32
+
33
+ | Need | Check |
34
+ |---|---|
35
+ | any signed-in user | `requireAuth()` |
36
+ | org member | `requireOrgMembership()` |
37
+ | org role | `requireOrgRole("admin")` |
38
+ | team member | `requireTeamMembership()` |
39
+ | service token with scope | `requireServiceScope("jobs:bulk-write")` |
40
+ | scope context value | `requireScopeContext("branchId")` |
41
+ | target org inside caller's hierarchy | `requireOrgInScope(targetId)` |
42
+ | same gate on all CRUD keys | `permissionMatrix({ read, write, delete? })` |
43
+ | role by resource by action table | `createDynamicPermissionMatrix` |
44
+ | common shapes | `permissions.publicReadAdminWrite()`, `publicRead`, `adminOnly`, `readOnly` |
45
+
46
+ ## Scope accessors instead of `req.user`
47
+
48
+ Before:
49
+
50
+ ```ts
51
+ const userId = req.user._id;
52
+ const orgId = req.user.orgId;
53
+ ```
54
+
55
+ After:
56
+
57
+ ```ts
58
+ import { getUserId, getOrgId, requireOrgId, isAuthenticated } from "@classytic/arc/scope";
59
+
60
+ if (!isAuthenticated(req.scope)) return reply.code(401).send();
61
+ const orgId = requireOrgId(req.scope, "create-order");
62
+ const userId = getUserId(req.scope);
63
+ ```
64
+
65
+ `RequestScope` kinds: `public`, `authenticated`, `member`, `service`, `elevated`. Read `organizationId` through `getOrgId`, never from the scope object. In a hook, `ctx.scope` carries `organizationId`, `userId`, `orgRoles`.
66
+
67
+ ## Tenancy
68
+
69
+ | Case | Setting |
70
+ |---|---|
71
+ | normal tenant table | default `tenantField: "organizationId"` or `{ name: "multiTenant", tenantField }` |
72
+ | company-wide lookup table | `tenantField: false` |
73
+ | different scope key | `tenantField: "workspaceId"` |
74
+ | branch and project levels | `multiTenantPreset({ tenantFields: [{ field: "organizationId", type: "org" }, { field: "branchId", contextKey: "branchId" }] })` |
75
+
76
+ Scope tenancy at one layer. The `multiTenant` preset is the HTTP boundary; add the repository `tenant` option as defence in depth when jobs or CLIs share the repository. Populate `scope.context` and `ancestorOrgIds` in the auth function for multi-level tenancy; see the arc skill, references on multi-tenancy.
77
+
78
+ A preset tenant filter overwrites a body `organizationId` on update, which closes tenant-hopping. Never accept the tenant key from the client body or an `x-organization-id` header as a permission.
79
+
80
+ ## Platform admin
81
+
82
+ `createApp({ elevation: { platformRoles: ["superadmin"], onElevation } })`: a superadmin sends `x-arc-scope: platform` to elevate; without the header they are a normal user. Handlers check `isElevated(scope)`.