@decaf-ts/as-graph 0.7.0 → 0.8.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 (383) hide show
  1. package/README.md +92 -12
  2. package/assets/i18n/en.json +1519 -130
  3. package/dist/as-graph.cjs +1 -1
  4. package/dist/as-graph.cjs.map +1 -1
  5. package/dist/as-graph.js +1 -1
  6. package/dist/as-graph.js.map +1 -1
  7. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs +13 -0
  8. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs.map +1 -1
  9. package/lib/cjs/dagster/capabilities.cjs +5 -0
  10. package/lib/cjs/dagster/capabilities.cjs.map +1 -1
  11. package/lib/cjs/engine/execution/GraphCodeMode.cjs +42 -0
  12. package/lib/cjs/engine/execution/GraphCodeMode.cjs.map +1 -1
  13. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +35 -4
  14. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
  15. package/lib/cjs/engine/validation/GraphNodeInstanceValidator.cjs +29 -1
  16. package/lib/cjs/engine/validation/GraphNodeInstanceValidator.cjs.map +1 -1
  17. package/lib/cjs/engine/validation/GraphWorkflowDocumentValidator.cjs +6 -2
  18. package/lib/cjs/engine/validation/GraphWorkflowDocumentValidator.cjs.map +1 -1
  19. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +41 -9
  20. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -1
  21. package/lib/cjs/nest/graph/GraphEngineController.cjs +18 -0
  22. package/lib/cjs/nest/graph/GraphEngineController.cjs.map +1 -1
  23. package/lib/cjs/nest/graph/GraphNodeCatalogueController.cjs +14 -0
  24. package/lib/cjs/nest/graph/GraphNodeCatalogueController.cjs.map +1 -1
  25. package/lib/cjs/nest/graph/GraphRunController.cjs +17 -0
  26. package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
  27. package/lib/cjs/nest/graph/GraphWorkflowController.cjs +34 -5
  28. package/lib/cjs/nest/graph/GraphWorkflowController.cjs.map +1 -1
  29. package/lib/cjs/node/comms/discord/node.cjs +384 -0
  30. package/lib/cjs/node/comms/discord/node.cjs.map +1 -0
  31. package/lib/cjs/node/comms/outlook/node.cjs +395 -0
  32. package/lib/cjs/node/comms/outlook/node.cjs.map +1 -0
  33. package/lib/cjs/node/comms/whatsapp/node.cjs +341 -0
  34. package/lib/cjs/node/comms/whatsapp/node.cjs.map +1 -0
  35. package/lib/cjs/node/data/aggregate/node.cjs +196 -0
  36. package/lib/cjs/node/data/aggregate/node.cjs.map +1 -0
  37. package/lib/cjs/node/data/compare-datasets/node.cjs +331 -0
  38. package/lib/cjs/node/data/compare-datasets/node.cjs.map +1 -0
  39. package/lib/cjs/node/data/item-lists/node.cjs +416 -0
  40. package/lib/cjs/node/data/item-lists/node.cjs.map +1 -0
  41. package/lib/cjs/node/data/remove-duplicates/node.cjs +141 -0
  42. package/lib/cjs/node/data/remove-duplicates/node.cjs.map +1 -0
  43. package/lib/cjs/node/data/summarize/node.cjs +155 -0
  44. package/lib/cjs/node/data/summarize/node.cjs.map +1 -0
  45. package/lib/cjs/node/data/support.cjs +5 -0
  46. package/lib/cjs/node/data/support.cjs.map +1 -1
  47. package/lib/cjs/node/data/transform-utils.cjs +719 -0
  48. package/lib/cjs/node/data/transform-utils.cjs.map +1 -0
  49. package/lib/cjs/node/index.cjs +216 -110
  50. package/lib/cjs/node/index.cjs.map +1 -1
  51. package/lib/cjs/node/io/confluence/node.cjs +253 -0
  52. package/lib/cjs/node/io/confluence/node.cjs.map +1 -0
  53. package/lib/cjs/node/io/convert-to-file/node.cjs +349 -0
  54. package/lib/cjs/node/io/convert-to-file/node.cjs.map +1 -0
  55. package/lib/cjs/node/io/file-support.cjs +311 -0
  56. package/lib/cjs/node/io/file-support.cjs.map +1 -0
  57. package/lib/cjs/node/io/google-calendar/node.cjs +359 -0
  58. package/lib/cjs/node/io/google-calendar/node.cjs.map +1 -0
  59. package/lib/cjs/node/io/google-docs/node.cjs +272 -0
  60. package/lib/cjs/node/io/google-docs/node.cjs.map +1 -0
  61. package/lib/cjs/node/io/html/node.cjs +275 -0
  62. package/lib/cjs/node/io/html/node.cjs.map +1 -0
  63. package/lib/cjs/node/io/html-extract/node.cjs +162 -0
  64. package/lib/cjs/node/io/html-extract/node.cjs.map +1 -0
  65. package/lib/cjs/node/io/html-support.cjs +246 -0
  66. package/lib/cjs/node/io/html-support.cjs.map +1 -0
  67. package/lib/cjs/node/io/jira/node.cjs +351 -0
  68. package/lib/cjs/node/io/jira/node.cjs.map +1 -0
  69. package/lib/cjs/node/io/markdown/node.cjs +229 -0
  70. package/lib/cjs/node/io/markdown/node.cjs.map +1 -0
  71. package/lib/cjs/node/io/microsoft-excel/node.cjs +261 -0
  72. package/lib/cjs/node/io/microsoft-excel/node.cjs.map +1 -0
  73. package/lib/cjs/node/io/microsoft-sharepoint/node.cjs +274 -0
  74. package/lib/cjs/node/io/microsoft-sharepoint/node.cjs.map +1 -0
  75. package/lib/cjs/node/io/read-binary-file/node.cjs +114 -0
  76. package/lib/cjs/node/io/read-binary-file/node.cjs.map +1 -0
  77. package/lib/cjs/node/io/read-binary-files/node.cjs +113 -0
  78. package/lib/cjs/node/io/read-binary-files/node.cjs.map +1 -0
  79. package/lib/cjs/node/io/write-binary-file/node.cjs +164 -0
  80. package/lib/cjs/node/io/write-binary-file/node.cjs.map +1 -0
  81. package/lib/cjs/node/io/xml/node.cjs +322 -0
  82. package/lib/cjs/node/io/xml/node.cjs.map +1 -0
  83. package/lib/cjs/node/manifests.cjs +137 -79
  84. package/lib/cjs/node/manifests.cjs.map +1 -1
  85. package/lib/cjs/node/storage/rabbitmq/node.cjs +252 -0
  86. package/lib/cjs/node/storage/rabbitmq/node.cjs.map +1 -0
  87. package/lib/cjs/node/triggers/error/node.cjs +108 -0
  88. package/lib/cjs/node/triggers/error/node.cjs.map +1 -0
  89. package/lib/cjs/node/triggers/postgres/node.cjs +244 -0
  90. package/lib/cjs/node/triggers/postgres/node.cjs.map +1 -0
  91. package/lib/cjs/node/triggers/rabbitmq/node.cjs +284 -0
  92. package/lib/cjs/node/triggers/rabbitmq/node.cjs.map +1 -0
  93. package/lib/cjs/node/triggers/redis/node.cjs +233 -0
  94. package/lib/cjs/node/triggers/redis/node.cjs.map +1 -0
  95. package/lib/cjs/node/triggers/sse/node.cjs +196 -0
  96. package/lib/cjs/node/triggers/sse/node.cjs.map +1 -0
  97. package/lib/cjs/node/triggers/support.cjs +107 -0
  98. package/lib/cjs/node/triggers/support.cjs.map +1 -0
  99. package/lib/cjs/node/triggers/workflow/node.cjs +193 -0
  100. package/lib/cjs/node/triggers/workflow/node.cjs.map +1 -0
  101. package/lib/cjs/shared/graph/catalog/GraphValueSchemaDerivation.cjs +20 -3
  102. package/lib/cjs/shared/graph/catalog/GraphValueSchemaDerivation.cjs.map +1 -1
  103. package/lib/cjs/workflows/boundary-value.workflow.cjs +38 -0
  104. package/lib/cjs/workflows/boundary-value.workflow.cjs.map +1 -0
  105. package/lib/cjs/workflows/builders.cjs +47 -0
  106. package/lib/cjs/workflows/builders.cjs.map +1 -0
  107. package/lib/cjs/workflows/chat-agent.workflow.cjs +40 -0
  108. package/lib/cjs/workflows/chat-agent.workflow.cjs.map +1 -0
  109. package/lib/cjs/workflows/error-boundary.workflow.cjs +54 -0
  110. package/lib/cjs/workflows/error-boundary.workflow.cjs.map +1 -0
  111. package/lib/cjs/workflows/event-map.workflow.cjs +37 -0
  112. package/lib/cjs/workflows/event-map.workflow.cjs.map +1 -0
  113. package/lib/cjs/workflows/foreach-break.workflow.cjs +58 -0
  114. package/lib/cjs/workflows/foreach-break.workflow.cjs.map +1 -0
  115. package/lib/cjs/workflows/human-approval.workflow.cjs +44 -0
  116. package/lib/cjs/workflows/human-approval.workflow.cjs.map +1 -0
  117. package/lib/cjs/workflows/if-switch.workflow.cjs +66 -0
  118. package/lib/cjs/workflows/if-switch.workflow.cjs.map +1 -0
  119. package/lib/cjs/workflows/index.cjs +135 -0
  120. package/lib/cjs/workflows/index.cjs.map +1 -0
  121. package/lib/cjs/workflows/loops-while-until.workflow.cjs +76 -0
  122. package/lib/cjs/workflows/loops-while-until.workflow.cjs.map +1 -0
  123. package/lib/cjs/workflows/manual-log.workflow.cjs +52 -0
  124. package/lib/cjs/workflows/manual-log.workflow.cjs.map +1 -0
  125. package/lib/cjs/workflows/schedule-code.workflow.cjs +42 -0
  126. package/lib/cjs/workflows/schedule-code.workflow.cjs.map +1 -0
  127. package/lib/cjs/workflows/types.cjs +4 -0
  128. package/lib/cjs/workflows/types.cjs.map +1 -0
  129. package/lib/cjs/workflows/value-templates.workflow.cjs +43 -0
  130. package/lib/cjs/workflows/value-templates.workflow.cjs.map +1 -0
  131. package/lib/cjs/workflows/webhook-form.workflow.cjs +48 -0
  132. package/lib/cjs/workflows/webhook-form.workflow.cjs.map +1 -0
  133. package/lib/esm/dagster/DagsterGraphExecutionBackend.js +13 -0
  134. package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -1
  135. package/lib/esm/dagster/capabilities.js +5 -0
  136. package/lib/esm/dagster/capabilities.js.map +1 -1
  137. package/lib/esm/engine/execution/GraphCodeMode.js +40 -0
  138. package/lib/esm/engine/execution/GraphCodeMode.js.map +1 -1
  139. package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -1
  140. package/lib/esm/engine/execution/GraphExecutionEngine.js +36 -5
  141. package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
  142. package/lib/esm/engine/validation/GraphNodeInstanceValidator.js +29 -1
  143. package/lib/esm/engine/validation/GraphNodeInstanceValidator.js.map +1 -1
  144. package/lib/esm/engine/validation/GraphWorkflowDocumentValidator.js +6 -2
  145. package/lib/esm/engine/validation/GraphWorkflowDocumentValidator.js.map +1 -1
  146. package/lib/esm/mastra/MastraMemory.js.map +1 -1
  147. package/lib/esm/mastra/MastraWorkflowCompiler.js +41 -9
  148. package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -1
  149. package/lib/esm/nest/graph/GraphEngineController.js +19 -1
  150. package/lib/esm/nest/graph/GraphEngineController.js.map +1 -1
  151. package/lib/esm/nest/graph/GraphNodeCatalogueController.js +15 -1
  152. package/lib/esm/nest/graph/GraphNodeCatalogueController.js.map +1 -1
  153. package/lib/esm/nest/graph/GraphRunController.js +18 -1
  154. package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
  155. package/lib/esm/nest/graph/GraphWorkflowController.js +35 -6
  156. package/lib/esm/nest/graph/GraphWorkflowController.js.map +1 -1
  157. package/lib/esm/node/comms/discord/node.js +375 -0
  158. package/lib/esm/node/comms/discord/node.js.map +1 -0
  159. package/lib/esm/node/comms/outlook/node.js +386 -0
  160. package/lib/esm/node/comms/outlook/node.js.map +1 -0
  161. package/lib/esm/node/comms/whatsapp/node.js +332 -0
  162. package/lib/esm/node/comms/whatsapp/node.js.map +1 -0
  163. package/lib/esm/node/data/aggregate/node.js +187 -0
  164. package/lib/esm/node/data/aggregate/node.js.map +1 -0
  165. package/lib/esm/node/data/compare-datasets/node.js +322 -0
  166. package/lib/esm/node/data/compare-datasets/node.js.map +1 -0
  167. package/lib/esm/node/data/item-lists/node.js +407 -0
  168. package/lib/esm/node/data/item-lists/node.js.map +1 -0
  169. package/lib/esm/node/data/remove-duplicates/node.js +132 -0
  170. package/lib/esm/node/data/remove-duplicates/node.js.map +1 -0
  171. package/lib/esm/node/data/summarize/node.js +146 -0
  172. package/lib/esm/node/data/summarize/node.js.map +1 -0
  173. package/lib/esm/node/data/support.js +5 -1
  174. package/lib/esm/node/data/support.js.map +1 -1
  175. package/lib/esm/node/data/transform-utils.js +702 -0
  176. package/lib/esm/node/data/transform-utils.js.map +1 -0
  177. package/lib/esm/node/index.js +110 -4
  178. package/lib/esm/node/index.js.map +1 -1
  179. package/lib/esm/node/io/confluence/node.js +244 -0
  180. package/lib/esm/node/io/confluence/node.js.map +1 -0
  181. package/lib/esm/node/io/convert-to-file/node.js +340 -0
  182. package/lib/esm/node/io/convert-to-file/node.js.map +1 -0
  183. package/lib/esm/node/io/file-support.js +299 -0
  184. package/lib/esm/node/io/file-support.js.map +1 -0
  185. package/lib/esm/node/io/google-calendar/node.js +350 -0
  186. package/lib/esm/node/io/google-calendar/node.js.map +1 -0
  187. package/lib/esm/node/io/google-docs/node.js +263 -0
  188. package/lib/esm/node/io/google-docs/node.js.map +1 -0
  189. package/lib/esm/node/io/html/node.js +266 -0
  190. package/lib/esm/node/io/html/node.js.map +1 -0
  191. package/lib/esm/node/io/html-extract/node.js +153 -0
  192. package/lib/esm/node/io/html-extract/node.js.map +1 -0
  193. package/lib/esm/node/io/html-support.js +206 -0
  194. package/lib/esm/node/io/html-support.js.map +1 -0
  195. package/lib/esm/node/io/jira/node.js +342 -0
  196. package/lib/esm/node/io/jira/node.js.map +1 -0
  197. package/lib/esm/node/io/markdown/node.js +217 -0
  198. package/lib/esm/node/io/markdown/node.js.map +1 -0
  199. package/lib/esm/node/io/microsoft-excel/node.js +252 -0
  200. package/lib/esm/node/io/microsoft-excel/node.js.map +1 -0
  201. package/lib/esm/node/io/microsoft-sharepoint/node.js +265 -0
  202. package/lib/esm/node/io/microsoft-sharepoint/node.js.map +1 -0
  203. package/lib/esm/node/io/read-binary-file/node.js +105 -0
  204. package/lib/esm/node/io/read-binary-file/node.js.map +1 -0
  205. package/lib/esm/node/io/read-binary-files/node.js +104 -0
  206. package/lib/esm/node/io/read-binary-files/node.js.map +1 -0
  207. package/lib/esm/node/io/write-binary-file/node.js +155 -0
  208. package/lib/esm/node/io/write-binary-file/node.js.map +1 -0
  209. package/lib/esm/node/io/xml/node.js +313 -0
  210. package/lib/esm/node/io/xml/node.js.map +1 -0
  211. package/lib/esm/node/manifests.js +58 -0
  212. package/lib/esm/node/manifests.js.map +1 -1
  213. package/lib/esm/node/storage/rabbitmq/node.js +243 -0
  214. package/lib/esm/node/storage/rabbitmq/node.js.map +1 -0
  215. package/lib/esm/node/triggers/error/node.js +99 -0
  216. package/lib/esm/node/triggers/error/node.js.map +1 -0
  217. package/lib/esm/node/triggers/postgres/node.js +235 -0
  218. package/lib/esm/node/triggers/postgres/node.js.map +1 -0
  219. package/lib/esm/node/triggers/rabbitmq/node.js +275 -0
  220. package/lib/esm/node/triggers/rabbitmq/node.js.map +1 -0
  221. package/lib/esm/node/triggers/redis/node.js +224 -0
  222. package/lib/esm/node/triggers/redis/node.js.map +1 -0
  223. package/lib/esm/node/triggers/sse/node.js +187 -0
  224. package/lib/esm/node/triggers/sse/node.js.map +1 -0
  225. package/lib/esm/node/triggers/support.js +99 -0
  226. package/lib/esm/node/triggers/support.js.map +1 -0
  227. package/lib/esm/node/triggers/workflow/node.js +184 -0
  228. package/lib/esm/node/triggers/workflow/node.js.map +1 -0
  229. package/lib/esm/shared/graph/catalog/GraphValueSchemaDerivation.js +20 -3
  230. package/lib/esm/shared/graph/catalog/GraphValueSchemaDerivation.js.map +1 -1
  231. package/lib/esm/workflows/boundary-value.workflow.js +34 -0
  232. package/lib/esm/workflows/boundary-value.workflow.js.map +1 -0
  233. package/lib/esm/workflows/builders.js +40 -0
  234. package/lib/esm/workflows/builders.js.map +1 -0
  235. package/lib/esm/workflows/chat-agent.workflow.js +36 -0
  236. package/lib/esm/workflows/chat-agent.workflow.js.map +1 -0
  237. package/lib/esm/workflows/error-boundary.workflow.js +50 -0
  238. package/lib/esm/workflows/error-boundary.workflow.js.map +1 -0
  239. package/lib/esm/workflows/event-map.workflow.js +33 -0
  240. package/lib/esm/workflows/event-map.workflow.js.map +1 -0
  241. package/lib/esm/workflows/foreach-break.workflow.js +54 -0
  242. package/lib/esm/workflows/foreach-break.workflow.js.map +1 -0
  243. package/lib/esm/workflows/human-approval.workflow.js +40 -0
  244. package/lib/esm/workflows/human-approval.workflow.js.map +1 -0
  245. package/lib/esm/workflows/if-switch.workflow.js +62 -0
  246. package/lib/esm/workflows/if-switch.workflow.js.map +1 -0
  247. package/lib/esm/workflows/index.js +116 -0
  248. package/lib/esm/workflows/index.js.map +1 -0
  249. package/lib/esm/workflows/loops-while-until.workflow.js +72 -0
  250. package/lib/esm/workflows/loops-while-until.workflow.js.map +1 -0
  251. package/lib/esm/workflows/manual-log.workflow.js +48 -0
  252. package/lib/esm/workflows/manual-log.workflow.js.map +1 -0
  253. package/lib/esm/workflows/schedule-code.workflow.js +38 -0
  254. package/lib/esm/workflows/schedule-code.workflow.js.map +1 -0
  255. package/lib/esm/workflows/types.js +2 -0
  256. package/lib/esm/workflows/types.js.map +1 -0
  257. package/lib/esm/workflows/value-templates.workflow.js +39 -0
  258. package/lib/esm/workflows/value-templates.workflow.js.map +1 -0
  259. package/lib/esm/workflows/webhook-form.workflow.js +44 -0
  260. package/lib/esm/workflows/webhook-form.workflow.js.map +1 -0
  261. package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +7 -0
  262. package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +7 -0
  263. package/lib/types/engine/execution/GraphCodeMode.d.cts +46 -0
  264. package/lib/types/engine/execution/GraphCodeMode.d.mts +46 -0
  265. package/lib/types/engine/execution/GraphExecutionBackend.d.cts +21 -0
  266. package/lib/types/engine/execution/GraphExecutionBackend.d.mts +21 -0
  267. package/lib/types/engine/execution/GraphExecutionEngine.d.cts +28 -3
  268. package/lib/types/engine/execution/GraphExecutionEngine.d.mts +28 -3
  269. package/lib/types/engine/validation/GraphNodeInstanceValidator.d.cts +11 -1
  270. package/lib/types/engine/validation/GraphNodeInstanceValidator.d.mts +11 -1
  271. package/lib/types/engine/validation/GraphWorkflowDocumentValidator.d.cts +7 -0
  272. package/lib/types/engine/validation/GraphWorkflowDocumentValidator.d.mts +7 -0
  273. package/lib/types/mastra/MastraWorkflowCompiler.d.cts +23 -8
  274. package/lib/types/mastra/MastraWorkflowCompiler.d.mts +23 -8
  275. package/lib/types/nest/graph/GraphEngineController.d.cts +19 -0
  276. package/lib/types/nest/graph/GraphEngineController.d.mts +19 -0
  277. package/lib/types/nest/graph/GraphNodeCatalogueController.d.cts +13 -0
  278. package/lib/types/nest/graph/GraphNodeCatalogueController.d.mts +13 -0
  279. package/lib/types/nest/graph/GraphRunController.d.cts +16 -0
  280. package/lib/types/nest/graph/GraphRunController.d.mts +16 -0
  281. package/lib/types/nest/graph/GraphWorkflowController.d.cts +26 -3
  282. package/lib/types/nest/graph/GraphWorkflowController.d.mts +26 -3
  283. package/lib/types/node/comms/discord/node.d.cts +67 -0
  284. package/lib/types/node/comms/discord/node.d.mts +67 -0
  285. package/lib/types/node/comms/outlook/node.d.cts +77 -0
  286. package/lib/types/node/comms/outlook/node.d.mts +77 -0
  287. package/lib/types/node/comms/whatsapp/node.d.cts +71 -0
  288. package/lib/types/node/comms/whatsapp/node.d.mts +71 -0
  289. package/lib/types/node/data/aggregate/node.d.cts +58 -0
  290. package/lib/types/node/data/aggregate/node.d.mts +58 -0
  291. package/lib/types/node/data/compare-datasets/node.d.cts +72 -0
  292. package/lib/types/node/data/compare-datasets/node.d.mts +72 -0
  293. package/lib/types/node/data/item-lists/node.d.cts +92 -0
  294. package/lib/types/node/data/item-lists/node.d.mts +92 -0
  295. package/lib/types/node/data/remove-duplicates/node.d.cts +47 -0
  296. package/lib/types/node/data/remove-duplicates/node.d.mts +47 -0
  297. package/lib/types/node/data/summarize/node.d.cts +44 -0
  298. package/lib/types/node/data/summarize/node.d.mts +44 -0
  299. package/lib/types/node/data/support.d.cts +13 -0
  300. package/lib/types/node/data/support.d.mts +13 -0
  301. package/lib/types/node/data/transform-utils.d.cts +236 -0
  302. package/lib/types/node/data/transform-utils.d.mts +236 -0
  303. package/lib/types/node/index.d.cts +54 -6
  304. package/lib/types/node/index.d.mts +54 -6
  305. package/lib/types/node/io/confluence/node.d.cts +49 -0
  306. package/lib/types/node/io/confluence/node.d.mts +49 -0
  307. package/lib/types/node/io/convert-to-file/node.d.cts +75 -0
  308. package/lib/types/node/io/convert-to-file/node.d.mts +75 -0
  309. package/lib/types/node/io/file-support.d.cts +118 -0
  310. package/lib/types/node/io/file-support.d.mts +118 -0
  311. package/lib/types/node/io/google-calendar/node.d.cts +65 -0
  312. package/lib/types/node/io/google-calendar/node.d.mts +65 -0
  313. package/lib/types/node/io/google-docs/node.d.cts +51 -0
  314. package/lib/types/node/io/google-docs/node.d.mts +51 -0
  315. package/lib/types/node/io/html/node.d.cts +68 -0
  316. package/lib/types/node/io/html/node.d.mts +68 -0
  317. package/lib/types/node/io/html-extract/node.d.cts +42 -0
  318. package/lib/types/node/io/html-extract/node.d.mts +42 -0
  319. package/lib/types/node/io/html-support.d.cts +69 -0
  320. package/lib/types/node/io/html-support.d.mts +69 -0
  321. package/lib/types/node/io/jira/node.d.cts +57 -0
  322. package/lib/types/node/io/jira/node.d.mts +57 -0
  323. package/lib/types/node/io/markdown/node.d.cts +61 -0
  324. package/lib/types/node/io/markdown/node.d.mts +61 -0
  325. package/lib/types/node/io/microsoft-excel/node.d.cts +45 -0
  326. package/lib/types/node/io/microsoft-excel/node.d.mts +45 -0
  327. package/lib/types/node/io/microsoft-sharepoint/node.d.cts +47 -0
  328. package/lib/types/node/io/microsoft-sharepoint/node.d.mts +47 -0
  329. package/lib/types/node/io/read-binary-file/node.d.cts +45 -0
  330. package/lib/types/node/io/read-binary-file/node.d.mts +45 -0
  331. package/lib/types/node/io/read-binary-files/node.d.cts +41 -0
  332. package/lib/types/node/io/read-binary-files/node.d.mts +41 -0
  333. package/lib/types/node/io/write-binary-file/node.d.cts +55 -0
  334. package/lib/types/node/io/write-binary-file/node.d.mts +55 -0
  335. package/lib/types/node/io/xml/node.d.cts +67 -0
  336. package/lib/types/node/io/xml/node.d.mts +67 -0
  337. package/lib/types/node/storage/rabbitmq/node.d.cts +55 -0
  338. package/lib/types/node/storage/rabbitmq/node.d.mts +55 -0
  339. package/lib/types/node/triggers/error/node.d.cts +34 -0
  340. package/lib/types/node/triggers/error/node.d.mts +34 -0
  341. package/lib/types/node/triggers/postgres/node.d.cts +54 -0
  342. package/lib/types/node/triggers/postgres/node.d.mts +54 -0
  343. package/lib/types/node/triggers/rabbitmq/node.d.cts +59 -0
  344. package/lib/types/node/triggers/rabbitmq/node.d.mts +59 -0
  345. package/lib/types/node/triggers/redis/node.d.cts +53 -0
  346. package/lib/types/node/triggers/redis/node.d.mts +53 -0
  347. package/lib/types/node/triggers/sse/node.d.cts +43 -0
  348. package/lib/types/node/triggers/sse/node.d.mts +43 -0
  349. package/lib/types/node/triggers/support.d.cts +41 -0
  350. package/lib/types/node/triggers/support.d.mts +41 -0
  351. package/lib/types/node/triggers/workflow/node.d.cts +46 -0
  352. package/lib/types/node/triggers/workflow/node.d.mts +46 -0
  353. package/lib/types/workflows/boundary-value.workflow.d.cts +3 -0
  354. package/lib/types/workflows/boundary-value.workflow.d.mts +3 -0
  355. package/lib/types/workflows/builders.d.cts +31 -0
  356. package/lib/types/workflows/builders.d.mts +31 -0
  357. package/lib/types/workflows/chat-agent.workflow.d.cts +3 -0
  358. package/lib/types/workflows/chat-agent.workflow.d.mts +3 -0
  359. package/lib/types/workflows/error-boundary.workflow.d.cts +3 -0
  360. package/lib/types/workflows/error-boundary.workflow.d.mts +3 -0
  361. package/lib/types/workflows/event-map.workflow.d.cts +3 -0
  362. package/lib/types/workflows/event-map.workflow.d.mts +3 -0
  363. package/lib/types/workflows/foreach-break.workflow.d.cts +3 -0
  364. package/lib/types/workflows/foreach-break.workflow.d.mts +3 -0
  365. package/lib/types/workflows/human-approval.workflow.d.cts +3 -0
  366. package/lib/types/workflows/human-approval.workflow.d.mts +3 -0
  367. package/lib/types/workflows/if-switch.workflow.d.cts +3 -0
  368. package/lib/types/workflows/if-switch.workflow.d.mts +3 -0
  369. package/lib/types/workflows/index.d.cts +37 -0
  370. package/lib/types/workflows/index.d.mts +37 -0
  371. package/lib/types/workflows/loops-while-until.workflow.d.cts +3 -0
  372. package/lib/types/workflows/loops-while-until.workflow.d.mts +3 -0
  373. package/lib/types/workflows/manual-log.workflow.d.cts +3 -0
  374. package/lib/types/workflows/manual-log.workflow.d.mts +3 -0
  375. package/lib/types/workflows/schedule-code.workflow.d.cts +3 -0
  376. package/lib/types/workflows/schedule-code.workflow.d.mts +3 -0
  377. package/lib/types/workflows/types.d.cts +32 -0
  378. package/lib/types/workflows/types.d.mts +32 -0
  379. package/lib/types/workflows/value-templates.workflow.d.cts +16 -0
  380. package/lib/types/workflows/value-templates.workflow.d.mts +16 -0
  381. package/lib/types/workflows/webhook-form.workflow.d.cts +3 -0
  382. package/lib/types/workflows/webhook-form.workflow.d.mts +3 -0
  383. package/package.json +247 -25
@@ -7,10 +7,16 @@
7
7
  * utility nodes (§22.2.2–22.2.3), the Agent node (§21.3), the three loop kinds
8
8
  * (`core.loop.foreach/while/until`, §5.9), the workflow input/output value
9
9
  * boundary nodes, and the Stage 2/3 service families — Storage
10
- * (`core.storage.*`: SQL databases, Redis, and S3/GCS/Azure blob), DevOps
11
- * (`core.devops.*`: crypto, JWT, shell command, FTP, GitHub/GitLab), Comms
12
- * (`core.comms.*`: Slack, Telegram, Teams, Gmail, Email), and the newer IO
13
- * kinds (`core.io.*`: Airtable, Google Sheets, GraphQL, Spreadsheet File).
10
+ * (`core.storage.*`: SQL databases, Redis, RabbitMQ, and S3/GCS/Azure blob),
11
+ * DevOps (`core.devops.*`: crypto, JWT, shell command, FTP, GitHub/GitLab),
12
+ * Comms (`core.comms.*`: Slack, Telegram, Teams, Gmail, Email, Discord,
13
+ * WhatsApp, Microsoft Outlook), the newer IO kinds (`core.io.*`: Airtable,
14
+ * Google Sheets, GraphQL, Spreadsheet File, Confluence, Jira, Google Docs,
15
+ * Google Calendar, Microsoft Excel, Microsoft SharePoint, Convert to File,
16
+ * HTML, HTML Extract, Markdown, XML, and the binary file readers/writer), the
17
+ * Stage 5a Data kinds (`core.data.*`: Aggregate, Item Lists, Compare Datasets,
18
+ * Summarize, Remove Duplicates), and the Stage 5b eventing triggers
19
+ * (`core.trigger.*`: Error, Workflow, RabbitMQ, Redis, SSE, Postgres).
14
20
  * Shared non-node support (the base class and manifests) lives in
15
21
  * sibling files under the same tree; category styles remain in
16
22
  * `@decaf-ts/ui-decorators` (`graph/category-styles`). Consumers
@@ -37,6 +43,11 @@ export * from "./data/rename-keys/node.d.mts";
37
43
  export * from "./data/set/node.d.mts";
38
44
  export * from "./data/sort/node.d.mts";
39
45
  export * from "./data/split-out/node.d.mts";
46
+ export * from "./data/aggregate/node.d.mts";
47
+ export * from "./data/item-lists/node.d.mts";
48
+ export * from "./data/compare-datasets/node.d.mts";
49
+ export * from "./data/summarize/node.d.mts";
50
+ export * from "./data/remove-duplicates/node.d.mts";
40
51
  export * from "./io/extract-from-file/node.d.mts";
41
52
  export * from "./io/http-request/node.d.mts";
42
53
  export * from "./io/read-pdf/node.d.mts";
@@ -46,6 +57,7 @@ export * from "./storage/database/postgres/node.d.mts";
46
57
  export * from "./storage/database/mysql/node.d.mts";
47
58
  export * from "./storage/database/mssql/node.d.mts";
48
59
  export * from "./storage/redis/node.d.mts";
60
+ export * from "./storage/rabbitmq/node.d.mts";
49
61
  export * from "./storage/blob/s3/node.d.mts";
50
62
  export * from "./storage/blob/gcs/node.d.mts";
51
63
  export * from "./storage/blob/azure/node.d.mts";
@@ -54,10 +66,27 @@ export * from "./comms/telegram/node.d.mts";
54
66
  export * from "./comms/teams/node.d.mts";
55
67
  export * from "./comms/gmail/node.d.mts";
56
68
  export * from "./comms/email-send/node.d.mts";
69
+ export * from "./comms/discord/node.d.mts";
70
+ export * from "./comms/whatsapp/node.d.mts";
71
+ export * from "./comms/outlook/node.d.mts";
57
72
  export * from "./io/google-sheets/node.d.mts";
58
73
  export * from "./io/airtable/node.d.mts";
59
74
  export * from "./io/spreadsheet-file/node.d.mts";
60
75
  export * from "./io/graphql/node.d.mts";
76
+ export * from "./io/microsoft-excel/node.d.mts";
77
+ export * from "./io/confluence/node.d.mts";
78
+ export * from "./io/jira/node.d.mts";
79
+ export * from "./io/google-docs/node.d.mts";
80
+ export * from "./io/microsoft-sharepoint/node.d.mts";
81
+ export * from "./io/google-calendar/node.d.mts";
82
+ export * from "./io/convert-to-file/node.d.mts";
83
+ export * from "./io/html/node.d.mts";
84
+ export * from "./io/html-extract/node.d.mts";
85
+ export * from "./io/markdown/node.d.mts";
86
+ export * from "./io/xml/node.d.mts";
87
+ export * from "./io/read-binary-file/node.d.mts";
88
+ export * from "./io/read-binary-files/node.d.mts";
89
+ export * from "./io/write-binary-file/node.d.mts";
61
90
  export * from "./devops/github/node.d.mts";
62
91
  export * from "./devops/gitlab/node.d.mts";
63
92
  export * from "./devops/crypto/node.d.mts";
@@ -72,6 +101,12 @@ export * from "./triggers/form/node.d.mts";
72
101
  export * from "./triggers/manual/node.d.mts";
73
102
  export * from "./triggers/schedule/node.d.mts";
74
103
  export * from "./triggers/webhook/node.d.mts";
104
+ export * from "./triggers/error/node.d.mts";
105
+ export * from "./triggers/workflow/node.d.mts";
106
+ export * from "./triggers/rabbitmq/node.d.mts";
107
+ export * from "./triggers/redis/node.d.mts";
108
+ export * from "./triggers/sse/node.d.mts";
109
+ export * from "./triggers/postgres/node.d.mts";
75
110
  export * from "./agents/agent/node.d.mts";
76
111
  export * from "./agents/zones.d.mts";
77
112
  export * from "./agents/tools/tool/node.d.mts";
@@ -186,11 +221,24 @@ import { RenameKeysNode } from "./data/rename-keys/node.d.mts";
186
221
  import { SetNode } from "./data/set/node.d.mts";
187
222
  import { SortNode } from "./data/sort/node.d.mts";
188
223
  import { SplitOutNode } from "./data/split-out/node.d.mts";
224
+ import { AggregateNode } from "./data/aggregate/node.d.mts";
225
+ import { ItemListsNode } from "./data/item-lists/node.d.mts";
226
+ import { CompareDatasetsNode } from "./data/compare-datasets/node.d.mts";
227
+ import { SummarizeNode } from "./data/summarize/node.d.mts";
228
+ import { RemoveDuplicatesNode } from "./data/remove-duplicates/node.d.mts";
189
229
  import { ExtractFromFileNode } from "./io/extract-from-file/node.d.mts";
190
230
  import { HttpRequestNode } from "./io/http-request/node.d.mts";
191
231
  import { ReadPDFNode } from "./io/read-pdf/node.d.mts";
192
232
  import { ReadWriteFileNode } from "./io/read-write-file/node.d.mts";
193
233
  import { RespondToWebhookNode } from "./io/respond-to-webhook/node.d.mts";
234
+ import { ConvertToFileNode } from "./io/convert-to-file/node.d.mts";
235
+ import { HtmlNode } from "./io/html/node.d.mts";
236
+ import { HtmlExtractNode } from "./io/html-extract/node.d.mts";
237
+ import { MarkdownNode } from "./io/markdown/node.d.mts";
238
+ import { XmlNode } from "./io/xml/node.d.mts";
239
+ import { ReadBinaryFileNode } from "./io/read-binary-file/node.d.mts";
240
+ import { ReadBinaryFilesNode } from "./io/read-binary-files/node.d.mts";
241
+ import { WriteBinaryFileNode } from "./io/write-binary-file/node.d.mts";
194
242
  /**
195
243
  * All built-in trigger node constructors.
196
244
  */
@@ -256,11 +304,11 @@ export declare const GRAPH_AGENT_M6_NODES: readonly [typeof SlackChannelTriggerN
256
304
  /**
257
305
  * All built-in data-transformation node constructors (SAA-746 Stage 1).
258
306
  */
259
- export declare const GRAPH_DATA_NODES: readonly [typeof SetNode, typeof MergeNode, typeof FilterNode, typeof SplitOutNode, typeof DateTimeNode, typeof DataTableNode, typeof LimitNode, typeof SortNode, typeof RenameKeysNode];
307
+ export declare const GRAPH_DATA_NODES: readonly [typeof SetNode, typeof MergeNode, typeof FilterNode, typeof SplitOutNode, typeof DateTimeNode, typeof DataTableNode, typeof LimitNode, typeof SortNode, typeof RenameKeysNode, typeof AggregateNode, typeof ItemListsNode, typeof CompareDatasetsNode, typeof SummarizeNode, typeof RemoveDuplicatesNode];
260
308
  /**
261
309
  * All built-in IO node constructors (SAA-746 Stage 1).
262
310
  */
263
- export declare const GRAPH_IO_NODES: readonly [typeof HttpRequestNode, typeof RespondToWebhookNode, typeof ExtractFromFileNode, typeof ReadPDFNode, typeof ReadWriteFileNode];
311
+ export declare const GRAPH_IO_NODES: readonly [typeof HttpRequestNode, typeof RespondToWebhookNode, typeof ExtractFromFileNode, typeof ReadPDFNode, typeof ReadWriteFileNode, typeof ConvertToFileNode, typeof HtmlNode, typeof HtmlExtractNode, typeof MarkdownNode, typeof XmlNode, typeof ReadBinaryFileNode, typeof ReadBinaryFilesNode, typeof WriteBinaryFileNode];
264
312
  /**
265
313
  * Kind→class map for every built-in node kind the backend executes
266
314
  * (DECAF-50 §4.26 R2-1). The catalogue derives each registration's
@@ -0,0 +1,49 @@
1
+ import { GraphNode } from "../../base.d.cts";
2
+ import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../../engine/types.d.cts";
3
+ import type { GraphExecutionContext } from "../../../engine/execution/GraphExecutionContext.d.cts";
4
+ /** Operations the node can run against Confluence. */
5
+ export type ConfluenceOperation = "getPage" | "listSpaces" | "createPage" | "updatePage" | "deletePage" | "search";
6
+ /** Inputs accepted by the Confluence node. */
7
+ export type ConfluenceNodeInput = Record<string, unknown>;
8
+ /** Outputs produced by the Confluence node. */
9
+ export interface ConfluenceNodeOutput {
10
+ /** Raw service response for the executed operation. */
11
+ result: unknown;
12
+ }
13
+ /**
14
+ * Confluence node (`core.io.confluence`): space, page, and CQL operations
15
+ * through the Decaf `ConfluenceService`.
16
+ */
17
+ export declare class ConfluenceNode extends GraphNode<ConfluenceNodeInput, ConfluenceNodeOutput> {
18
+ /**
19
+ * Executes the configured Confluence operation.
20
+ *
21
+ * @param request - Execution request carrying the credential secrets; the optional `confluence` credential supplies the token, username, and base URL.
22
+ * @param context - Node execution context forwarded to the ctx-bound credential resolver.
23
+ * @returns Execution values with the service response on `result`.
24
+ * @throws {GraphExecutionError} with codes `GRAPH_CONFLUENCE_OPERATION_REQUIRED` (no operation configured), `GRAPH_CONFLUENCE_PAGE_REQUIRED`/`GRAPH_CONFLUENCE_CREATE_REQUIRED`/`GRAPH_CONFLUENCE_UPDATE_REQUIRED`/`GRAPH_CONFLUENCE_SEARCH_REQUIRED` (missing per-operation inputs), or `GRAPH_CONFLUENCE_OPERATION_FAILED` when the service call fails.
25
+ */
26
+ execute(request: GraphNodeExecutionRequest<ConfluenceNodeInput>, context: GraphExecutionContext): Promise<GraphExecutionValues>;
27
+ /** Confluence operation to perform (default `getPage`). */
28
+ operation: ConfluenceOperation;
29
+ /** Page ID used by get/update/delete operations. */
30
+ pageId?: string;
31
+ /** Space key used by `createPage`. */
32
+ spaceKey?: string;
33
+ /** Page title used by create/update operations. */
34
+ title?: string;
35
+ /** Page body in Confluence storage format. */
36
+ body?: string;
37
+ /** Optional parent page ID for `createPage`. */
38
+ parentId?: string;
39
+ /** Explicit new version for `updatePage` (auto-incremented when omitted). */
40
+ version?: number;
41
+ /** CQL query used by `search`. */
42
+ cql?: string;
43
+ /** Result limit for `listSpaces` and `search`. */
44
+ limit?: number;
45
+ /** Optional Confluence site base URL (overrides the credential value). */
46
+ baseUrl?: string;
47
+ /** Raw service response for the executed operation. */
48
+ result: unknown;
49
+ }
@@ -0,0 +1,49 @@
1
+ import { GraphNode } from "../../base.d.mts";
2
+ import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../../engine/types.d.mts";
3
+ import type { GraphExecutionContext } from "../../../engine/execution/GraphExecutionContext.d.mts";
4
+ /** Operations the node can run against Confluence. */
5
+ export type ConfluenceOperation = "getPage" | "listSpaces" | "createPage" | "updatePage" | "deletePage" | "search";
6
+ /** Inputs accepted by the Confluence node. */
7
+ export type ConfluenceNodeInput = Record<string, unknown>;
8
+ /** Outputs produced by the Confluence node. */
9
+ export interface ConfluenceNodeOutput {
10
+ /** Raw service response for the executed operation. */
11
+ result: unknown;
12
+ }
13
+ /**
14
+ * Confluence node (`core.io.confluence`): space, page, and CQL operations
15
+ * through the Decaf `ConfluenceService`.
16
+ */
17
+ export declare class ConfluenceNode extends GraphNode<ConfluenceNodeInput, ConfluenceNodeOutput> {
18
+ /**
19
+ * Executes the configured Confluence operation.
20
+ *
21
+ * @param request - Execution request carrying the credential secrets; the optional `confluence` credential supplies the token, username, and base URL.
22
+ * @param context - Node execution context forwarded to the ctx-bound credential resolver.
23
+ * @returns Execution values with the service response on `result`.
24
+ * @throws {GraphExecutionError} with codes `GRAPH_CONFLUENCE_OPERATION_REQUIRED` (no operation configured), `GRAPH_CONFLUENCE_PAGE_REQUIRED`/`GRAPH_CONFLUENCE_CREATE_REQUIRED`/`GRAPH_CONFLUENCE_UPDATE_REQUIRED`/`GRAPH_CONFLUENCE_SEARCH_REQUIRED` (missing per-operation inputs), or `GRAPH_CONFLUENCE_OPERATION_FAILED` when the service call fails.
25
+ */
26
+ execute(request: GraphNodeExecutionRequest<ConfluenceNodeInput>, context: GraphExecutionContext): Promise<GraphExecutionValues>;
27
+ /** Confluence operation to perform (default `getPage`). */
28
+ operation: ConfluenceOperation;
29
+ /** Page ID used by get/update/delete operations. */
30
+ pageId?: string;
31
+ /** Space key used by `createPage`. */
32
+ spaceKey?: string;
33
+ /** Page title used by create/update operations. */
34
+ title?: string;
35
+ /** Page body in Confluence storage format. */
36
+ body?: string;
37
+ /** Optional parent page ID for `createPage`. */
38
+ parentId?: string;
39
+ /** Explicit new version for `updatePage` (auto-incremented when omitted). */
40
+ version?: number;
41
+ /** CQL query used by `search`. */
42
+ cql?: string;
43
+ /** Result limit for `listSpaces` and `search`. */
44
+ limit?: number;
45
+ /** Optional Confluence site base URL (overrides the credential value). */
46
+ baseUrl?: string;
47
+ /** Raw service response for the executed operation. */
48
+ result: unknown;
49
+ }
@@ -0,0 +1,75 @@
1
+ import { GraphNode } from "../../base.d.cts";
2
+ import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../../engine/types.d.cts";
3
+ import { type BinaryFilePayload } from "../file-support.d.cts";
4
+ /** Target file format; only `csv`, `html`, `toJson`, `toText`, and `toBinary` are implemented. */
5
+ export type ConvertToFileOperation = "csv" | "html" | "iCal" | "ods" | "rtf" | "xls" | "xlsx" | "toJson" | "toText" | "toBinary";
6
+ /** Inputs accepted by the Convert to File node; `value` carries the items to convert. */
7
+ export type ConvertToFileNodeInput = Record<string, unknown>;
8
+ /** Outputs produced by the Convert to File node. */
9
+ export interface ConvertToFileNodeOutput {
10
+ /** Generated file payload(s). */
11
+ result: BinaryFilePayload | BinaryFilePayload[];
12
+ /** Raw text content for the single-payload text formats (`csv`, `html`, `toJson`). */
13
+ content?: string;
14
+ /** Total payload size in bytes. */
15
+ bytes?: number;
16
+ }
17
+ /**
18
+ * Convert to File node (`core.io.convertToFile`): serializes items to CSV,
19
+ * HTML, JSON, text, or base64-backed binary file payloads.
20
+ */
21
+ export declare class ConvertToFileNode extends GraphNode<ConvertToFileNodeInput, ConvertToFileNodeOutput> {
22
+ /**
23
+ * Converts the input items into file payloads.
24
+ *
25
+ * @param request - Execution request; `inputs.value` holds the items to convert.
26
+ * @returns Execution values with the generated payload(s), the text
27
+ * `content` for single text files, and the total `bytes`.
28
+ * @throws {GraphExecutionError} `GRAPH_CONVERT_TO_FILE_UNSUPPORTED_OPERATION`
29
+ * for a declared-but-unimplemented format, or
30
+ * `GRAPH_CONVERT_TO_FILE_SOURCE_REQUIRED` when `toText`/`toBinary` cannot
31
+ * find a usable source value.
32
+ */
33
+ execute(request: GraphNodeExecutionRequest<ConvertToFileNodeInput>): GraphExecutionValues;
34
+ private textPayloads;
35
+ private binaryPayloads;
36
+ private returnPayloads;
37
+ /** Items to convert; non-records are wrapped as `{ value }`. */
38
+ value: unknown;
39
+ /** Target format (default `csv`). */
40
+ operation: ConvertToFileOperation;
41
+ /** Declared binary property name option; the implemented conversion paths do not read it. */
42
+ binaryPropertyName: string;
43
+ /** Field holding the text or base64 source for `toText`/`toBinary`. */
44
+ sourceProperty?: string;
45
+ /** `toJson` output granularity: one payload for all items or one payload per item (default `once`). */
46
+ mode: "once" | "each";
47
+ /** Output file name; each format supplies its own default. */
48
+ fileName?: string;
49
+ /** MIME type override for binary outputs. */
50
+ mimeType?: string;
51
+ /** CSV field delimiter (default `,`). */
52
+ delimiter?: string;
53
+ /** Emit a CSV header row (default `true`). */
54
+ headerRow?: boolean;
55
+ /** Declared spreadsheet sheet name option; the implemented paths do not read it. */
56
+ sheetName?: string;
57
+ /** Prefix UTF-8 text output with a byte-order mark (default `false`). */
58
+ addBOM?: boolean;
59
+ /** Pretty-print JSON with two-space indentation (default `false`). */
60
+ format?: boolean;
61
+ /** Treat the `toBinary` source as base64; when `false` it is read as UTF-8 (default `true`). */
62
+ dataIsBase64?: boolean;
63
+ /** Caption for the generated HTML table. */
64
+ caption?: string;
65
+ /** Omit the default inline table styles (default `false`). */
66
+ customStyling?: boolean;
67
+ /** Capitalize and humanize HTML table headers (default `false`). */
68
+ capitalize?: boolean;
69
+ /** Generated payload(s). */
70
+ result: BinaryFilePayload | BinaryFilePayload[];
71
+ /** Raw text content for single-payload text formats. */
72
+ content?: string;
73
+ /** Total payload size in bytes. */
74
+ bytes?: number;
75
+ }
@@ -0,0 +1,75 @@
1
+ import { GraphNode } from "../../base.d.mts";
2
+ import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../../../engine/types.d.mts";
3
+ import { type BinaryFilePayload } from "../file-support.d.mts";
4
+ /** Target file format; only `csv`, `html`, `toJson`, `toText`, and `toBinary` are implemented. */
5
+ export type ConvertToFileOperation = "csv" | "html" | "iCal" | "ods" | "rtf" | "xls" | "xlsx" | "toJson" | "toText" | "toBinary";
6
+ /** Inputs accepted by the Convert to File node; `value` carries the items to convert. */
7
+ export type ConvertToFileNodeInput = Record<string, unknown>;
8
+ /** Outputs produced by the Convert to File node. */
9
+ export interface ConvertToFileNodeOutput {
10
+ /** Generated file payload(s). */
11
+ result: BinaryFilePayload | BinaryFilePayload[];
12
+ /** Raw text content for the single-payload text formats (`csv`, `html`, `toJson`). */
13
+ content?: string;
14
+ /** Total payload size in bytes. */
15
+ bytes?: number;
16
+ }
17
+ /**
18
+ * Convert to File node (`core.io.convertToFile`): serializes items to CSV,
19
+ * HTML, JSON, text, or base64-backed binary file payloads.
20
+ */
21
+ export declare class ConvertToFileNode extends GraphNode<ConvertToFileNodeInput, ConvertToFileNodeOutput> {
22
+ /**
23
+ * Converts the input items into file payloads.
24
+ *
25
+ * @param request - Execution request; `inputs.value` holds the items to convert.
26
+ * @returns Execution values with the generated payload(s), the text
27
+ * `content` for single text files, and the total `bytes`.
28
+ * @throws {GraphExecutionError} `GRAPH_CONVERT_TO_FILE_UNSUPPORTED_OPERATION`
29
+ * for a declared-but-unimplemented format, or
30
+ * `GRAPH_CONVERT_TO_FILE_SOURCE_REQUIRED` when `toText`/`toBinary` cannot
31
+ * find a usable source value.
32
+ */
33
+ execute(request: GraphNodeExecutionRequest<ConvertToFileNodeInput>): GraphExecutionValues;
34
+ private textPayloads;
35
+ private binaryPayloads;
36
+ private returnPayloads;
37
+ /** Items to convert; non-records are wrapped as `{ value }`. */
38
+ value: unknown;
39
+ /** Target format (default `csv`). */
40
+ operation: ConvertToFileOperation;
41
+ /** Declared binary property name option; the implemented conversion paths do not read it. */
42
+ binaryPropertyName: string;
43
+ /** Field holding the text or base64 source for `toText`/`toBinary`. */
44
+ sourceProperty?: string;
45
+ /** `toJson` output granularity: one payload for all items or one payload per item (default `once`). */
46
+ mode: "once" | "each";
47
+ /** Output file name; each format supplies its own default. */
48
+ fileName?: string;
49
+ /** MIME type override for binary outputs. */
50
+ mimeType?: string;
51
+ /** CSV field delimiter (default `,`). */
52
+ delimiter?: string;
53
+ /** Emit a CSV header row (default `true`). */
54
+ headerRow?: boolean;
55
+ /** Declared spreadsheet sheet name option; the implemented paths do not read it. */
56
+ sheetName?: string;
57
+ /** Prefix UTF-8 text output with a byte-order mark (default `false`). */
58
+ addBOM?: boolean;
59
+ /** Pretty-print JSON with two-space indentation (default `false`). */
60
+ format?: boolean;
61
+ /** Treat the `toBinary` source as base64; when `false` it is read as UTF-8 (default `true`). */
62
+ dataIsBase64?: boolean;
63
+ /** Caption for the generated HTML table. */
64
+ caption?: string;
65
+ /** Omit the default inline table styles (default `false`). */
66
+ customStyling?: boolean;
67
+ /** Capitalize and humanize HTML table headers (default `false`). */
68
+ capitalize?: boolean;
69
+ /** Generated payload(s). */
70
+ result: BinaryFilePayload | BinaryFilePayload[];
71
+ /** Raw text content for single-payload text formats. */
72
+ content?: string;
73
+ /** Total payload size in bytes. */
74
+ bytes?: number;
75
+ }
@@ -0,0 +1,118 @@
1
+ /**
2
+ * Resolves the file-IO base directory.
3
+ *
4
+ * @returns The real path of `GRAPH_FILE_IO_BASE` (when set and non-empty) or
5
+ * the current working directory; the lexical path is returned when it cannot
6
+ * be resolved.
7
+ */
8
+ export declare function fileIoBase(): string;
9
+ /**
10
+ * Asserts that a resolved candidate path stays inside the base and avoids the
11
+ * forbidden directories.
12
+ *
13
+ * @param base - The resolved file-IO base.
14
+ * @param candidate - The resolved candidate path.
15
+ * @param configuredPath - The original configured path for error context.
16
+ * @throws {GraphExecutionError} `GRAPH_FILE_PATH_FORBIDDEN` when the path
17
+ * escapes the base or targets a forbidden directory or segment.
18
+ */
19
+ export declare function assertContainedPath(base: string, candidate: string, configuredPath: string): void;
20
+ /**
21
+ * Resolves a configured path under the file-IO base and validates containment.
22
+ *
23
+ * Leading separators are stripped so configured paths are always treated as
24
+ * base-relative; NUL bytes are rejected before resolution.
25
+ *
26
+ * @param configuredPath - The configured file path.
27
+ * @returns The resolved base directory and candidate path.
28
+ * @throws {GraphExecutionError} `GRAPH_FILE_INVALID_PATH` for NUL bytes and
29
+ * `GRAPH_FILE_PATH_FORBIDDEN` for escaping/forbidden paths.
30
+ */
31
+ export declare function resolveGraphFilePath(configuredPath: string): {
32
+ base: string;
33
+ candidate: string;
34
+ };
35
+ /**
36
+ * Infers a MIME type from a file extension.
37
+ *
38
+ * @param fileName - File name or path.
39
+ * @returns The mapped MIME type, or `application/octet-stream` for unknown
40
+ * extensions.
41
+ */
42
+ export declare function mimeTypeFor(fileName: string): string;
43
+ /** Serialized file payload shared by the binary and conversion nodes. */
44
+ export interface BinaryFilePayload {
45
+ fileName: string;
46
+ path?: string;
47
+ mimeType: string;
48
+ byteLength: number;
49
+ data: string;
50
+ }
51
+ /**
52
+ * Wraps a buffer as a `BinaryFilePayload`, encoding the data as base64.
53
+ *
54
+ * @param buffer - The file content.
55
+ * @param fileName - File name used for payload metadata.
56
+ * @param path - Optional original configured path.
57
+ * @param mimeType - Optional MIME override; otherwise inferred from the name.
58
+ * @returns The serialized payload.
59
+ */
60
+ export declare function binaryPayloadOf(buffer: Buffer, fileName: string, path?: string, mimeType?: string): BinaryFilePayload;
61
+ /** Input decoding mode: UTF-8 text, base64 text, or inference for payload records. */
62
+ export type GraphBinaryEncoding = "utf8" | "base64" | "auto";
63
+ /**
64
+ * Decodes a node input into a `Buffer`.
65
+ *
66
+ * Strings decode as UTF-8 or base64; `data:` URLs drop their prefix; buffers,
67
+ * typed arrays, and array buffers pass through; records are searched for the
68
+ * first of `dataPropertyName`, `data`, `content`, or `value`.
69
+ *
70
+ * @param value - The input value.
71
+ * @param encoding - Decoding mode (default `utf8`; `auto` inspects payload records).
72
+ * @param dataPropertyName - Preferred record field (default `data`).
73
+ * @returns The decoded buffer.
74
+ * @throws {GraphExecutionError} `GRAPH_BINARY_INPUT_REQUIRED` when the value
75
+ * cannot be decoded.
76
+ */
77
+ export declare function binaryBufferOf(value: unknown, encoding?: GraphBinaryEncoding, dataPropertyName?: string): Buffer;
78
+ /**
79
+ * Reads a contained file and serializes it as a payload.
80
+ *
81
+ * @param configuredPath - The configured path, relative to the file-IO base.
82
+ * @returns The payload and its byte length.
83
+ * @throws {GraphExecutionError} `GRAPH_FILE_INVALID_PATH` when the file does
84
+ * not exist, plus the containment errors from `resolveGraphFilePath`.
85
+ */
86
+ export declare function readGraphFilePayload(configuredPath: string): Promise<{
87
+ payload: BinaryFilePayload;
88
+ bytes: number;
89
+ }>;
90
+ /**
91
+ * Writes a buffer to a contained file.
92
+ *
93
+ * Existing targets and the nearest existing ancestor are re-checked after
94
+ * symlink resolution; parent directories are created unless disabled.
95
+ *
96
+ * @param configuredPath - The configured path, relative to the file-IO base.
97
+ * @param data - The bytes to write.
98
+ * @param options - Append and directory-creation options.
99
+ * @returns The configured path and the number of bytes written.
100
+ * @throws {GraphExecutionError} `GRAPH_FILE_PATH_FORBIDDEN` when the target or
101
+ * its parent resolves outside the base.
102
+ */
103
+ export declare function writeGraphFile(configuredPath: string, data: Buffer, options?: {
104
+ append?: boolean;
105
+ createDirectories?: boolean;
106
+ }): Promise<{
107
+ path: string;
108
+ bytes: number;
109
+ }>;
110
+ /**
111
+ * Expands a glob pattern inside the file-IO base.
112
+ *
113
+ * @param pattern - The glob pattern; leading separators are stripped.
114
+ * @returns Matching, contained, existing paths in sorted order.
115
+ * @throws {GraphExecutionError} `GRAPH_FILE_PATH_FORBIDDEN` when a match
116
+ * resolves outside the base.
117
+ */
118
+ export declare function graphGlobFiles(pattern: string): Promise<string[]>;
@@ -0,0 +1,118 @@
1
+ /**
2
+ * Resolves the file-IO base directory.
3
+ *
4
+ * @returns The real path of `GRAPH_FILE_IO_BASE` (when set and non-empty) or
5
+ * the current working directory; the lexical path is returned when it cannot
6
+ * be resolved.
7
+ */
8
+ export declare function fileIoBase(): string;
9
+ /**
10
+ * Asserts that a resolved candidate path stays inside the base and avoids the
11
+ * forbidden directories.
12
+ *
13
+ * @param base - The resolved file-IO base.
14
+ * @param candidate - The resolved candidate path.
15
+ * @param configuredPath - The original configured path for error context.
16
+ * @throws {GraphExecutionError} `GRAPH_FILE_PATH_FORBIDDEN` when the path
17
+ * escapes the base or targets a forbidden directory or segment.
18
+ */
19
+ export declare function assertContainedPath(base: string, candidate: string, configuredPath: string): void;
20
+ /**
21
+ * Resolves a configured path under the file-IO base and validates containment.
22
+ *
23
+ * Leading separators are stripped so configured paths are always treated as
24
+ * base-relative; NUL bytes are rejected before resolution.
25
+ *
26
+ * @param configuredPath - The configured file path.
27
+ * @returns The resolved base directory and candidate path.
28
+ * @throws {GraphExecutionError} `GRAPH_FILE_INVALID_PATH` for NUL bytes and
29
+ * `GRAPH_FILE_PATH_FORBIDDEN` for escaping/forbidden paths.
30
+ */
31
+ export declare function resolveGraphFilePath(configuredPath: string): {
32
+ base: string;
33
+ candidate: string;
34
+ };
35
+ /**
36
+ * Infers a MIME type from a file extension.
37
+ *
38
+ * @param fileName - File name or path.
39
+ * @returns The mapped MIME type, or `application/octet-stream` for unknown
40
+ * extensions.
41
+ */
42
+ export declare function mimeTypeFor(fileName: string): string;
43
+ /** Serialized file payload shared by the binary and conversion nodes. */
44
+ export interface BinaryFilePayload {
45
+ fileName: string;
46
+ path?: string;
47
+ mimeType: string;
48
+ byteLength: number;
49
+ data: string;
50
+ }
51
+ /**
52
+ * Wraps a buffer as a `BinaryFilePayload`, encoding the data as base64.
53
+ *
54
+ * @param buffer - The file content.
55
+ * @param fileName - File name used for payload metadata.
56
+ * @param path - Optional original configured path.
57
+ * @param mimeType - Optional MIME override; otherwise inferred from the name.
58
+ * @returns The serialized payload.
59
+ */
60
+ export declare function binaryPayloadOf(buffer: Buffer, fileName: string, path?: string, mimeType?: string): BinaryFilePayload;
61
+ /** Input decoding mode: UTF-8 text, base64 text, or inference for payload records. */
62
+ export type GraphBinaryEncoding = "utf8" | "base64" | "auto";
63
+ /**
64
+ * Decodes a node input into a `Buffer`.
65
+ *
66
+ * Strings decode as UTF-8 or base64; `data:` URLs drop their prefix; buffers,
67
+ * typed arrays, and array buffers pass through; records are searched for the
68
+ * first of `dataPropertyName`, `data`, `content`, or `value`.
69
+ *
70
+ * @param value - The input value.
71
+ * @param encoding - Decoding mode (default `utf8`; `auto` inspects payload records).
72
+ * @param dataPropertyName - Preferred record field (default `data`).
73
+ * @returns The decoded buffer.
74
+ * @throws {GraphExecutionError} `GRAPH_BINARY_INPUT_REQUIRED` when the value
75
+ * cannot be decoded.
76
+ */
77
+ export declare function binaryBufferOf(value: unknown, encoding?: GraphBinaryEncoding, dataPropertyName?: string): Buffer;
78
+ /**
79
+ * Reads a contained file and serializes it as a payload.
80
+ *
81
+ * @param configuredPath - The configured path, relative to the file-IO base.
82
+ * @returns The payload and its byte length.
83
+ * @throws {GraphExecutionError} `GRAPH_FILE_INVALID_PATH` when the file does
84
+ * not exist, plus the containment errors from `resolveGraphFilePath`.
85
+ */
86
+ export declare function readGraphFilePayload(configuredPath: string): Promise<{
87
+ payload: BinaryFilePayload;
88
+ bytes: number;
89
+ }>;
90
+ /**
91
+ * Writes a buffer to a contained file.
92
+ *
93
+ * Existing targets and the nearest existing ancestor are re-checked after
94
+ * symlink resolution; parent directories are created unless disabled.
95
+ *
96
+ * @param configuredPath - The configured path, relative to the file-IO base.
97
+ * @param data - The bytes to write.
98
+ * @param options - Append and directory-creation options.
99
+ * @returns The configured path and the number of bytes written.
100
+ * @throws {GraphExecutionError} `GRAPH_FILE_PATH_FORBIDDEN` when the target or
101
+ * its parent resolves outside the base.
102
+ */
103
+ export declare function writeGraphFile(configuredPath: string, data: Buffer, options?: {
104
+ append?: boolean;
105
+ createDirectories?: boolean;
106
+ }): Promise<{
107
+ path: string;
108
+ bytes: number;
109
+ }>;
110
+ /**
111
+ * Expands a glob pattern inside the file-IO base.
112
+ *
113
+ * @param pattern - The glob pattern; leading separators are stripped.
114
+ * @returns Matching, contained, existing paths in sorted order.
115
+ * @throws {GraphExecutionError} `GRAPH_FILE_PATH_FORBIDDEN` when a match
116
+ * resolves outside the base.
117
+ */
118
+ export declare function graphGlobFiles(pattern: string): Promise<string[]>;