@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.
- package/README.md +92 -12
- package/assets/i18n/en.json +1519 -130
- package/dist/as-graph.cjs +1 -1
- package/dist/as-graph.cjs.map +1 -1
- package/dist/as-graph.js +1 -1
- package/dist/as-graph.js.map +1 -1
- package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs +13 -0
- package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs.map +1 -1
- package/lib/cjs/dagster/capabilities.cjs +5 -0
- package/lib/cjs/dagster/capabilities.cjs.map +1 -1
- package/lib/cjs/engine/execution/GraphCodeMode.cjs +42 -0
- package/lib/cjs/engine/execution/GraphCodeMode.cjs.map +1 -1
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +35 -4
- package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
- package/lib/cjs/engine/validation/GraphNodeInstanceValidator.cjs +29 -1
- package/lib/cjs/engine/validation/GraphNodeInstanceValidator.cjs.map +1 -1
- package/lib/cjs/engine/validation/GraphWorkflowDocumentValidator.cjs +6 -2
- package/lib/cjs/engine/validation/GraphWorkflowDocumentValidator.cjs.map +1 -1
- package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +41 -9
- package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphEngineController.cjs +18 -0
- package/lib/cjs/nest/graph/GraphEngineController.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphNodeCatalogueController.cjs +14 -0
- package/lib/cjs/nest/graph/GraphNodeCatalogueController.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphRunController.cjs +17 -0
- package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
- package/lib/cjs/nest/graph/GraphWorkflowController.cjs +34 -5
- package/lib/cjs/nest/graph/GraphWorkflowController.cjs.map +1 -1
- package/lib/cjs/node/comms/discord/node.cjs +384 -0
- package/lib/cjs/node/comms/discord/node.cjs.map +1 -0
- package/lib/cjs/node/comms/outlook/node.cjs +395 -0
- package/lib/cjs/node/comms/outlook/node.cjs.map +1 -0
- package/lib/cjs/node/comms/whatsapp/node.cjs +341 -0
- package/lib/cjs/node/comms/whatsapp/node.cjs.map +1 -0
- package/lib/cjs/node/data/aggregate/node.cjs +196 -0
- package/lib/cjs/node/data/aggregate/node.cjs.map +1 -0
- package/lib/cjs/node/data/compare-datasets/node.cjs +331 -0
- package/lib/cjs/node/data/compare-datasets/node.cjs.map +1 -0
- package/lib/cjs/node/data/item-lists/node.cjs +416 -0
- package/lib/cjs/node/data/item-lists/node.cjs.map +1 -0
- package/lib/cjs/node/data/remove-duplicates/node.cjs +141 -0
- package/lib/cjs/node/data/remove-duplicates/node.cjs.map +1 -0
- package/lib/cjs/node/data/summarize/node.cjs +155 -0
- package/lib/cjs/node/data/summarize/node.cjs.map +1 -0
- package/lib/cjs/node/data/support.cjs +5 -0
- package/lib/cjs/node/data/support.cjs.map +1 -1
- package/lib/cjs/node/data/transform-utils.cjs +719 -0
- package/lib/cjs/node/data/transform-utils.cjs.map +1 -0
- package/lib/cjs/node/index.cjs +216 -110
- package/lib/cjs/node/index.cjs.map +1 -1
- package/lib/cjs/node/io/confluence/node.cjs +253 -0
- package/lib/cjs/node/io/confluence/node.cjs.map +1 -0
- package/lib/cjs/node/io/convert-to-file/node.cjs +349 -0
- package/lib/cjs/node/io/convert-to-file/node.cjs.map +1 -0
- package/lib/cjs/node/io/file-support.cjs +311 -0
- package/lib/cjs/node/io/file-support.cjs.map +1 -0
- package/lib/cjs/node/io/google-calendar/node.cjs +359 -0
- package/lib/cjs/node/io/google-calendar/node.cjs.map +1 -0
- package/lib/cjs/node/io/google-docs/node.cjs +272 -0
- package/lib/cjs/node/io/google-docs/node.cjs.map +1 -0
- package/lib/cjs/node/io/html/node.cjs +275 -0
- package/lib/cjs/node/io/html/node.cjs.map +1 -0
- package/lib/cjs/node/io/html-extract/node.cjs +162 -0
- package/lib/cjs/node/io/html-extract/node.cjs.map +1 -0
- package/lib/cjs/node/io/html-support.cjs +246 -0
- package/lib/cjs/node/io/html-support.cjs.map +1 -0
- package/lib/cjs/node/io/jira/node.cjs +351 -0
- package/lib/cjs/node/io/jira/node.cjs.map +1 -0
- package/lib/cjs/node/io/markdown/node.cjs +229 -0
- package/lib/cjs/node/io/markdown/node.cjs.map +1 -0
- package/lib/cjs/node/io/microsoft-excel/node.cjs +261 -0
- package/lib/cjs/node/io/microsoft-excel/node.cjs.map +1 -0
- package/lib/cjs/node/io/microsoft-sharepoint/node.cjs +274 -0
- package/lib/cjs/node/io/microsoft-sharepoint/node.cjs.map +1 -0
- package/lib/cjs/node/io/read-binary-file/node.cjs +114 -0
- package/lib/cjs/node/io/read-binary-file/node.cjs.map +1 -0
- package/lib/cjs/node/io/read-binary-files/node.cjs +113 -0
- package/lib/cjs/node/io/read-binary-files/node.cjs.map +1 -0
- package/lib/cjs/node/io/write-binary-file/node.cjs +164 -0
- package/lib/cjs/node/io/write-binary-file/node.cjs.map +1 -0
- package/lib/cjs/node/io/xml/node.cjs +322 -0
- package/lib/cjs/node/io/xml/node.cjs.map +1 -0
- package/lib/cjs/node/manifests.cjs +137 -79
- package/lib/cjs/node/manifests.cjs.map +1 -1
- package/lib/cjs/node/storage/rabbitmq/node.cjs +252 -0
- package/lib/cjs/node/storage/rabbitmq/node.cjs.map +1 -0
- package/lib/cjs/node/triggers/error/node.cjs +108 -0
- package/lib/cjs/node/triggers/error/node.cjs.map +1 -0
- package/lib/cjs/node/triggers/postgres/node.cjs +244 -0
- package/lib/cjs/node/triggers/postgres/node.cjs.map +1 -0
- package/lib/cjs/node/triggers/rabbitmq/node.cjs +284 -0
- package/lib/cjs/node/triggers/rabbitmq/node.cjs.map +1 -0
- package/lib/cjs/node/triggers/redis/node.cjs +233 -0
- package/lib/cjs/node/triggers/redis/node.cjs.map +1 -0
- package/lib/cjs/node/triggers/sse/node.cjs +196 -0
- package/lib/cjs/node/triggers/sse/node.cjs.map +1 -0
- package/lib/cjs/node/triggers/support.cjs +107 -0
- package/lib/cjs/node/triggers/support.cjs.map +1 -0
- package/lib/cjs/node/triggers/workflow/node.cjs +193 -0
- package/lib/cjs/node/triggers/workflow/node.cjs.map +1 -0
- package/lib/cjs/shared/graph/catalog/GraphValueSchemaDerivation.cjs +20 -3
- package/lib/cjs/shared/graph/catalog/GraphValueSchemaDerivation.cjs.map +1 -1
- package/lib/cjs/workflows/boundary-value.workflow.cjs +38 -0
- package/lib/cjs/workflows/boundary-value.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/builders.cjs +47 -0
- package/lib/cjs/workflows/builders.cjs.map +1 -0
- package/lib/cjs/workflows/chat-agent.workflow.cjs +40 -0
- package/lib/cjs/workflows/chat-agent.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/error-boundary.workflow.cjs +54 -0
- package/lib/cjs/workflows/error-boundary.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/event-map.workflow.cjs +37 -0
- package/lib/cjs/workflows/event-map.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/foreach-break.workflow.cjs +58 -0
- package/lib/cjs/workflows/foreach-break.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/human-approval.workflow.cjs +44 -0
- package/lib/cjs/workflows/human-approval.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/if-switch.workflow.cjs +66 -0
- package/lib/cjs/workflows/if-switch.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/index.cjs +135 -0
- package/lib/cjs/workflows/index.cjs.map +1 -0
- package/lib/cjs/workflows/loops-while-until.workflow.cjs +76 -0
- package/lib/cjs/workflows/loops-while-until.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/manual-log.workflow.cjs +52 -0
- package/lib/cjs/workflows/manual-log.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/schedule-code.workflow.cjs +42 -0
- package/lib/cjs/workflows/schedule-code.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/types.cjs +4 -0
- package/lib/cjs/workflows/types.cjs.map +1 -0
- package/lib/cjs/workflows/value-templates.workflow.cjs +43 -0
- package/lib/cjs/workflows/value-templates.workflow.cjs.map +1 -0
- package/lib/cjs/workflows/webhook-form.workflow.cjs +48 -0
- package/lib/cjs/workflows/webhook-form.workflow.cjs.map +1 -0
- package/lib/esm/dagster/DagsterGraphExecutionBackend.js +13 -0
- package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -1
- package/lib/esm/dagster/capabilities.js +5 -0
- package/lib/esm/dagster/capabilities.js.map +1 -1
- package/lib/esm/engine/execution/GraphCodeMode.js +40 -0
- package/lib/esm/engine/execution/GraphCodeMode.js.map +1 -1
- package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -1
- package/lib/esm/engine/execution/GraphExecutionEngine.js +36 -5
- package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
- package/lib/esm/engine/validation/GraphNodeInstanceValidator.js +29 -1
- package/lib/esm/engine/validation/GraphNodeInstanceValidator.js.map +1 -1
- package/lib/esm/engine/validation/GraphWorkflowDocumentValidator.js +6 -2
- package/lib/esm/engine/validation/GraphWorkflowDocumentValidator.js.map +1 -1
- package/lib/esm/mastra/MastraMemory.js.map +1 -1
- package/lib/esm/mastra/MastraWorkflowCompiler.js +41 -9
- package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -1
- package/lib/esm/nest/graph/GraphEngineController.js +19 -1
- package/lib/esm/nest/graph/GraphEngineController.js.map +1 -1
- package/lib/esm/nest/graph/GraphNodeCatalogueController.js +15 -1
- package/lib/esm/nest/graph/GraphNodeCatalogueController.js.map +1 -1
- package/lib/esm/nest/graph/GraphRunController.js +18 -1
- package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
- package/lib/esm/nest/graph/GraphWorkflowController.js +35 -6
- package/lib/esm/nest/graph/GraphWorkflowController.js.map +1 -1
- package/lib/esm/node/comms/discord/node.js +375 -0
- package/lib/esm/node/comms/discord/node.js.map +1 -0
- package/lib/esm/node/comms/outlook/node.js +386 -0
- package/lib/esm/node/comms/outlook/node.js.map +1 -0
- package/lib/esm/node/comms/whatsapp/node.js +332 -0
- package/lib/esm/node/comms/whatsapp/node.js.map +1 -0
- package/lib/esm/node/data/aggregate/node.js +187 -0
- package/lib/esm/node/data/aggregate/node.js.map +1 -0
- package/lib/esm/node/data/compare-datasets/node.js +322 -0
- package/lib/esm/node/data/compare-datasets/node.js.map +1 -0
- package/lib/esm/node/data/item-lists/node.js +407 -0
- package/lib/esm/node/data/item-lists/node.js.map +1 -0
- package/lib/esm/node/data/remove-duplicates/node.js +132 -0
- package/lib/esm/node/data/remove-duplicates/node.js.map +1 -0
- package/lib/esm/node/data/summarize/node.js +146 -0
- package/lib/esm/node/data/summarize/node.js.map +1 -0
- package/lib/esm/node/data/support.js +5 -1
- package/lib/esm/node/data/support.js.map +1 -1
- package/lib/esm/node/data/transform-utils.js +702 -0
- package/lib/esm/node/data/transform-utils.js.map +1 -0
- package/lib/esm/node/index.js +110 -4
- package/lib/esm/node/index.js.map +1 -1
- package/lib/esm/node/io/confluence/node.js +244 -0
- package/lib/esm/node/io/confluence/node.js.map +1 -0
- package/lib/esm/node/io/convert-to-file/node.js +340 -0
- package/lib/esm/node/io/convert-to-file/node.js.map +1 -0
- package/lib/esm/node/io/file-support.js +299 -0
- package/lib/esm/node/io/file-support.js.map +1 -0
- package/lib/esm/node/io/google-calendar/node.js +350 -0
- package/lib/esm/node/io/google-calendar/node.js.map +1 -0
- package/lib/esm/node/io/google-docs/node.js +263 -0
- package/lib/esm/node/io/google-docs/node.js.map +1 -0
- package/lib/esm/node/io/html/node.js +266 -0
- package/lib/esm/node/io/html/node.js.map +1 -0
- package/lib/esm/node/io/html-extract/node.js +153 -0
- package/lib/esm/node/io/html-extract/node.js.map +1 -0
- package/lib/esm/node/io/html-support.js +206 -0
- package/lib/esm/node/io/html-support.js.map +1 -0
- package/lib/esm/node/io/jira/node.js +342 -0
- package/lib/esm/node/io/jira/node.js.map +1 -0
- package/lib/esm/node/io/markdown/node.js +217 -0
- package/lib/esm/node/io/markdown/node.js.map +1 -0
- package/lib/esm/node/io/microsoft-excel/node.js +252 -0
- package/lib/esm/node/io/microsoft-excel/node.js.map +1 -0
- package/lib/esm/node/io/microsoft-sharepoint/node.js +265 -0
- package/lib/esm/node/io/microsoft-sharepoint/node.js.map +1 -0
- package/lib/esm/node/io/read-binary-file/node.js +105 -0
- package/lib/esm/node/io/read-binary-file/node.js.map +1 -0
- package/lib/esm/node/io/read-binary-files/node.js +104 -0
- package/lib/esm/node/io/read-binary-files/node.js.map +1 -0
- package/lib/esm/node/io/write-binary-file/node.js +155 -0
- package/lib/esm/node/io/write-binary-file/node.js.map +1 -0
- package/lib/esm/node/io/xml/node.js +313 -0
- package/lib/esm/node/io/xml/node.js.map +1 -0
- package/lib/esm/node/manifests.js +58 -0
- package/lib/esm/node/manifests.js.map +1 -1
- package/lib/esm/node/storage/rabbitmq/node.js +243 -0
- package/lib/esm/node/storage/rabbitmq/node.js.map +1 -0
- package/lib/esm/node/triggers/error/node.js +99 -0
- package/lib/esm/node/triggers/error/node.js.map +1 -0
- package/lib/esm/node/triggers/postgres/node.js +235 -0
- package/lib/esm/node/triggers/postgres/node.js.map +1 -0
- package/lib/esm/node/triggers/rabbitmq/node.js +275 -0
- package/lib/esm/node/triggers/rabbitmq/node.js.map +1 -0
- package/lib/esm/node/triggers/redis/node.js +224 -0
- package/lib/esm/node/triggers/redis/node.js.map +1 -0
- package/lib/esm/node/triggers/sse/node.js +187 -0
- package/lib/esm/node/triggers/sse/node.js.map +1 -0
- package/lib/esm/node/triggers/support.js +99 -0
- package/lib/esm/node/triggers/support.js.map +1 -0
- package/lib/esm/node/triggers/workflow/node.js +184 -0
- package/lib/esm/node/triggers/workflow/node.js.map +1 -0
- package/lib/esm/shared/graph/catalog/GraphValueSchemaDerivation.js +20 -3
- package/lib/esm/shared/graph/catalog/GraphValueSchemaDerivation.js.map +1 -1
- package/lib/esm/workflows/boundary-value.workflow.js +34 -0
- package/lib/esm/workflows/boundary-value.workflow.js.map +1 -0
- package/lib/esm/workflows/builders.js +40 -0
- package/lib/esm/workflows/builders.js.map +1 -0
- package/lib/esm/workflows/chat-agent.workflow.js +36 -0
- package/lib/esm/workflows/chat-agent.workflow.js.map +1 -0
- package/lib/esm/workflows/error-boundary.workflow.js +50 -0
- package/lib/esm/workflows/error-boundary.workflow.js.map +1 -0
- package/lib/esm/workflows/event-map.workflow.js +33 -0
- package/lib/esm/workflows/event-map.workflow.js.map +1 -0
- package/lib/esm/workflows/foreach-break.workflow.js +54 -0
- package/lib/esm/workflows/foreach-break.workflow.js.map +1 -0
- package/lib/esm/workflows/human-approval.workflow.js +40 -0
- package/lib/esm/workflows/human-approval.workflow.js.map +1 -0
- package/lib/esm/workflows/if-switch.workflow.js +62 -0
- package/lib/esm/workflows/if-switch.workflow.js.map +1 -0
- package/lib/esm/workflows/index.js +116 -0
- package/lib/esm/workflows/index.js.map +1 -0
- package/lib/esm/workflows/loops-while-until.workflow.js +72 -0
- package/lib/esm/workflows/loops-while-until.workflow.js.map +1 -0
- package/lib/esm/workflows/manual-log.workflow.js +48 -0
- package/lib/esm/workflows/manual-log.workflow.js.map +1 -0
- package/lib/esm/workflows/schedule-code.workflow.js +38 -0
- package/lib/esm/workflows/schedule-code.workflow.js.map +1 -0
- package/lib/esm/workflows/types.js +2 -0
- package/lib/esm/workflows/types.js.map +1 -0
- package/lib/esm/workflows/value-templates.workflow.js +39 -0
- package/lib/esm/workflows/value-templates.workflow.js.map +1 -0
- package/lib/esm/workflows/webhook-form.workflow.js +44 -0
- package/lib/esm/workflows/webhook-form.workflow.js.map +1 -0
- package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +7 -0
- package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +7 -0
- package/lib/types/engine/execution/GraphCodeMode.d.cts +46 -0
- package/lib/types/engine/execution/GraphCodeMode.d.mts +46 -0
- package/lib/types/engine/execution/GraphExecutionBackend.d.cts +21 -0
- package/lib/types/engine/execution/GraphExecutionBackend.d.mts +21 -0
- package/lib/types/engine/execution/GraphExecutionEngine.d.cts +28 -3
- package/lib/types/engine/execution/GraphExecutionEngine.d.mts +28 -3
- package/lib/types/engine/validation/GraphNodeInstanceValidator.d.cts +11 -1
- package/lib/types/engine/validation/GraphNodeInstanceValidator.d.mts +11 -1
- package/lib/types/engine/validation/GraphWorkflowDocumentValidator.d.cts +7 -0
- package/lib/types/engine/validation/GraphWorkflowDocumentValidator.d.mts +7 -0
- package/lib/types/mastra/MastraWorkflowCompiler.d.cts +23 -8
- package/lib/types/mastra/MastraWorkflowCompiler.d.mts +23 -8
- package/lib/types/nest/graph/GraphEngineController.d.cts +19 -0
- package/lib/types/nest/graph/GraphEngineController.d.mts +19 -0
- package/lib/types/nest/graph/GraphNodeCatalogueController.d.cts +13 -0
- package/lib/types/nest/graph/GraphNodeCatalogueController.d.mts +13 -0
- package/lib/types/nest/graph/GraphRunController.d.cts +16 -0
- package/lib/types/nest/graph/GraphRunController.d.mts +16 -0
- package/lib/types/nest/graph/GraphWorkflowController.d.cts +26 -3
- package/lib/types/nest/graph/GraphWorkflowController.d.mts +26 -3
- package/lib/types/node/comms/discord/node.d.cts +67 -0
- package/lib/types/node/comms/discord/node.d.mts +67 -0
- package/lib/types/node/comms/outlook/node.d.cts +77 -0
- package/lib/types/node/comms/outlook/node.d.mts +77 -0
- package/lib/types/node/comms/whatsapp/node.d.cts +71 -0
- package/lib/types/node/comms/whatsapp/node.d.mts +71 -0
- package/lib/types/node/data/aggregate/node.d.cts +58 -0
- package/lib/types/node/data/aggregate/node.d.mts +58 -0
- package/lib/types/node/data/compare-datasets/node.d.cts +72 -0
- package/lib/types/node/data/compare-datasets/node.d.mts +72 -0
- package/lib/types/node/data/item-lists/node.d.cts +92 -0
- package/lib/types/node/data/item-lists/node.d.mts +92 -0
- package/lib/types/node/data/remove-duplicates/node.d.cts +47 -0
- package/lib/types/node/data/remove-duplicates/node.d.mts +47 -0
- package/lib/types/node/data/summarize/node.d.cts +44 -0
- package/lib/types/node/data/summarize/node.d.mts +44 -0
- package/lib/types/node/data/support.d.cts +13 -0
- package/lib/types/node/data/support.d.mts +13 -0
- package/lib/types/node/data/transform-utils.d.cts +236 -0
- package/lib/types/node/data/transform-utils.d.mts +236 -0
- package/lib/types/node/index.d.cts +54 -6
- package/lib/types/node/index.d.mts +54 -6
- package/lib/types/node/io/confluence/node.d.cts +49 -0
- package/lib/types/node/io/confluence/node.d.mts +49 -0
- package/lib/types/node/io/convert-to-file/node.d.cts +75 -0
- package/lib/types/node/io/convert-to-file/node.d.mts +75 -0
- package/lib/types/node/io/file-support.d.cts +118 -0
- package/lib/types/node/io/file-support.d.mts +118 -0
- package/lib/types/node/io/google-calendar/node.d.cts +65 -0
- package/lib/types/node/io/google-calendar/node.d.mts +65 -0
- package/lib/types/node/io/google-docs/node.d.cts +51 -0
- package/lib/types/node/io/google-docs/node.d.mts +51 -0
- package/lib/types/node/io/html/node.d.cts +68 -0
- package/lib/types/node/io/html/node.d.mts +68 -0
- package/lib/types/node/io/html-extract/node.d.cts +42 -0
- package/lib/types/node/io/html-extract/node.d.mts +42 -0
- package/lib/types/node/io/html-support.d.cts +69 -0
- package/lib/types/node/io/html-support.d.mts +69 -0
- package/lib/types/node/io/jira/node.d.cts +57 -0
- package/lib/types/node/io/jira/node.d.mts +57 -0
- package/lib/types/node/io/markdown/node.d.cts +61 -0
- package/lib/types/node/io/markdown/node.d.mts +61 -0
- package/lib/types/node/io/microsoft-excel/node.d.cts +45 -0
- package/lib/types/node/io/microsoft-excel/node.d.mts +45 -0
- package/lib/types/node/io/microsoft-sharepoint/node.d.cts +47 -0
- package/lib/types/node/io/microsoft-sharepoint/node.d.mts +47 -0
- package/lib/types/node/io/read-binary-file/node.d.cts +45 -0
- package/lib/types/node/io/read-binary-file/node.d.mts +45 -0
- package/lib/types/node/io/read-binary-files/node.d.cts +41 -0
- package/lib/types/node/io/read-binary-files/node.d.mts +41 -0
- package/lib/types/node/io/write-binary-file/node.d.cts +55 -0
- package/lib/types/node/io/write-binary-file/node.d.mts +55 -0
- package/lib/types/node/io/xml/node.d.cts +67 -0
- package/lib/types/node/io/xml/node.d.mts +67 -0
- package/lib/types/node/storage/rabbitmq/node.d.cts +55 -0
- package/lib/types/node/storage/rabbitmq/node.d.mts +55 -0
- package/lib/types/node/triggers/error/node.d.cts +34 -0
- package/lib/types/node/triggers/error/node.d.mts +34 -0
- package/lib/types/node/triggers/postgres/node.d.cts +54 -0
- package/lib/types/node/triggers/postgres/node.d.mts +54 -0
- package/lib/types/node/triggers/rabbitmq/node.d.cts +59 -0
- package/lib/types/node/triggers/rabbitmq/node.d.mts +59 -0
- package/lib/types/node/triggers/redis/node.d.cts +53 -0
- package/lib/types/node/triggers/redis/node.d.mts +53 -0
- package/lib/types/node/triggers/sse/node.d.cts +43 -0
- package/lib/types/node/triggers/sse/node.d.mts +43 -0
- package/lib/types/node/triggers/support.d.cts +41 -0
- package/lib/types/node/triggers/support.d.mts +41 -0
- package/lib/types/node/triggers/workflow/node.d.cts +46 -0
- package/lib/types/node/triggers/workflow/node.d.mts +46 -0
- package/lib/types/workflows/boundary-value.workflow.d.cts +3 -0
- package/lib/types/workflows/boundary-value.workflow.d.mts +3 -0
- package/lib/types/workflows/builders.d.cts +31 -0
- package/lib/types/workflows/builders.d.mts +31 -0
- package/lib/types/workflows/chat-agent.workflow.d.cts +3 -0
- package/lib/types/workflows/chat-agent.workflow.d.mts +3 -0
- package/lib/types/workflows/error-boundary.workflow.d.cts +3 -0
- package/lib/types/workflows/error-boundary.workflow.d.mts +3 -0
- package/lib/types/workflows/event-map.workflow.d.cts +3 -0
- package/lib/types/workflows/event-map.workflow.d.mts +3 -0
- package/lib/types/workflows/foreach-break.workflow.d.cts +3 -0
- package/lib/types/workflows/foreach-break.workflow.d.mts +3 -0
- package/lib/types/workflows/human-approval.workflow.d.cts +3 -0
- package/lib/types/workflows/human-approval.workflow.d.mts +3 -0
- package/lib/types/workflows/if-switch.workflow.d.cts +3 -0
- package/lib/types/workflows/if-switch.workflow.d.mts +3 -0
- package/lib/types/workflows/index.d.cts +37 -0
- package/lib/types/workflows/index.d.mts +37 -0
- package/lib/types/workflows/loops-while-until.workflow.d.cts +3 -0
- package/lib/types/workflows/loops-while-until.workflow.d.mts +3 -0
- package/lib/types/workflows/manual-log.workflow.d.cts +3 -0
- package/lib/types/workflows/manual-log.workflow.d.mts +3 -0
- package/lib/types/workflows/schedule-code.workflow.d.cts +3 -0
- package/lib/types/workflows/schedule-code.workflow.d.mts +3 -0
- package/lib/types/workflows/types.d.cts +32 -0
- package/lib/types/workflows/types.d.mts +32 -0
- package/lib/types/workflows/value-templates.workflow.d.cts +16 -0
- package/lib/types/workflows/value-templates.workflow.d.mts +16 -0
- package/lib/types/workflows/webhook-form.workflow.d.cts +3 -0
- package/lib/types/workflows/webhook-form.workflow.d.mts +3 -0
- package/package.json +247 -25
|
@@ -0,0 +1,236 @@
|
|
|
1
|
+
/** Field list accepted from node configuration: comma-separated text or an array of names. */
|
|
2
|
+
export type GraphFieldList = string | string[];
|
|
3
|
+
/**
|
|
4
|
+
* Normalizes a configured field list into trimmed, non-empty names.
|
|
5
|
+
*
|
|
6
|
+
* @param value - Comma-separated string, string array, or nil.
|
|
7
|
+
* @param fieldName - Label used in the validation error (default `Fields`).
|
|
8
|
+
* @returns The normalized field names; an empty array for nil input.
|
|
9
|
+
* @throws {GraphExecutionError} `GRAPH_DATA_INVALID_FIELDS` when the value is
|
|
10
|
+
* neither a string nor an array of strings.
|
|
11
|
+
*/
|
|
12
|
+
export declare function prepareGraphFields(value: unknown, fieldName?: string): string[];
|
|
13
|
+
/**
|
|
14
|
+
* Converts a field path into an aggregation-key-safe name by removing
|
|
15
|
+
* brackets/quotes and replacing spaces and dots with underscores.
|
|
16
|
+
*
|
|
17
|
+
* @param name - The raw field name.
|
|
18
|
+
* @returns The normalized field name.
|
|
19
|
+
*/
|
|
20
|
+
export declare function normalizeGraphFieldName(name: string): string;
|
|
21
|
+
/**
|
|
22
|
+
* Builds a deterministic JSON signature for a value, used for deduplication
|
|
23
|
+
* and grouping.
|
|
24
|
+
*
|
|
25
|
+
* Object keys are sorted, dates become ISO strings, `NaN`, `undefined`, and
|
|
26
|
+
* bigint values get explicit markers, and arrays/records are normalized
|
|
27
|
+
* recursively so equal data always yields the same key.
|
|
28
|
+
*
|
|
29
|
+
* @param value - The value to serialize.
|
|
30
|
+
* @returns The stable signature string.
|
|
31
|
+
* @throws {GraphExecutionError} `GRAPH_DATA_UNSAFE_PATH` when a record key is
|
|
32
|
+
* a reserved prototype-pollution segment.
|
|
33
|
+
*/
|
|
34
|
+
export declare function stableGraphKey(value: unknown): string;
|
|
35
|
+
/**
|
|
36
|
+
* Strict deep equality for graph data.
|
|
37
|
+
*
|
|
38
|
+
* Values compare by identity, `NaN` equals `NaN`, dates compare by timestamp,
|
|
39
|
+
* and arrays/records compare recursively with matching keys and lengths.
|
|
40
|
+
*
|
|
41
|
+
* @param left - First value.
|
|
42
|
+
* @param right - Second value.
|
|
43
|
+
* @returns `true` when both values are deeply equal.
|
|
44
|
+
*/
|
|
45
|
+
export declare function graphValueEquals(left: unknown, right: unknown): boolean;
|
|
46
|
+
/**
|
|
47
|
+
* Fuzzy equality used by the Compare Datasets node when `fuzzyCompare` is on.
|
|
48
|
+
*
|
|
49
|
+
* Besides strict equality it treats empty values (`null`, `undefined`, `""`,
|
|
50
|
+
* `false`, empty arrays/records) as equivalent, compares numeric strings to
|
|
51
|
+
* numbers, and parses JSON strings before comparing them to records.
|
|
52
|
+
*
|
|
53
|
+
* @param left - First value.
|
|
54
|
+
* @param right - Second value.
|
|
55
|
+
* @returns `true` when the values are loosely equivalent.
|
|
56
|
+
*/
|
|
57
|
+
export declare function graphValuesLooselyEqual(left: unknown, right: unknown): boolean;
|
|
58
|
+
/**
|
|
59
|
+
* Collects the leaf field paths of a value using dot notation or flat keys.
|
|
60
|
+
*
|
|
61
|
+
* Nested records recurse; arrays and scalars produce the current path. An
|
|
62
|
+
* empty record yields its own path (or no path at the root).
|
|
63
|
+
*
|
|
64
|
+
* @param value - The value to inspect.
|
|
65
|
+
* @param dotNotation - Whether nested records produce dot-separated paths.
|
|
66
|
+
* @param prefix - Accumulated path segments (used by recursion).
|
|
67
|
+
* @returns The collected field paths.
|
|
68
|
+
*/
|
|
69
|
+
export declare function collectGraphFieldPaths(value: unknown, dotNotation: boolean, prefix?: string[]): string[];
|
|
70
|
+
/**
|
|
71
|
+
* Returns a shallow copy of a record without the configured fields.
|
|
72
|
+
*
|
|
73
|
+
* @param value - The source value; non-records are returned unchanged.
|
|
74
|
+
* @param fields - Field paths to remove.
|
|
75
|
+
* @param dotNotation - Whether field paths use dot notation.
|
|
76
|
+
* @returns The record without the omitted fields.
|
|
77
|
+
*/
|
|
78
|
+
export declare function omitGraphFields(value: unknown, fields: string[], dotNotation: boolean): unknown;
|
|
79
|
+
/**
|
|
80
|
+
* Builds a record containing only the requested field paths.
|
|
81
|
+
*
|
|
82
|
+
* @param value - The source value; non-records are returned unchanged.
|
|
83
|
+
* @param fields - Field paths to keep.
|
|
84
|
+
* @param dotNotation - Whether field paths use dot notation.
|
|
85
|
+
* @returns The projected record.
|
|
86
|
+
*/
|
|
87
|
+
export declare function projectGraphRecord(value: unknown, fields: string[], dotNotation: boolean): unknown;
|
|
88
|
+
/** Configuration for one aggregated source field. */
|
|
89
|
+
export interface AggregateFieldSpec {
|
|
90
|
+
field?: string;
|
|
91
|
+
fieldToAggregate?: string;
|
|
92
|
+
renameField?: boolean;
|
|
93
|
+
outputFieldName?: string;
|
|
94
|
+
}
|
|
95
|
+
/** Options controlling `aggregateGraphItems` path and missing-value handling. */
|
|
96
|
+
export interface AggregateOptions {
|
|
97
|
+
dotNotation?: boolean;
|
|
98
|
+
mergeLists?: boolean;
|
|
99
|
+
keepMissing?: boolean;
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* Aggregates one output list of values per configured source field.
|
|
103
|
+
*
|
|
104
|
+
* Array values are flattened when `mergeLists` is set; `null`/`undefined`
|
|
105
|
+
* values are skipped unless `keepMissing` is set. Duplicate output names are
|
|
106
|
+
* rejected so no field is silently overwritten.
|
|
107
|
+
*
|
|
108
|
+
* @param items - The items to aggregate.
|
|
109
|
+
* @param fields - Source fields and their output options.
|
|
110
|
+
* @param options - Path, list-merging, and missing-value options.
|
|
111
|
+
* @returns A record keyed by output field name.
|
|
112
|
+
* @throws {GraphExecutionError} `GRAPH_AGGREGATE_DUPLICATE_FIELD` when two
|
|
113
|
+
* specs map to the same output field, or `GRAPH_DATA_UNSAFE_PATH` when an
|
|
114
|
+
* output field is a reserved prototype-pollution segment.
|
|
115
|
+
*/
|
|
116
|
+
export declare function aggregateGraphItems(items: unknown[], fields: AggregateFieldSpec[], options?: AggregateOptions): Record<string, unknown>;
|
|
117
|
+
/** Field projection options for `aggregateGraphItemData`. */
|
|
118
|
+
export interface AggregateAllOptions {
|
|
119
|
+
include?: "allFields" | "specifiedFields" | "allFieldsExcept";
|
|
120
|
+
fieldsToInclude?: string[];
|
|
121
|
+
fieldsToExclude?: string[];
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Groups every item into a projected record, dropping empty projections.
|
|
125
|
+
*
|
|
126
|
+
* @param items - The items to collect.
|
|
127
|
+
* @param options - Projection mode and the include/exclude field lists.
|
|
128
|
+
* @returns The projected item records.
|
|
129
|
+
* @throws {GraphExecutionError} `GRAPH_DATA_UNSAFE_PATH` when a projected key
|
|
130
|
+
* is a reserved prototype-pollution segment.
|
|
131
|
+
*/
|
|
132
|
+
export declare function aggregateGraphItemData(items: unknown[], options?: AggregateAllOptions): Array<Record<string, unknown>>;
|
|
133
|
+
/** One sort key and its direction. */
|
|
134
|
+
export interface SortSpec {
|
|
135
|
+
field: string;
|
|
136
|
+
direction?: "asc" | "desc";
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* Returns a sorted copy of the items using the configured keys.
|
|
140
|
+
*
|
|
141
|
+
* Keys apply in order; the first non-zero comparison wins and `desc` reverses
|
|
142
|
+
* that key's comparison. An empty usable field list returns the input order.
|
|
143
|
+
*
|
|
144
|
+
* @param items - The items to sort.
|
|
145
|
+
* @param fields - Sort keys and directions.
|
|
146
|
+
* @param dotNotation - Whether field paths use dot notation.
|
|
147
|
+
* @param valueType - Coercion used for comparisons (default `auto`).
|
|
148
|
+
* @returns The sorted items.
|
|
149
|
+
*/
|
|
150
|
+
export declare function sortGraphItems(items: unknown[], fields: SortSpec[], dotNotation: boolean, valueType?: "auto" | "string" | "number" | "date"): unknown[];
|
|
151
|
+
/** Options for `splitGraphOutItems`. */
|
|
152
|
+
export interface SplitOutOptions {
|
|
153
|
+
include?: "noOtherFields" | "allOtherFields";
|
|
154
|
+
destinationField?: string;
|
|
155
|
+
dotNotation?: boolean;
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* Expands an array-valued field into one output item per value.
|
|
159
|
+
*
|
|
160
|
+
* Missing values are skipped. With `include: "allOtherFields"` each output
|
|
161
|
+
* keeps the other item fields and receives the value under `destinationField`
|
|
162
|
+
* (defaults to the split field).
|
|
163
|
+
*
|
|
164
|
+
* @param items - The items to split.
|
|
165
|
+
* @param field - The array-valued field path.
|
|
166
|
+
* @param options - Field retention and destination options.
|
|
167
|
+
* @returns The split-out items.
|
|
168
|
+
*/
|
|
169
|
+
export declare function splitGraphOutItems(items: unknown[], field: string, options?: SplitOutOptions): unknown[];
|
|
170
|
+
/** Field selection used for duplicate comparison. */
|
|
171
|
+
export type CompareMode = "allFields" | "allFieldsExcept" | "selectedFields";
|
|
172
|
+
/** Options for `dedupeGraphItems`. */
|
|
173
|
+
export interface DedupeOptions {
|
|
174
|
+
compare?: CompareMode;
|
|
175
|
+
fieldsToExclude?: GraphFieldList;
|
|
176
|
+
fieldsToCompare?: GraphFieldList;
|
|
177
|
+
removeOtherFields?: boolean;
|
|
178
|
+
dotNotation?: boolean;
|
|
179
|
+
}
|
|
180
|
+
/** Unique and discarded items produced by `dedupeGraphItems`. */
|
|
181
|
+
export interface DedupeResult {
|
|
182
|
+
kept: unknown[];
|
|
183
|
+
discarded: unknown[];
|
|
184
|
+
}
|
|
185
|
+
/**
|
|
186
|
+
* Keeps the first item of each comparison signature.
|
|
187
|
+
*
|
|
188
|
+
* Signatures are built from every field, every field except the excluded
|
|
189
|
+
* list, or the selected field list. `removeOtherFields` projects kept items
|
|
190
|
+
* onto the compared fields.
|
|
191
|
+
*
|
|
192
|
+
* @param items - The items to deduplicate.
|
|
193
|
+
* @param options - Comparison mode, field lists, and projection option.
|
|
194
|
+
* @returns The unique items and the duplicates removed.
|
|
195
|
+
* @throws {GraphExecutionError} `GRAPH_REMOVE_DUPLICATES_FIELDS_REQUIRED` when
|
|
196
|
+
* the chosen mode has no field list, or
|
|
197
|
+
* `GRAPH_REMOVE_DUPLICATES_FIELD_MISSING` when selected fields are absent
|
|
198
|
+
* from every item.
|
|
199
|
+
*/
|
|
200
|
+
export declare function dedupeGraphItems(items: unknown[], options?: DedupeOptions): DedupeResult;
|
|
201
|
+
/** Aggregations supported by the summarize engine. */
|
|
202
|
+
export type SummarizeAggregation = "append" | "average" | "concatenate" | "count" | "countUnique" | "max" | "min" | "sum";
|
|
203
|
+
/** One summarize aggregation applied to a field. */
|
|
204
|
+
export interface SummarizeField {
|
|
205
|
+
aggregation: SummarizeAggregation;
|
|
206
|
+
field?: string;
|
|
207
|
+
includeEmpty?: boolean;
|
|
208
|
+
separator?: string;
|
|
209
|
+
customSeparator?: string;
|
|
210
|
+
}
|
|
211
|
+
/** Options for `summarizeGraphItems`. */
|
|
212
|
+
export interface SummarizeOptions {
|
|
213
|
+
fieldsToSplitBy?: GraphFieldList;
|
|
214
|
+
outputFormat?: "separateItems" | "singleItem";
|
|
215
|
+
skipEmptySplitFields?: boolean;
|
|
216
|
+
dotNotation?: boolean;
|
|
217
|
+
continueIfFieldNotFound?: boolean;
|
|
218
|
+
}
|
|
219
|
+
/**
|
|
220
|
+
* Summarizes items by zero or more split fields.
|
|
221
|
+
*
|
|
222
|
+
* With no split fields it returns a single record. Otherwise it builds nested
|
|
223
|
+
* groups and emits either one record per leaf group (`separateItems`) or one
|
|
224
|
+
* nested record (`singleItem`). Unless `continueIfFieldNotFound` is set, a
|
|
225
|
+
* referenced field that is absent from every item fails the node.
|
|
226
|
+
*
|
|
227
|
+
* @param items - The items to summarize.
|
|
228
|
+
* @param aggregations - Aggregations to compute per group.
|
|
229
|
+
* @param options - Split fields, output format, empty-field and path options.
|
|
230
|
+
* @returns The summary records.
|
|
231
|
+
* @throws {GraphExecutionError} `GRAPH_SUMMARIZE_FIELD_NOT_FOUND` when a
|
|
232
|
+
* referenced field is absent from every item, or `GRAPH_DATA_UNSAFE_PATH`
|
|
233
|
+
* when a field-derived output or grouping key is a reserved
|
|
234
|
+
* prototype-pollution segment.
|
|
235
|
+
*/
|
|
236
|
+
export declare function summarizeGraphItems(items: unknown[], aggregations: SummarizeField[], options?: SummarizeOptions): Record<string, unknown>[];
|
|
@@ -0,0 +1,236 @@
|
|
|
1
|
+
/** Field list accepted from node configuration: comma-separated text or an array of names. */
|
|
2
|
+
export type GraphFieldList = string | string[];
|
|
3
|
+
/**
|
|
4
|
+
* Normalizes a configured field list into trimmed, non-empty names.
|
|
5
|
+
*
|
|
6
|
+
* @param value - Comma-separated string, string array, or nil.
|
|
7
|
+
* @param fieldName - Label used in the validation error (default `Fields`).
|
|
8
|
+
* @returns The normalized field names; an empty array for nil input.
|
|
9
|
+
* @throws {GraphExecutionError} `GRAPH_DATA_INVALID_FIELDS` when the value is
|
|
10
|
+
* neither a string nor an array of strings.
|
|
11
|
+
*/
|
|
12
|
+
export declare function prepareGraphFields(value: unknown, fieldName?: string): string[];
|
|
13
|
+
/**
|
|
14
|
+
* Converts a field path into an aggregation-key-safe name by removing
|
|
15
|
+
* brackets/quotes and replacing spaces and dots with underscores.
|
|
16
|
+
*
|
|
17
|
+
* @param name - The raw field name.
|
|
18
|
+
* @returns The normalized field name.
|
|
19
|
+
*/
|
|
20
|
+
export declare function normalizeGraphFieldName(name: string): string;
|
|
21
|
+
/**
|
|
22
|
+
* Builds a deterministic JSON signature for a value, used for deduplication
|
|
23
|
+
* and grouping.
|
|
24
|
+
*
|
|
25
|
+
* Object keys are sorted, dates become ISO strings, `NaN`, `undefined`, and
|
|
26
|
+
* bigint values get explicit markers, and arrays/records are normalized
|
|
27
|
+
* recursively so equal data always yields the same key.
|
|
28
|
+
*
|
|
29
|
+
* @param value - The value to serialize.
|
|
30
|
+
* @returns The stable signature string.
|
|
31
|
+
* @throws {GraphExecutionError} `GRAPH_DATA_UNSAFE_PATH` when a record key is
|
|
32
|
+
* a reserved prototype-pollution segment.
|
|
33
|
+
*/
|
|
34
|
+
export declare function stableGraphKey(value: unknown): string;
|
|
35
|
+
/**
|
|
36
|
+
* Strict deep equality for graph data.
|
|
37
|
+
*
|
|
38
|
+
* Values compare by identity, `NaN` equals `NaN`, dates compare by timestamp,
|
|
39
|
+
* and arrays/records compare recursively with matching keys and lengths.
|
|
40
|
+
*
|
|
41
|
+
* @param left - First value.
|
|
42
|
+
* @param right - Second value.
|
|
43
|
+
* @returns `true` when both values are deeply equal.
|
|
44
|
+
*/
|
|
45
|
+
export declare function graphValueEquals(left: unknown, right: unknown): boolean;
|
|
46
|
+
/**
|
|
47
|
+
* Fuzzy equality used by the Compare Datasets node when `fuzzyCompare` is on.
|
|
48
|
+
*
|
|
49
|
+
* Besides strict equality it treats empty values (`null`, `undefined`, `""`,
|
|
50
|
+
* `false`, empty arrays/records) as equivalent, compares numeric strings to
|
|
51
|
+
* numbers, and parses JSON strings before comparing them to records.
|
|
52
|
+
*
|
|
53
|
+
* @param left - First value.
|
|
54
|
+
* @param right - Second value.
|
|
55
|
+
* @returns `true` when the values are loosely equivalent.
|
|
56
|
+
*/
|
|
57
|
+
export declare function graphValuesLooselyEqual(left: unknown, right: unknown): boolean;
|
|
58
|
+
/**
|
|
59
|
+
* Collects the leaf field paths of a value using dot notation or flat keys.
|
|
60
|
+
*
|
|
61
|
+
* Nested records recurse; arrays and scalars produce the current path. An
|
|
62
|
+
* empty record yields its own path (or no path at the root).
|
|
63
|
+
*
|
|
64
|
+
* @param value - The value to inspect.
|
|
65
|
+
* @param dotNotation - Whether nested records produce dot-separated paths.
|
|
66
|
+
* @param prefix - Accumulated path segments (used by recursion).
|
|
67
|
+
* @returns The collected field paths.
|
|
68
|
+
*/
|
|
69
|
+
export declare function collectGraphFieldPaths(value: unknown, dotNotation: boolean, prefix?: string[]): string[];
|
|
70
|
+
/**
|
|
71
|
+
* Returns a shallow copy of a record without the configured fields.
|
|
72
|
+
*
|
|
73
|
+
* @param value - The source value; non-records are returned unchanged.
|
|
74
|
+
* @param fields - Field paths to remove.
|
|
75
|
+
* @param dotNotation - Whether field paths use dot notation.
|
|
76
|
+
* @returns The record without the omitted fields.
|
|
77
|
+
*/
|
|
78
|
+
export declare function omitGraphFields(value: unknown, fields: string[], dotNotation: boolean): unknown;
|
|
79
|
+
/**
|
|
80
|
+
* Builds a record containing only the requested field paths.
|
|
81
|
+
*
|
|
82
|
+
* @param value - The source value; non-records are returned unchanged.
|
|
83
|
+
* @param fields - Field paths to keep.
|
|
84
|
+
* @param dotNotation - Whether field paths use dot notation.
|
|
85
|
+
* @returns The projected record.
|
|
86
|
+
*/
|
|
87
|
+
export declare function projectGraphRecord(value: unknown, fields: string[], dotNotation: boolean): unknown;
|
|
88
|
+
/** Configuration for one aggregated source field. */
|
|
89
|
+
export interface AggregateFieldSpec {
|
|
90
|
+
field?: string;
|
|
91
|
+
fieldToAggregate?: string;
|
|
92
|
+
renameField?: boolean;
|
|
93
|
+
outputFieldName?: string;
|
|
94
|
+
}
|
|
95
|
+
/** Options controlling `aggregateGraphItems` path and missing-value handling. */
|
|
96
|
+
export interface AggregateOptions {
|
|
97
|
+
dotNotation?: boolean;
|
|
98
|
+
mergeLists?: boolean;
|
|
99
|
+
keepMissing?: boolean;
|
|
100
|
+
}
|
|
101
|
+
/**
|
|
102
|
+
* Aggregates one output list of values per configured source field.
|
|
103
|
+
*
|
|
104
|
+
* Array values are flattened when `mergeLists` is set; `null`/`undefined`
|
|
105
|
+
* values are skipped unless `keepMissing` is set. Duplicate output names are
|
|
106
|
+
* rejected so no field is silently overwritten.
|
|
107
|
+
*
|
|
108
|
+
* @param items - The items to aggregate.
|
|
109
|
+
* @param fields - Source fields and their output options.
|
|
110
|
+
* @param options - Path, list-merging, and missing-value options.
|
|
111
|
+
* @returns A record keyed by output field name.
|
|
112
|
+
* @throws {GraphExecutionError} `GRAPH_AGGREGATE_DUPLICATE_FIELD` when two
|
|
113
|
+
* specs map to the same output field, or `GRAPH_DATA_UNSAFE_PATH` when an
|
|
114
|
+
* output field is a reserved prototype-pollution segment.
|
|
115
|
+
*/
|
|
116
|
+
export declare function aggregateGraphItems(items: unknown[], fields: AggregateFieldSpec[], options?: AggregateOptions): Record<string, unknown>;
|
|
117
|
+
/** Field projection options for `aggregateGraphItemData`. */
|
|
118
|
+
export interface AggregateAllOptions {
|
|
119
|
+
include?: "allFields" | "specifiedFields" | "allFieldsExcept";
|
|
120
|
+
fieldsToInclude?: string[];
|
|
121
|
+
fieldsToExclude?: string[];
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Groups every item into a projected record, dropping empty projections.
|
|
125
|
+
*
|
|
126
|
+
* @param items - The items to collect.
|
|
127
|
+
* @param options - Projection mode and the include/exclude field lists.
|
|
128
|
+
* @returns The projected item records.
|
|
129
|
+
* @throws {GraphExecutionError} `GRAPH_DATA_UNSAFE_PATH` when a projected key
|
|
130
|
+
* is a reserved prototype-pollution segment.
|
|
131
|
+
*/
|
|
132
|
+
export declare function aggregateGraphItemData(items: unknown[], options?: AggregateAllOptions): Array<Record<string, unknown>>;
|
|
133
|
+
/** One sort key and its direction. */
|
|
134
|
+
export interface SortSpec {
|
|
135
|
+
field: string;
|
|
136
|
+
direction?: "asc" | "desc";
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* Returns a sorted copy of the items using the configured keys.
|
|
140
|
+
*
|
|
141
|
+
* Keys apply in order; the first non-zero comparison wins and `desc` reverses
|
|
142
|
+
* that key's comparison. An empty usable field list returns the input order.
|
|
143
|
+
*
|
|
144
|
+
* @param items - The items to sort.
|
|
145
|
+
* @param fields - Sort keys and directions.
|
|
146
|
+
* @param dotNotation - Whether field paths use dot notation.
|
|
147
|
+
* @param valueType - Coercion used for comparisons (default `auto`).
|
|
148
|
+
* @returns The sorted items.
|
|
149
|
+
*/
|
|
150
|
+
export declare function sortGraphItems(items: unknown[], fields: SortSpec[], dotNotation: boolean, valueType?: "auto" | "string" | "number" | "date"): unknown[];
|
|
151
|
+
/** Options for `splitGraphOutItems`. */
|
|
152
|
+
export interface SplitOutOptions {
|
|
153
|
+
include?: "noOtherFields" | "allOtherFields";
|
|
154
|
+
destinationField?: string;
|
|
155
|
+
dotNotation?: boolean;
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* Expands an array-valued field into one output item per value.
|
|
159
|
+
*
|
|
160
|
+
* Missing values are skipped. With `include: "allOtherFields"` each output
|
|
161
|
+
* keeps the other item fields and receives the value under `destinationField`
|
|
162
|
+
* (defaults to the split field).
|
|
163
|
+
*
|
|
164
|
+
* @param items - The items to split.
|
|
165
|
+
* @param field - The array-valued field path.
|
|
166
|
+
* @param options - Field retention and destination options.
|
|
167
|
+
* @returns The split-out items.
|
|
168
|
+
*/
|
|
169
|
+
export declare function splitGraphOutItems(items: unknown[], field: string, options?: SplitOutOptions): unknown[];
|
|
170
|
+
/** Field selection used for duplicate comparison. */
|
|
171
|
+
export type CompareMode = "allFields" | "allFieldsExcept" | "selectedFields";
|
|
172
|
+
/** Options for `dedupeGraphItems`. */
|
|
173
|
+
export interface DedupeOptions {
|
|
174
|
+
compare?: CompareMode;
|
|
175
|
+
fieldsToExclude?: GraphFieldList;
|
|
176
|
+
fieldsToCompare?: GraphFieldList;
|
|
177
|
+
removeOtherFields?: boolean;
|
|
178
|
+
dotNotation?: boolean;
|
|
179
|
+
}
|
|
180
|
+
/** Unique and discarded items produced by `dedupeGraphItems`. */
|
|
181
|
+
export interface DedupeResult {
|
|
182
|
+
kept: unknown[];
|
|
183
|
+
discarded: unknown[];
|
|
184
|
+
}
|
|
185
|
+
/**
|
|
186
|
+
* Keeps the first item of each comparison signature.
|
|
187
|
+
*
|
|
188
|
+
* Signatures are built from every field, every field except the excluded
|
|
189
|
+
* list, or the selected field list. `removeOtherFields` projects kept items
|
|
190
|
+
* onto the compared fields.
|
|
191
|
+
*
|
|
192
|
+
* @param items - The items to deduplicate.
|
|
193
|
+
* @param options - Comparison mode, field lists, and projection option.
|
|
194
|
+
* @returns The unique items and the duplicates removed.
|
|
195
|
+
* @throws {GraphExecutionError} `GRAPH_REMOVE_DUPLICATES_FIELDS_REQUIRED` when
|
|
196
|
+
* the chosen mode has no field list, or
|
|
197
|
+
* `GRAPH_REMOVE_DUPLICATES_FIELD_MISSING` when selected fields are absent
|
|
198
|
+
* from every item.
|
|
199
|
+
*/
|
|
200
|
+
export declare function dedupeGraphItems(items: unknown[], options?: DedupeOptions): DedupeResult;
|
|
201
|
+
/** Aggregations supported by the summarize engine. */
|
|
202
|
+
export type SummarizeAggregation = "append" | "average" | "concatenate" | "count" | "countUnique" | "max" | "min" | "sum";
|
|
203
|
+
/** One summarize aggregation applied to a field. */
|
|
204
|
+
export interface SummarizeField {
|
|
205
|
+
aggregation: SummarizeAggregation;
|
|
206
|
+
field?: string;
|
|
207
|
+
includeEmpty?: boolean;
|
|
208
|
+
separator?: string;
|
|
209
|
+
customSeparator?: string;
|
|
210
|
+
}
|
|
211
|
+
/** Options for `summarizeGraphItems`. */
|
|
212
|
+
export interface SummarizeOptions {
|
|
213
|
+
fieldsToSplitBy?: GraphFieldList;
|
|
214
|
+
outputFormat?: "separateItems" | "singleItem";
|
|
215
|
+
skipEmptySplitFields?: boolean;
|
|
216
|
+
dotNotation?: boolean;
|
|
217
|
+
continueIfFieldNotFound?: boolean;
|
|
218
|
+
}
|
|
219
|
+
/**
|
|
220
|
+
* Summarizes items by zero or more split fields.
|
|
221
|
+
*
|
|
222
|
+
* With no split fields it returns a single record. Otherwise it builds nested
|
|
223
|
+
* groups and emits either one record per leaf group (`separateItems`) or one
|
|
224
|
+
* nested record (`singleItem`). Unless `continueIfFieldNotFound` is set, a
|
|
225
|
+
* referenced field that is absent from every item fails the node.
|
|
226
|
+
*
|
|
227
|
+
* @param items - The items to summarize.
|
|
228
|
+
* @param aggregations - Aggregations to compute per group.
|
|
229
|
+
* @param options - Split fields, output format, empty-field and path options.
|
|
230
|
+
* @returns The summary records.
|
|
231
|
+
* @throws {GraphExecutionError} `GRAPH_SUMMARIZE_FIELD_NOT_FOUND` when a
|
|
232
|
+
* referenced field is absent from every item, or `GRAPH_DATA_UNSAFE_PATH`
|
|
233
|
+
* when a field-derived output or grouping key is a reserved
|
|
234
|
+
* prototype-pollution segment.
|
|
235
|
+
*/
|
|
236
|
+
export declare function summarizeGraphItems(items: unknown[], aggregations: SummarizeField[], options?: SummarizeOptions): Record<string, unknown>[];
|
|
@@ -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),
|
|
11
|
-
* (`core.devops.*`: crypto, JWT, shell command, FTP, GitHub/GitLab),
|
|
12
|
-
* (`core.comms.*`: Slack, Telegram, Teams, Gmail, Email
|
|
13
|
-
* kinds (`core.io.*`: Airtable,
|
|
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.cts";
|
|
|
37
43
|
export * from "./data/set/node.d.cts";
|
|
38
44
|
export * from "./data/sort/node.d.cts";
|
|
39
45
|
export * from "./data/split-out/node.d.cts";
|
|
46
|
+
export * from "./data/aggregate/node.d.cts";
|
|
47
|
+
export * from "./data/item-lists/node.d.cts";
|
|
48
|
+
export * from "./data/compare-datasets/node.d.cts";
|
|
49
|
+
export * from "./data/summarize/node.d.cts";
|
|
50
|
+
export * from "./data/remove-duplicates/node.d.cts";
|
|
40
51
|
export * from "./io/extract-from-file/node.d.cts";
|
|
41
52
|
export * from "./io/http-request/node.d.cts";
|
|
42
53
|
export * from "./io/read-pdf/node.d.cts";
|
|
@@ -46,6 +57,7 @@ export * from "./storage/database/postgres/node.d.cts";
|
|
|
46
57
|
export * from "./storage/database/mysql/node.d.cts";
|
|
47
58
|
export * from "./storage/database/mssql/node.d.cts";
|
|
48
59
|
export * from "./storage/redis/node.d.cts";
|
|
60
|
+
export * from "./storage/rabbitmq/node.d.cts";
|
|
49
61
|
export * from "./storage/blob/s3/node.d.cts";
|
|
50
62
|
export * from "./storage/blob/gcs/node.d.cts";
|
|
51
63
|
export * from "./storage/blob/azure/node.d.cts";
|
|
@@ -54,10 +66,27 @@ export * from "./comms/telegram/node.d.cts";
|
|
|
54
66
|
export * from "./comms/teams/node.d.cts";
|
|
55
67
|
export * from "./comms/gmail/node.d.cts";
|
|
56
68
|
export * from "./comms/email-send/node.d.cts";
|
|
69
|
+
export * from "./comms/discord/node.d.cts";
|
|
70
|
+
export * from "./comms/whatsapp/node.d.cts";
|
|
71
|
+
export * from "./comms/outlook/node.d.cts";
|
|
57
72
|
export * from "./io/google-sheets/node.d.cts";
|
|
58
73
|
export * from "./io/airtable/node.d.cts";
|
|
59
74
|
export * from "./io/spreadsheet-file/node.d.cts";
|
|
60
75
|
export * from "./io/graphql/node.d.cts";
|
|
76
|
+
export * from "./io/microsoft-excel/node.d.cts";
|
|
77
|
+
export * from "./io/confluence/node.d.cts";
|
|
78
|
+
export * from "./io/jira/node.d.cts";
|
|
79
|
+
export * from "./io/google-docs/node.d.cts";
|
|
80
|
+
export * from "./io/microsoft-sharepoint/node.d.cts";
|
|
81
|
+
export * from "./io/google-calendar/node.d.cts";
|
|
82
|
+
export * from "./io/convert-to-file/node.d.cts";
|
|
83
|
+
export * from "./io/html/node.d.cts";
|
|
84
|
+
export * from "./io/html-extract/node.d.cts";
|
|
85
|
+
export * from "./io/markdown/node.d.cts";
|
|
86
|
+
export * from "./io/xml/node.d.cts";
|
|
87
|
+
export * from "./io/read-binary-file/node.d.cts";
|
|
88
|
+
export * from "./io/read-binary-files/node.d.cts";
|
|
89
|
+
export * from "./io/write-binary-file/node.d.cts";
|
|
61
90
|
export * from "./devops/github/node.d.cts";
|
|
62
91
|
export * from "./devops/gitlab/node.d.cts";
|
|
63
92
|
export * from "./devops/crypto/node.d.cts";
|
|
@@ -72,6 +101,12 @@ export * from "./triggers/form/node.d.cts";
|
|
|
72
101
|
export * from "./triggers/manual/node.d.cts";
|
|
73
102
|
export * from "./triggers/schedule/node.d.cts";
|
|
74
103
|
export * from "./triggers/webhook/node.d.cts";
|
|
104
|
+
export * from "./triggers/error/node.d.cts";
|
|
105
|
+
export * from "./triggers/workflow/node.d.cts";
|
|
106
|
+
export * from "./triggers/rabbitmq/node.d.cts";
|
|
107
|
+
export * from "./triggers/redis/node.d.cts";
|
|
108
|
+
export * from "./triggers/sse/node.d.cts";
|
|
109
|
+
export * from "./triggers/postgres/node.d.cts";
|
|
75
110
|
export * from "./agents/agent/node.d.cts";
|
|
76
111
|
export * from "./agents/zones.d.cts";
|
|
77
112
|
export * from "./agents/tools/tool/node.d.cts";
|
|
@@ -186,11 +221,24 @@ import { RenameKeysNode } from "./data/rename-keys/node.d.cts";
|
|
|
186
221
|
import { SetNode } from "./data/set/node.d.cts";
|
|
187
222
|
import { SortNode } from "./data/sort/node.d.cts";
|
|
188
223
|
import { SplitOutNode } from "./data/split-out/node.d.cts";
|
|
224
|
+
import { AggregateNode } from "./data/aggregate/node.d.cts";
|
|
225
|
+
import { ItemListsNode } from "./data/item-lists/node.d.cts";
|
|
226
|
+
import { CompareDatasetsNode } from "./data/compare-datasets/node.d.cts";
|
|
227
|
+
import { SummarizeNode } from "./data/summarize/node.d.cts";
|
|
228
|
+
import { RemoveDuplicatesNode } from "./data/remove-duplicates/node.d.cts";
|
|
189
229
|
import { ExtractFromFileNode } from "./io/extract-from-file/node.d.cts";
|
|
190
230
|
import { HttpRequestNode } from "./io/http-request/node.d.cts";
|
|
191
231
|
import { ReadPDFNode } from "./io/read-pdf/node.d.cts";
|
|
192
232
|
import { ReadWriteFileNode } from "./io/read-write-file/node.d.cts";
|
|
193
233
|
import { RespondToWebhookNode } from "./io/respond-to-webhook/node.d.cts";
|
|
234
|
+
import { ConvertToFileNode } from "./io/convert-to-file/node.d.cts";
|
|
235
|
+
import { HtmlNode } from "./io/html/node.d.cts";
|
|
236
|
+
import { HtmlExtractNode } from "./io/html-extract/node.d.cts";
|
|
237
|
+
import { MarkdownNode } from "./io/markdown/node.d.cts";
|
|
238
|
+
import { XmlNode } from "./io/xml/node.d.cts";
|
|
239
|
+
import { ReadBinaryFileNode } from "./io/read-binary-file/node.d.cts";
|
|
240
|
+
import { ReadBinaryFilesNode } from "./io/read-binary-files/node.d.cts";
|
|
241
|
+
import { WriteBinaryFileNode } from "./io/write-binary-file/node.d.cts";
|
|
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
|