@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
|
@@ -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.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[]>;
|