@signalwire/sdk 2.0.5 → 3.5.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/CHANGELOG.md +785 -0
- package/LICENSE +21 -0
- package/README.md +163 -68
- package/dist/AGENTS.md +13 -0
- package/dist/AgentBase.d.ts +481 -126
- package/dist/AgentBase.js +1502 -438
- package/dist/AgentBase.js.map +1 -1
- package/dist/AgentServer.d.ts +21 -0
- package/dist/AgentServer.js +154 -47
- package/dist/AgentServer.js.map +1 -1
- package/dist/AuthHandler.d.ts +14 -2
- package/dist/AuthHandler.js +7 -2
- package/dist/AuthHandler.js.map +1 -1
- package/dist/ConfigLoader.d.ts +5 -13
- package/dist/ConfigLoader.js +15 -29
- package/dist/ConfigLoader.js.map +1 -1
- package/dist/ContextBuilder.d.ts +202 -9
- package/dist/ContextBuilder.js +219 -36
- package/dist/ContextBuilder.js.map +1 -1
- package/dist/DataMap.d.ts +158 -45
- package/dist/DataMap.js +167 -52
- package/dist/DataMap.js.map +1 -1
- package/dist/FunctionResult.d.ts +277 -83
- package/dist/FunctionResult.js +444 -116
- package/dist/FunctionResult.js.map +1 -1
- package/dist/Logger.d.ts +30 -5
- package/dist/Logger.js +77 -19
- package/dist/Logger.js.map +1 -1
- package/dist/POM/PromptObjectModel.d.ts +12 -1
- package/dist/POM/PromptObjectModel.js +25 -9
- package/dist/POM/PromptObjectModel.js.map +1 -1
- package/dist/ParameterSchema.d.ts +306 -0
- package/dist/ParameterSchema.js +251 -0
- package/dist/ParameterSchema.js.map +1 -0
- package/dist/PlatformContracts.d.ts +21 -0
- package/dist/PlatformContracts.generated.d.ts +109 -0
- package/dist/PlatformContracts.generated.js +8 -0
- package/dist/PlatformContracts.generated.js.map +1 -0
- package/dist/PlatformContracts.js +2 -0
- package/dist/PlatformContracts.js.map +1 -0
- package/dist/PomBuilder.d.ts +18 -0
- package/dist/PomBuilder.js +53 -3
- package/dist/PomBuilder.js.map +1 -1
- package/dist/PostPrompt.d.ts +110 -0
- package/dist/PostPrompt.js +204 -0
- package/dist/PostPrompt.js.map +1 -0
- package/dist/PromptManager.d.ts +22 -1
- package/dist/PromptManager.js +28 -1
- package/dist/PromptManager.js.map +1 -1
- package/dist/PublicFetch.d.ts +132 -0
- package/dist/PublicFetch.js +311 -0
- package/dist/PublicFetch.js.map +1 -0
- package/dist/RobotsTxt.d.ts +41 -0
- package/dist/RobotsTxt.js +152 -0
- package/dist/RobotsTxt.js.map +1 -0
- package/dist/SWMLHandler.js.map +1 -1
- package/dist/SWMLService.d.ts +158 -58
- package/dist/SWMLService.js +435 -127
- package/dist/SWMLService.js.map +1 -1
- package/dist/SchemaUtils.d.ts +115 -2
- package/dist/SchemaUtils.js +444 -12
- package/dist/SchemaUtils.js.map +1 -1
- package/dist/SecurityUtils.d.ts +49 -9
- package/dist/SecurityUtils.js +153 -51
- package/dist/SecurityUtils.js.map +1 -1
- package/dist/ServerlessAdapter.d.ts +156 -7
- package/dist/ServerlessAdapter.js +399 -42
- package/dist/ServerlessAdapter.js.map +1 -1
- package/dist/SessionManager.d.ts +11 -2
- package/dist/SessionManager.js +50 -18
- package/dist/SessionManager.js.map +1 -1
- package/dist/SslConfig.d.ts +2 -1
- package/dist/SslConfig.js +4 -1
- package/dist/SslConfig.js.map +1 -1
- package/dist/SwaigActions.generated.d.ts +23 -0
- package/dist/SwaigActions.generated.js +8 -0
- package/dist/SwaigActions.generated.js.map +1 -0
- package/dist/SwaigContracts.d.ts +15 -0
- package/dist/SwaigContracts.generated.d.ts +264 -0
- package/dist/SwaigContracts.generated.js +12 -0
- package/dist/SwaigContracts.generated.js.map +1 -0
- package/dist/SwaigContracts.js +2 -0
- package/dist/SwaigContracts.js.map +1 -0
- package/dist/SwaigFunction.d.ts +110 -4
- package/dist/SwaigFunction.js +151 -19
- package/dist/SwaigFunction.js.map +1 -1
- package/dist/SwmlBuilder.d.ts +68 -19
- package/dist/SwmlBuilder.js +74 -38
- package/dist/SwmlBuilder.js.map +1 -1
- package/dist/SwmlVerbMethods.generated.d.ts +41 -4
- package/dist/SwmlVerbMethods.generated.js +1 -1
- package/dist/TypeInference.d.ts +39 -3
- package/dist/TypeInference.js +256 -16
- package/dist/TypeInference.js.map +1 -1
- package/dist/WebService.d.ts +79 -11
- package/dist/WebService.js +320 -109
- package/dist/WebService.js.map +1 -1
- package/dist/WebhookMiddleware.d.ts +119 -0
- package/dist/WebhookMiddleware.js +271 -0
- package/dist/WebhookMiddleware.js.map +1 -0
- package/dist/WebhookValidator.d.ts +92 -0
- package/dist/WebhookValidator.js +409 -0
- package/dist/WebhookValidator.js.map +1 -0
- package/dist/agents/BedrockAgent.d.ts +162 -0
- package/dist/agents/BedrockAgent.js +323 -0
- package/dist/agents/BedrockAgent.js.map +1 -0
- package/dist/ai-chat/AIChatClient.d.ts +316 -0
- package/dist/ai-chat/AIChatClient.js +535 -0
- package/dist/ai-chat/AIChatClient.js.map +1 -0
- package/dist/ai-chat/ChatGateway.d.ts +408 -0
- package/dist/ai-chat/ChatGateway.js +747 -0
- package/dist/ai-chat/ChatGateway.js.map +1 -0
- package/dist/ai-chat/HandoffRouter.d.ts +282 -0
- package/dist/ai-chat/HandoffRouter.js +518 -0
- package/dist/ai-chat/HandoffRouter.js.map +1 -0
- package/dist/ai-chat/index.d.ts +12 -0
- package/dist/ai-chat/index.js +10 -0
- package/dist/ai-chat/index.js.map +1 -0
- package/dist/capabilities.d.ts +64 -0
- package/dist/capabilities.js +95 -0
- package/dist/capabilities.js.map +1 -0
- package/dist/cli/agent-loader.d.ts +32 -6
- package/dist/cli/agent-loader.js +92 -33
- package/dist/cli/agent-loader.js.map +1 -1
- package/dist/cli/datamap-exec.d.ts +175 -0
- package/dist/cli/datamap-exec.js +1284 -0
- package/dist/cli/datamap-exec.js.map +1 -0
- package/dist/cli/function-args.d.ts +40 -0
- package/dist/cli/function-args.js +146 -0
- package/dist/cli/function-args.js.map +1 -0
- package/dist/cli/simulation.d.ts +99 -0
- package/dist/cli/simulation.js +490 -0
- package/dist/cli/simulation.js.map +1 -0
- package/dist/cli/swaig-test.d.ts +12 -25
- package/dist/cli/swaig-test.js +935 -371
- package/dist/cli/swaig-test.js.map +1 -1
- package/dist/cli/tsdocs/agentsNote.d.ts +30 -0
- package/dist/cli/tsdocs/agentsNote.js +92 -0
- package/dist/cli/tsdocs/agentsNote.js.map +1 -0
- package/dist/cli/tsdocs/api-index.json +1 -0
- package/dist/cli/tsdocs/api.d.ts +91 -0
- package/dist/cli/tsdocs/api.js +372 -0
- package/dist/cli/tsdocs/api.js.map +1 -0
- package/dist/cli/tsdocs/apiTypes.d.ts +64 -0
- package/dist/cli/tsdocs/apiTypes.js +7 -0
- package/dist/cli/tsdocs/apiTypes.js.map +1 -0
- package/dist/cli/tsdocs/bin.d.ts +6 -0
- package/dist/cli/tsdocs/bin.js +23 -0
- package/dist/cli/tsdocs/bin.js.map +1 -0
- package/dist/cli/tsdocs/files.d.ts +108 -0
- package/dist/cli/tsdocs/files.js +287 -0
- package/dist/cli/tsdocs/files.js.map +1 -0
- package/dist/cli/tsdocs/index.d.ts +28 -0
- package/dist/cli/tsdocs/index.js +307 -0
- package/dist/cli/tsdocs/index.js.map +1 -0
- package/dist/cli/tsdocs/live.d.ts +41 -0
- package/dist/cli/tsdocs/live.js +202 -0
- package/dist/cli/tsdocs/live.js.map +1 -0
- package/dist/cli/tsdocs/locate.d.ts +51 -0
- package/dist/cli/tsdocs/locate.js +75 -0
- package/dist/cli/tsdocs/locate.js.map +1 -0
- package/dist/cli/tsdocs/render.d.ts +75 -0
- package/dist/cli/tsdocs/render.js +323 -0
- package/dist/cli/tsdocs/render.js.map +1 -0
- package/dist/cli/tsdocs/topics.d.ts +43 -0
- package/dist/cli/tsdocs/topics.js +916 -0
- package/dist/cli/tsdocs/topics.js.map +1 -0
- package/dist/index.d.ts +47 -68
- package/dist/index.js +44 -73
- package/dist/index.js.map +1 -1
- package/dist/livewire/index.d.ts +229 -155
- package/dist/livewire/index.js +298 -195
- package/dist/livewire/index.js.map +1 -1
- package/dist/llms.txt +65 -0
- package/dist/prefabs/CallSessionStore.d.ts +52 -0
- package/dist/prefabs/CallSessionStore.js +72 -0
- package/dist/prefabs/CallSessionStore.js.map +1 -0
- package/dist/prefabs/ConciergeAgent.d.ts +13 -1
- package/dist/prefabs/ConciergeAgent.js +36 -31
- package/dist/prefabs/ConciergeAgent.js.map +1 -1
- package/dist/prefabs/FAQBotAgent.d.ts +9 -1
- package/dist/prefabs/FAQBotAgent.js +113 -47
- package/dist/prefabs/FAQBotAgent.js.map +1 -1
- package/dist/prefabs/InfoGathererAgent.d.ts +22 -3
- package/dist/prefabs/InfoGathererAgent.js +67 -58
- package/dist/prefabs/InfoGathererAgent.js.map +1 -1
- package/dist/prefabs/ReceptionistAgent.d.ts +16 -5
- package/dist/prefabs/ReceptionistAgent.js +39 -31
- package/dist/prefabs/ReceptionistAgent.js.map +1 -1
- package/dist/prefabs/SurveyAgent.d.ts +22 -4
- package/dist/prefabs/SurveyAgent.js +84 -68
- package/dist/prefabs/SurveyAgent.js.map +1 -1
- package/dist/relay/Action.d.ts +44 -21
- package/dist/relay/Action.js +75 -17
- package/dist/relay/Action.js.map +1 -1
- package/dist/relay/Call.d.ts +312 -47
- package/dist/relay/Call.js +369 -18
- package/dist/relay/Call.js.map +1 -1
- package/dist/relay/Deferred.js.map +1 -1
- package/dist/relay/Message.d.ts +26 -5
- package/dist/relay/Message.js +36 -6
- package/dist/relay/Message.js.map +1 -1
- package/dist/relay/RelayClient.d.ts +44 -17
- package/dist/relay/RelayClient.js +175 -65
- package/dist/relay/RelayClient.js.map +1 -1
- package/dist/relay/RelayError.d.ts +14 -0
- package/dist/relay/RelayError.js +15 -0
- package/dist/relay/RelayError.js.map +1 -1
- package/dist/relay/RelayEvent.d.ts +96 -65
- package/dist/relay/RelayEvent.js +85 -56
- package/dist/relay/RelayEvent.js.map +1 -1
- package/dist/relay/closedSets.d.ts +111 -0
- package/dist/relay/closedSets.js +83 -0
- package/dist/relay/closedSets.js.map +1 -0
- package/dist/relay/index.d.ts +3 -1
- package/dist/relay/index.js +1 -0
- package/dist/relay/index.js.map +1 -1
- package/dist/relay/normalize.js.map +1 -1
- package/dist/relay/protocol.types.generated.d.ts +1195 -0
- package/dist/relay/protocol.types.generated.js +8 -0
- package/dist/relay/protocol.types.generated.js.map +1 -0
- package/dist/relay/types.d.ts +73 -42
- package/dist/rest/HttpClient.d.ts +36 -8
- package/dist/rest/HttpClient.js +233 -40
- package/dist/rest/HttpClient.js.map +1 -1
- package/dist/rest/RequestOptions.d.ts +110 -0
- package/dist/rest/RequestOptions.js +113 -0
- package/dist/rest/RequestOptions.js.map +1 -0
- package/dist/rest/RestError.d.ts +52 -6
- package/dist/rest/RestError.js +89 -5
- package/dist/rest/RestError.js.map +1 -1
- package/dist/rest/base/CrudResource.d.ts +16 -26
- package/dist/rest/base/CrudResource.js +19 -33
- package/dist/rest/base/CrudResource.js.map +1 -1
- package/dist/rest/base/CrudWithAddresses.d.ts +3 -2
- package/dist/rest/base/CrudWithAddresses.js +2 -2
- package/dist/rest/base/CrudWithAddresses.js.map +1 -1
- package/dist/rest/base/FabricResource.d.ts +15 -0
- package/dist/rest/base/FabricResource.js +16 -0
- package/dist/rest/base/FabricResource.js.map +1 -0
- package/dist/rest/base/ReadResource.d.ts +62 -0
- package/dist/rest/base/ReadResource.js +69 -0
- package/dist/rest/base/ReadResource.js.map +1 -0
- package/dist/rest/callHandler.d.ts +5 -2
- package/dist/rest/callHandler.js +4 -1
- package/dist/rest/callHandler.js.map +1 -1
- package/dist/rest/index.d.ts +18 -77
- package/dist/rest/index.js +47 -120
- package/dist/rest/index.js.map +1 -1
- package/dist/rest/namespaces/_client_tree_generated.d.ts +103 -0
- package/dist/rest/namespaces/_client_tree_generated.js +171 -0
- package/dist/rest/namespaces/_client_tree_generated.js.map +1 -0
- package/dist/rest/namespaces/addresses.d.ts +3 -42
- package/dist/rest/namespaces/addresses.js +3 -50
- package/dist/rest/namespaces/addresses.js.map +1 -1
- package/dist/rest/namespaces/calling.d.ts +6 -378
- package/dist/rest/namespaces/calling.js +6 -473
- package/dist/rest/namespaces/calling.js.map +1 -1
- package/dist/rest/namespaces/calling.resources.generated.d.ts +165 -0
- package/dist/rest/namespaces/calling.resources.generated.js +477 -0
- package/dist/rest/namespaces/calling.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/calling.types.generated.d.ts +2917 -0
- package/dist/rest/namespaces/calling.types.generated.js +8 -0
- package/dist/rest/namespaces/calling.types.generated.js.map +1 -0
- package/dist/rest/namespaces/chat.d.ts +4 -18
- package/dist/rest/namespaces/chat.js +4 -21
- package/dist/rest/namespaces/chat.js.map +1 -1
- package/dist/rest/namespaces/chat.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/chat.resources.generated.js +29 -0
- package/dist/rest/namespaces/chat.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/chat.types.generated.d.ts +56 -0
- package/dist/rest/namespaces/chat.types.generated.js +8 -0
- package/dist/rest/namespaces/chat.types.generated.js.map +1 -0
- package/dist/rest/namespaces/datasphere.d.ts +6 -62
- package/dist/rest/namespaces/datasphere.js +6 -72
- package/dist/rest/namespaces/datasphere.js.map +1 -1
- package/dist/rest/namespaces/datasphere.resources.generated.d.ts +25 -0
- package/dist/rest/namespaces/datasphere.resources.generated.js +50 -0
- package/dist/rest/namespaces/datasphere.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/datasphere.types.generated.d.ts +180 -0
- package/dist/rest/namespaces/datasphere.types.generated.js +8 -0
- package/dist/rest/namespaces/datasphere.types.generated.js.map +1 -0
- package/dist/rest/namespaces/fabric.d.ts +11 -327
- package/dist/rest/namespaces/fabric.js +14 -439
- package/dist/rest/namespaces/fabric.js.map +1 -1
- package/dist/rest/namespaces/fabric.resources.generated.d.ts +195 -0
- package/dist/rest/namespaces/fabric.resources.generated.js +399 -0
- package/dist/rest/namespaces/fabric.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/fabric.types.generated.d.ts +4557 -0
- package/dist/rest/namespaces/fabric.types.generated.js +8 -0
- package/dist/rest/namespaces/fabric.types.generated.js.map +1 -0
- package/dist/rest/namespaces/fax.resources.generated.d.ts +6 -0
- package/dist/rest/namespaces/fax.resources.generated.js +14 -0
- package/dist/rest/namespaces/fax.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/fax.types.generated.d.ts +131 -0
- package/dist/rest/namespaces/fax.types.generated.js +8 -0
- package/dist/rest/namespaces/fax.types.generated.js.map +1 -0
- package/dist/rest/namespaces/imported-numbers.d.ts +3 -18
- package/dist/rest/namespaces/imported-numbers.js +3 -21
- package/dist/rest/namespaces/imported-numbers.js.map +1 -1
- package/dist/rest/namespaces/logs.d.ts +10 -101
- package/dist/rest/namespaces/logs.js +10 -128
- package/dist/rest/namespaces/logs.js.map +1 -1
- package/dist/rest/namespaces/logs.resources.generated.d.ts +9 -0
- package/dist/rest/namespaces/logs.resources.generated.js +17 -0
- package/dist/rest/namespaces/logs.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/logs.types.generated.d.ts +131 -0
- package/dist/rest/namespaces/logs.types.generated.js +8 -0
- package/dist/rest/namespaces/logs.types.generated.js.map +1 -0
- package/dist/rest/namespaces/lookup.d.ts +3 -25
- package/dist/rest/namespaces/lookup.js +3 -27
- package/dist/rest/namespaces/lookup.js.map +1 -1
- package/dist/rest/namespaces/message.resources.generated.d.ts +6 -0
- package/dist/rest/namespaces/message.resources.generated.js +14 -0
- package/dist/rest/namespaces/message.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/message.types.generated.d.ts +122 -0
- package/dist/rest/namespaces/message.types.generated.js +8 -0
- package/dist/rest/namespaces/message.types.generated.js.map +1 -0
- package/dist/rest/namespaces/messages.resources.generated.d.ts +18 -0
- package/dist/rest/namespaces/messages.resources.generated.js +44 -0
- package/dist/rest/namespaces/messages.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/messages.types.generated.d.ts +99 -0
- package/dist/rest/namespaces/messages.types.generated.js +8 -0
- package/dist/rest/namespaces/messages.types.generated.js.map +1 -0
- package/dist/rest/namespaces/mfa.d.ts +3 -42
- package/dist/rest/namespaces/mfa.js +3 -49
- package/dist/rest/namespaces/mfa.js.map +1 -1
- package/dist/rest/namespaces/number-groups.d.ts +3 -45
- package/dist/rest/namespaces/number-groups.js +3 -53
- package/dist/rest/namespaces/number-groups.js.map +1 -1
- package/dist/rest/namespaces/phone-numbers.d.ts +8 -196
- package/dist/rest/namespaces/phone-numbers.js +8 -230
- package/dist/rest/namespaces/phone-numbers.js.map +1 -1
- package/dist/rest/namespaces/project.d.ts +6 -42
- package/dist/rest/namespaces/project.js +6 -51
- package/dist/rest/namespaces/project.js.map +1 -1
- package/dist/rest/namespaces/project.resources.generated.d.ts +17 -0
- package/dist/rest/namespaces/project.resources.generated.js +44 -0
- package/dist/rest/namespaces/project.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/project.types.generated.d.ts +58 -0
- package/dist/rest/namespaces/project.types.generated.js +8 -0
- package/dist/rest/namespaces/project.types.generated.js.map +1 -0
- package/dist/rest/namespaces/projects.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/projects.resources.generated.js +25 -0
- package/dist/rest/namespaces/projects.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/projects.types.generated.d.ts +77 -0
- package/dist/rest/namespaces/projects.types.generated.js +8 -0
- package/dist/rest/namespaces/projects.types.generated.js.map +1 -0
- package/dist/rest/namespaces/pubsub.d.ts +4 -18
- package/dist/rest/namespaces/pubsub.js +4 -21
- package/dist/rest/namespaces/pubsub.js.map +1 -1
- package/dist/rest/namespaces/pubsub.resources.generated.d.ts +12 -0
- package/dist/rest/namespaces/pubsub.resources.generated.js +29 -0
- package/dist/rest/namespaces/pubsub.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/pubsub.types.generated.d.ts +60 -0
- package/dist/rest/namespaces/pubsub.types.generated.js +8 -0
- package/dist/rest/namespaces/pubsub.types.generated.js.map +1 -0
- package/dist/rest/namespaces/queues.d.ts +3 -38
- package/dist/rest/namespaces/queues.js +3 -44
- package/dist/rest/namespaces/queues.js.map +1 -1
- package/dist/rest/namespaces/recordings.d.ts +3 -34
- package/dist/rest/namespaces/recordings.js +3 -40
- package/dist/rest/namespaces/recordings.js.map +1 -1
- package/dist/rest/namespaces/registry.d.ts +6 -137
- package/dist/rest/namespaces/registry.js +6 -173
- package/dist/rest/namespaces/registry.js.map +1 -1
- package/dist/rest/namespaces/relay-rest.resources.generated.d.ts +168 -0
- package/dist/rest/namespaces/relay-rest.resources.generated.js +430 -0
- package/dist/rest/namespaces/relay-rest.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/relay-rest.types.generated.d.ts +1906 -0
- package/dist/rest/namespaces/relay-rest.types.generated.js +8 -0
- package/dist/rest/namespaces/relay-rest.types.generated.js.map +1 -0
- package/dist/rest/namespaces/short-codes.d.ts +3 -35
- package/dist/rest/namespaces/short-codes.js +3 -41
- package/dist/rest/namespaces/short-codes.js.map +1 -1
- package/dist/rest/namespaces/sip-profile.d.ts +3 -24
- package/dist/rest/namespaces/sip-profile.js +3 -29
- package/dist/rest/namespaces/sip-profile.js.map +1 -1
- package/dist/rest/namespaces/verified-callers.d.ts +3 -29
- package/dist/rest/namespaces/verified-callers.js +3 -34
- package/dist/rest/namespaces/verified-callers.js.map +1 -1
- package/dist/rest/namespaces/video.d.ts +10 -227
- package/dist/rest/namespaces/video.js +10 -288
- package/dist/rest/namespaces/video.js.map +1 -1
- package/dist/rest/namespaces/video.resources.generated.d.ts +81 -0
- package/dist/rest/namespaces/video.resources.generated.js +171 -0
- package/dist/rest/namespaces/video.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/video.types.generated.d.ts +771 -0
- package/dist/rest/namespaces/video.types.generated.js +8 -0
- package/dist/rest/namespaces/video.types.generated.js.map +1 -0
- package/dist/rest/namespaces/voice.resources.generated.d.ts +9 -0
- package/dist/rest/namespaces/voice.resources.generated.js +17 -0
- package/dist/rest/namespaces/voice.resources.generated.js.map +1 -0
- package/dist/rest/namespaces/voice.types.generated.d.ts +214 -0
- package/dist/rest/namespaces/voice.types.generated.js +8 -0
- package/dist/rest/namespaces/voice.types.generated.js.map +1 -0
- package/dist/rest/pagination.d.ts +5 -1
- package/dist/rest/pagination.js +40 -20
- package/dist/rest/pagination.js.map +1 -1
- package/dist/rest/types.d.ts +21 -3
- package/dist/schema.json +299 -98
- package/dist/skills/SkillBase.d.ts +97 -20
- package/dist/skills/SkillBase.js +100 -17
- package/dist/skills/SkillBase.js.map +1 -1
- package/dist/skills/SkillManager.d.ts +66 -13
- package/dist/skills/SkillManager.js +101 -20
- package/dist/skills/SkillManager.js.map +1 -1
- package/dist/skills/SkillName.d.ts +44 -0
- package/dist/skills/SkillName.js +2 -0
- package/dist/skills/SkillName.js.map +1 -0
- package/dist/skills/SkillRegistry.d.ts +22 -11
- package/dist/skills/SkillRegistry.js +47 -17
- package/dist/skills/SkillRegistry.js.map +1 -1
- package/dist/skills/builtin/api_ninjas_trivia.d.ts +3 -1
- package/dist/skills/builtin/api_ninjas_trivia.js +18 -6
- package/dist/skills/builtin/api_ninjas_trivia.js.map +1 -1
- package/dist/skills/builtin/ask_claude.d.ts +14 -4
- package/dist/skills/builtin/ask_claude.js +36 -14
- package/dist/skills/builtin/ask_claude.js.map +1 -1
- package/dist/skills/builtin/claude_skills.d.ts +3 -1
- package/dist/skills/builtin/claude_skills.js +19 -15
- package/dist/skills/builtin/claude_skills.js.map +1 -1
- package/dist/skills/builtin/custom_skills.d.ts +10 -3
- package/dist/skills/builtin/custom_skills.js +26 -9
- package/dist/skills/builtin/custom_skills.js.map +1 -1
- package/dist/skills/builtin/datasphere.d.ts +5 -3
- package/dist/skills/builtin/datasphere.js +21 -22
- package/dist/skills/builtin/datasphere.js.map +1 -1
- package/dist/skills/builtin/datasphere_serverless.d.ts +12 -1
- package/dist/skills/builtin/datasphere_serverless.js +17 -6
- package/dist/skills/builtin/datasphere_serverless.js.map +1 -1
- package/dist/skills/builtin/datetime.d.ts +3 -1
- package/dist/skills/builtin/datetime.js +11 -7
- package/dist/skills/builtin/datetime.js.map +1 -1
- package/dist/skills/builtin/google_maps.d.ts +29 -14
- package/dist/skills/builtin/google_maps.js +89 -269
- package/dist/skills/builtin/google_maps.js.map +1 -1
- package/dist/skills/builtin/index.d.ts +8 -6
- package/dist/skills/builtin/index.js +8 -6
- package/dist/skills/builtin/index.js.map +1 -1
- package/dist/skills/builtin/info_gatherer.d.ts +4 -2
- package/dist/skills/builtin/info_gatherer.js +20 -12
- package/dist/skills/builtin/info_gatherer.js.map +1 -1
- package/dist/skills/builtin/joke.d.ts +16 -6
- package/dist/skills/builtin/joke.js +54 -37
- package/dist/skills/builtin/joke.js.map +1 -1
- package/dist/skills/builtin/math.d.ts +3 -1
- package/dist/skills/builtin/math.js +14 -9
- package/dist/skills/builtin/math.js.map +1 -1
- package/dist/skills/builtin/mcp_gateway.d.ts +34 -5
- package/dist/skills/builtin/mcp_gateway.js +77 -46
- package/dist/skills/builtin/mcp_gateway.js.map +1 -1
- package/dist/skills/builtin/native_vector_search.d.ts +19 -5
- package/dist/skills/builtin/native_vector_search.js +179 -61
- package/dist/skills/builtin/native_vector_search.js.map +1 -1
- package/dist/skills/builtin/play_background_file.d.ts +21 -15
- package/dist/skills/builtin/play_background_file.js +43 -122
- package/dist/skills/builtin/play_background_file.js.map +1 -1
- package/dist/skills/builtin/spider.d.ts +42 -4
- package/dist/skills/builtin/spider.js +277 -104
- package/dist/skills/builtin/spider.js.map +1 -1
- package/dist/skills/builtin/swml_transfer.d.ts +14 -3
- package/dist/skills/builtin/swml_transfer.js +45 -24
- package/dist/skills/builtin/swml_transfer.js.map +1 -1
- package/dist/skills/builtin/weather_api.d.ts +24 -13
- package/dist/skills/builtin/weather_api.js +38 -30
- package/dist/skills/builtin/weather_api.js.map +1 -1
- package/dist/skills/builtin/web_search.d.ts +48 -10
- package/dist/skills/builtin/web_search.js +294 -100
- package/dist/skills/builtin/web_search.js.map +1 -1
- package/dist/skills/builtin/wikipedia_search.d.ts +4 -2
- package/dist/skills/builtin/wikipedia_search.js +14 -13
- package/dist/skills/builtin/wikipedia_search.js.map +1 -1
- package/dist/skills/index.d.ts +3 -2
- package/dist/skills/index.js +1 -1
- package/dist/skills/index.js.map +1 -1
- package/dist/swml_verbs_generated.d.ts +2824 -0
- package/dist/swml_verbs_generated.js +12 -0
- package/dist/swml_verbs_generated.js.map +1 -0
- package/dist/types.d.ts +59 -6
- package/dist/web.d.ts +27 -0
- package/dist/web.js +20 -0
- package/dist/web.js.map +1 -0
- package/docs/agent-guide.md +1034 -0
- package/docs/ai_chat.md +560 -0
- package/docs/api-reference.md +3534 -0
- package/docs/architecture.md +846 -0
- package/docs/bedrock_agent.md +411 -0
- package/docs/cli-guide.md +403 -0
- package/docs/cloud_functions_guide.md +399 -0
- package/docs/configuration.md +548 -0
- package/docs/contexts-guide.md +884 -0
- package/docs/datamap-guide.md +1160 -0
- package/docs/developer_pain_points.md +548 -0
- package/docs/llm_parameters.md +298 -0
- package/docs/mcp_gateway_reference.md +354 -0
- package/docs/mcp_integration.md +162 -0
- package/docs/pgi_agent_guide.md +1820 -0
- package/docs/prefabs-guide.md +815 -0
- package/docs/programmatically_governed_inference.md +301 -0
- package/docs/sdk_features.md +501 -0
- package/docs/security.md +559 -0
- package/docs/serverless-guide.md +520 -0
- package/docs/skills-guide.md +1223 -0
- package/docs/skills-system.md +405 -0
- package/docs/skills_parameter_schema.md +417 -0
- package/docs/swaig-reference.md +1938 -0
- package/docs/swml_service_guide.md +573 -0
- package/docs/third_party_skills.md +410 -0
- package/docs/web_service.md +666 -0
- package/examples/README.md +202 -0
- package/examples/advanced-datamap.ts +108 -0
- package/examples/advanced-dynamic-config.ts +70 -0
- package/examples/auto-vivified.ts +95 -0
- package/examples/call-flow.ts +65 -0
- package/examples/comprehensive-dynamic.ts +125 -0
- package/examples/contexts-steps.ts +65 -0
- package/examples/custom-path.ts +45 -0
- package/examples/datamap-tools.ts +51 -0
- package/examples/datasphere-multi-instance.ts +66 -0
- package/examples/datasphere-serverless-env.ts +87 -0
- package/examples/datasphere-webhook-env.ts +65 -0
- package/examples/datasphere.ts +56 -0
- package/examples/declarative.ts +100 -0
- package/examples/dynamic-config.ts +54 -0
- package/examples/dynamic-info-gatherer.ts +69 -0
- package/examples/dynamic-swml-service.ts +67 -0
- package/examples/gather-info.ts +95 -0
- package/examples/gather-per-question-functions-demo.ts +139 -0
- package/examples/joke-agent.ts +34 -0
- package/examples/kubernetes-agent.ts +45 -0
- package/examples/llm-params.ts +75 -0
- package/examples/mcp-agent.ts +89 -0
- package/examples/mcp-gateway.ts +81 -0
- package/examples/multi-agent.ts +80 -0
- package/examples/multi-endpoint.ts +79 -0
- package/examples/pgi/case-domain.ts +114 -0
- package/examples/pgi/serve.ts +16 -0
- package/examples/pgi/support-agent.ts +265 -0
- package/examples/pom-prompt.ts +70 -0
- package/examples/prefab-concierge.ts +42 -0
- package/examples/prefab-faq.ts +58 -0
- package/examples/prefab-info-gatherer.ts +33 -0
- package/examples/prefab-receptionist.ts +36 -0
- package/examples/prefab-survey.ts +69 -0
- package/examples/quickstart-agent.ts +29 -0
- package/examples/quickstart-relay.ts +25 -0
- package/examples/quickstart-rest.ts +25 -0
- package/examples/record-call.ts +65 -0
- package/examples/relay-demo.ts +33 -0
- package/examples/room-and-sip.ts +93 -0
- package/examples/serverless-lambda.ts +43 -0
- package/examples/session-state.ts +83 -0
- package/examples/simple-agent.ts +36 -0
- package/examples/simple-static.ts +29 -0
- package/examples/skills-demo.ts +41 -0
- package/examples/step-function-inheritance-demo.ts +124 -0
- package/examples/swaig-features.ts +193 -0
- package/examples/swml-service-routing.ts +66 -0
- package/examples/swml-service.ts +38 -0
- package/examples/swmlservice_ai_sidecar.ts +104 -0
- package/examples/swmlservice_swaig_standalone.ts +79 -0
- package/examples/tap.ts +67 -0
- package/examples/typed-tools.ts +68 -0
- package/examples/verb-methods.ts +45 -0
- package/examples/web-search-multi-instance.ts +75 -0
- package/examples/web-search.ts +38 -0
- package/examples/wikipedia.ts +36 -0
- package/livewire/README.md +164 -0
- package/livewire/docs/migration-guide.md +251 -0
- package/livewire/examples/livewire-basic-agent.ts +74 -0
- package/livewire/examples/livewire-handoff.ts +196 -0
- package/livewire/examples/livewire-multi-tool.ts +121 -0
- package/package.json +85 -13
- package/relay/README.md +101 -0
- package/relay/docs/call-methods.md +622 -0
- package/relay/docs/client-reference.md +281 -0
- package/relay/docs/events.md +193 -0
- package/relay/docs/getting-started.md +221 -0
- package/relay/docs/guide.md +386 -0
- package/relay/docs/messaging.md +246 -0
- package/relay/examples/relay-inbound.ts +66 -0
- package/relay/examples/relay-messaging.ts +74 -0
- package/relay/examples/relay-outbound.ts +76 -0
- package/rest/README.md +141 -0
- package/rest/docs/calling.md +313 -0
- package/rest/docs/client-reference.md +149 -0
- package/rest/docs/fabric.md +192 -0
- package/rest/docs/getting-started.md +138 -0
- package/rest/docs/guide.md +421 -0
- package/rest/docs/namespaces.md +367 -0
- package/rest/docs/phone-binding.md +116 -0
- package/rest/examples/rest-10dlc-registration.ts +177 -0
- package/rest/examples/rest-bind-phone-to-swml-webhook.ts +66 -0
- package/rest/examples/rest-calling-ivr-and-ai.ts +136 -0
- package/rest/examples/rest-calling-play-and-record.ts +98 -0
- package/rest/examples/rest-client.ts +59 -0
- package/rest/examples/rest-datasphere-search.ts +81 -0
- package/rest/examples/rest-fabric-conferences-and-routing.ts +147 -0
- package/rest/examples/rest-fabric-subscribers-and-sip.ts +106 -0
- package/rest/examples/rest-fabric-swml-and-callflows.ts +101 -0
- package/rest/examples/rest-manage-resources.ts +64 -0
- package/rest/examples/rest-phone-number-management.ts +200 -0
- package/rest/examples/rest-queues-mfa-and-recordings.ts +143 -0
- package/rest/examples/rest-video-rooms.ts +186 -0
- package/tutorial/fred/fred.ts +218 -0
- package/tutorial/fred/tutorial/01-introduction.md +141 -0
- package/tutorial/fred/tutorial/02-setup.md +304 -0
- package/tutorial/fred/tutorial/03-basic-agent.md +284 -0
- package/tutorial/fred/tutorial/04-wikipedia-skill.md +298 -0
- package/tutorial/fred/tutorial/05-custom-functions.md +347 -0
- package/tutorial/fred/tutorial/06-running-testing.md +642 -0
- package/tutorial/fred/tutorial/README.md +56 -0
- package/tutorial/fred/tutorial/appendix-complete-code.md +632 -0
- package/tutorial/fred/tutorial/appendix-docker-deployment.md +504 -0
- package/tutorial/full-guardrails-agent/handlers.ts +436 -0
- package/tutorial/full-guardrails-agent/penny.ts +305 -0
- package/tutorial/full-guardrails-agent/reservations.ts +1109 -0
- package/tutorial/full-guardrails-agent/tutorial/01-why-guardrails.md +149 -0
- package/tutorial/full-guardrails-agent/tutorial/02-design-first.md +139 -0
- package/tutorial/full-guardrails-agent/tutorial/03-rules-first.md +422 -0
- package/tutorial/full-guardrails-agent/tutorial/04-the-shell.md +238 -0
- package/tutorial/full-guardrails-agent/tutorial/05-steps-and-scoping.md +247 -0
- package/tutorial/full-guardrails-agent/tutorial/06-tools-that-decide.md +467 -0
- package/tutorial/full-guardrails-agent/tutorial/07-gather-and-projection.md +160 -0
- package/tutorial/full-guardrails-agent/tutorial/08-the-verification-gate.md +333 -0
- package/tutorial/full-guardrails-agent/tutorial/09-people-and-endings.md +313 -0
- package/tutorial/full-guardrails-agent/tutorial/10-testing-and-running.md +387 -0
- package/tutorial/full-guardrails-agent/tutorial/README.md +106 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-complete-code.md +2207 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-deployment.md +191 -0
- package/tutorial/full-guardrails-agent/tutorial/appendix-technique-map.md +117 -0
- package/tutorial/full-guardrails-agent/workflow.ts +219 -0
- package/tutorial/multi_agents/README.md +175 -0
- package/tutorial/multi_agents/advanced_agent.ts +395 -0
- package/tutorial/multi_agents/extending_agents.ts +641 -0
- package/tutorial/multi_agents/knowledge.ts +59 -0
- package/tutorial/multi_agents/lesson1_first_agent.md +368 -0
- package/tutorial/multi_agents/lesson2_knowledge_bases.md +404 -0
- package/tutorial/multi_agents/lesson3_multi_agent_systems.md +621 -0
- package/tutorial/multi_agents/lesson4_advanced_features.md +805 -0
- package/tutorial/multi_agents/lesson5_extending_agents.md +856 -0
- package/tutorial/multi_agents/pc_builder.ts +529 -0
- package/tutorial/multi_agents/sales_agent.ts +88 -0
- package/tutorial/multi_agents/sales_agent_with_search.ts +116 -0
- package/tutorial/multi_agents/sales_knowledge.md +139 -0
- package/tutorial/multi_agents/support_knowledge.md +256 -0
- package/dist/cli/mock-data.d.ts +0 -37
- package/dist/cli/mock-data.js +0 -80
- package/dist/cli/mock-data.js.map +0 -1
- package/dist/generateVerbTypes.d.ts +0 -11
- package/dist/generateVerbTypes.js +0 -265
- package/dist/generateVerbTypes.js.map +0 -1
- package/dist/rest/namespaces/compat.d.ts +0 -585
- package/dist/rest/namespaces/compat.js +0 -735
- package/dist/rest/namespaces/compat.js.map +0 -1
package/dist/SecurityUtils.d.ts
CHANGED
|
@@ -22,9 +22,11 @@ export declare function safeAssign<T extends Record<string, unknown>>(target: T,
|
|
|
22
22
|
export declare function filterSensitiveHeaders(headers: Record<string, string>): Record<string, string>;
|
|
23
23
|
/**
|
|
24
24
|
* Redact credentials embedded in a URL (e.g. `https://user:secret@host` -> `https://user:****@host`).
|
|
25
|
-
*
|
|
26
|
-
* @
|
|
27
|
-
*
|
|
25
|
+
* Masks the password of every URL in the string, including one with an empty
|
|
26
|
+
* user (`http://:secret@host`). Returns the string unchanged if no credentials
|
|
27
|
+
* are present.
|
|
28
|
+
* @param url - The URL string (or a message containing URLs) to redact.
|
|
29
|
+
* @returns The string with each URL's password replaced by `****`.
|
|
28
30
|
*/
|
|
29
31
|
export declare function redactUrl(url: string): string;
|
|
30
32
|
/**
|
|
@@ -34,17 +36,48 @@ export declare function redactUrl(url: string): string;
|
|
|
34
36
|
*/
|
|
35
37
|
export declare function isValidHostname(host: string): boolean;
|
|
36
38
|
/**
|
|
37
|
-
* Check whether an
|
|
38
|
-
*
|
|
39
|
+
* Check whether an address is one a user-supplied URL must not reach: a
|
|
40
|
+
* private, loopback, link-local or reserved address, or the unspecified
|
|
41
|
+
* address (`0.0.0.0` or `::`), which connects to the local host.
|
|
42
|
+
*
|
|
43
|
+
* Accepts IPv6 in brackets (as `URL.hostname` gives it) and with a zone id.
|
|
44
|
+
* An IPv4-mapped IPv6 address (`::ffff:169.254.169.254`, in any spelling)
|
|
45
|
+
* reaches the IPv4 host, so the IPv4 address it carries is what's checked.
|
|
46
|
+
* A string that isn't an IP address returns `false`.
|
|
47
|
+
*
|
|
39
48
|
* @param ip - The IP address string to check.
|
|
40
|
-
* @returns True if the
|
|
49
|
+
* @returns True if the address is private, internal or unspecified.
|
|
41
50
|
*/
|
|
42
51
|
export declare function isPrivateIp(ip: string): boolean;
|
|
52
|
+
/** True when the caller or `SWML_ALLOW_PRIVATE_URLS` (1/true/yes) permits private addresses. */
|
|
53
|
+
export declare function _privateUrlsAllowed(allowPrivate?: boolean): boolean;
|
|
54
|
+
/** A DNS lookup returning every address for a hostname (`dns.promises.lookup` with `all`). */
|
|
55
|
+
export type _LookupAll = (hostname: string) => Promise<{
|
|
56
|
+
address: string;
|
|
57
|
+
family: number;
|
|
58
|
+
}[]>;
|
|
59
|
+
/**
|
|
60
|
+
* Check a URL a user or the model supplied before fetching it. Throws with a
|
|
61
|
+
* reason when the URL isn't http(s), has no hostname, can't be resolved, or
|
|
62
|
+
* resolves to any private or internal address. Shared by
|
|
63
|
+
* {@link resolveAndValidateUrl} and the SDK's URL-fetching skills.
|
|
64
|
+
*
|
|
65
|
+
* @param url - The URL to check.
|
|
66
|
+
* @param allowPrivate - Skip the address checks (so does `SWML_ALLOW_PRIVATE_URLS`).
|
|
67
|
+
* @param resolve - The DNS lookup to use; tests pass their own.
|
|
68
|
+
*/
|
|
69
|
+
export declare function _checkUrl(url: string, allowPrivate?: boolean, resolve?: _LookupAll): Promise<void>;
|
|
43
70
|
/**
|
|
44
|
-
*
|
|
71
|
+
* Check that a URL is safe to fetch, and throw if it isn't.
|
|
72
|
+
*
|
|
73
|
+
* The URL must be http or https, and its hostname must resolve, with every
|
|
74
|
+
* address it resolves to outside the private and internal ranges (see
|
|
75
|
+
* {@link isPrivateIp}). A hostname that can't be resolved is refused.
|
|
76
|
+
*
|
|
45
77
|
* @param url - The full URL to validate.
|
|
46
78
|
* @param allowPrivate - When true, skip the private-IP check (default false).
|
|
47
|
-
*
|
|
79
|
+
* `SWML_ALLOW_PRIVATE_URLS` (1/true/yes) does the same.
|
|
80
|
+
* @throws If the URL is invalid, can't be resolved, or reaches a private address.
|
|
48
81
|
*/
|
|
49
82
|
export declare function resolveAndValidateUrl(url: string, allowPrivate?: boolean): Promise<void>;
|
|
50
83
|
/**
|
|
@@ -62,6 +95,13 @@ export declare function validateUrl(url: string, allowPrivate?: boolean): Promis
|
|
|
62
95
|
* Whether the current process is running in a serverless environment
|
|
63
96
|
* (anything other than a long-lived ``server`` runtime).
|
|
64
97
|
*
|
|
65
|
-
* Python
|
|
98
|
+
* Python equivalent: ``signalwire.utils.is_serverless_mode``.
|
|
66
99
|
*/
|
|
67
100
|
export declare function isServerlessMode(): boolean;
|
|
101
|
+
/**
|
|
102
|
+
* The CORS `origin` option from `SWML_CORS_ORIGINS`: `'*'` when it's unset or
|
|
103
|
+
* lists `*` (which allows every origin, as the Python SDK reads it), else the
|
|
104
|
+
* listed origins.
|
|
105
|
+
* @internal
|
|
106
|
+
*/
|
|
107
|
+
export declare function corsOriginsFromEnv(value?: string | undefined): '*' | string[];
|
package/dist/SecurityUtils.js
CHANGED
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
* URL credential redaction, hostname validation, and input length limits.
|
|
6
6
|
*/
|
|
7
7
|
import { lookup } from 'node:dns/promises';
|
|
8
|
+
import { BlockList, isIP } from 'node:net';
|
|
8
9
|
import { getExecutionMode } from './Logger.js';
|
|
9
10
|
/** Maximum allowed input length for skill handler arguments (characters). */
|
|
10
11
|
export const MAX_SKILL_INPUT_LENGTH = 1000;
|
|
@@ -49,12 +50,14 @@ export function filterSensitiveHeaders(headers) {
|
|
|
49
50
|
}
|
|
50
51
|
/**
|
|
51
52
|
* Redact credentials embedded in a URL (e.g. `https://user:secret@host` -> `https://user:****@host`).
|
|
52
|
-
*
|
|
53
|
-
* @
|
|
54
|
-
*
|
|
53
|
+
* Masks the password of every URL in the string, including one with an empty
|
|
54
|
+
* user (`http://:secret@host`). Returns the string unchanged if no credentials
|
|
55
|
+
* are present.
|
|
56
|
+
* @param url - The URL string (or a message containing URLs) to redact.
|
|
57
|
+
* @returns The string with each URL's password replaced by `****`.
|
|
55
58
|
*/
|
|
56
59
|
export function redactUrl(url) {
|
|
57
|
-
return url.replace(/:\/\/([
|
|
60
|
+
return url.replace(/:\/\/([^:@/]*):([^@/]*)@/g, '://$1:****@');
|
|
58
61
|
}
|
|
59
62
|
/**
|
|
60
63
|
* Validate that a hostname string does not contain whitespace, slashes, or control characters.
|
|
@@ -65,72 +68,156 @@ export function isValidHostname(host) {
|
|
|
65
68
|
if (!host || host.length === 0)
|
|
66
69
|
return false;
|
|
67
70
|
// Reject whitespace, slashes, control chars
|
|
71
|
+
// eslint-disable-next-line no-control-regex -- intentional control-char rejection in hostname validation
|
|
68
72
|
return !/[\s/\\]/.test(host) && !/[\x00-\x1f\x7f]/.test(host);
|
|
69
73
|
}
|
|
74
|
+
/** Private and reserved networks a user-supplied URL must not reach. */
|
|
75
|
+
const BLOCKED_NETWORKS = (() => {
|
|
76
|
+
const list = new BlockList();
|
|
77
|
+
list.addSubnet('10.0.0.0', 8, 'ipv4');
|
|
78
|
+
list.addSubnet('172.16.0.0', 12, 'ipv4');
|
|
79
|
+
list.addSubnet('192.168.0.0', 16, 'ipv4');
|
|
80
|
+
list.addSubnet('127.0.0.0', 8, 'ipv4');
|
|
81
|
+
list.addSubnet('169.254.0.0', 16, 'ipv4'); // link-local, including cloud metadata
|
|
82
|
+
list.addSubnet('0.0.0.0', 8, 'ipv4');
|
|
83
|
+
list.addAddress('::1', 'ipv6');
|
|
84
|
+
list.addSubnet('fc00::', 7, 'ipv6'); // IPv6 private
|
|
85
|
+
list.addSubnet('fe80::', 10, 'ipv6'); // IPv6 link-local
|
|
86
|
+
return list;
|
|
87
|
+
})();
|
|
70
88
|
/**
|
|
71
|
-
*
|
|
72
|
-
*
|
|
89
|
+
* Expand an IPv6 address to its eight 16-bit groups, or `null` if it isn't
|
|
90
|
+
* one. Handles `::` compression and a trailing dotted IPv4 part.
|
|
91
|
+
*/
|
|
92
|
+
function ipv6Groups(addr) {
|
|
93
|
+
if (isIP(addr) !== 6)
|
|
94
|
+
return null;
|
|
95
|
+
// Rewrite a trailing dotted IPv4 part (::ffff:1.2.3.4) as two hex groups.
|
|
96
|
+
const text = addr.replace(/(\d+)\.(\d+)\.(\d+)\.(\d+)$/, (_m, a, b, c, d) => {
|
|
97
|
+
const hi = ((Number(a) << 8) | Number(b)).toString(16);
|
|
98
|
+
const lo = ((Number(c) << 8) | Number(d)).toString(16);
|
|
99
|
+
return `${hi}:${lo}`;
|
|
100
|
+
});
|
|
101
|
+
const parse = (part) => (part ? part.split(':').map((g) => parseInt(g, 16)) : []);
|
|
102
|
+
let groups;
|
|
103
|
+
if (text.includes('::')) {
|
|
104
|
+
const [head = '', tail = ''] = text.split('::');
|
|
105
|
+
const left = parse(head);
|
|
106
|
+
const right = parse(tail);
|
|
107
|
+
groups = [...left, ...new Array(8 - left.length - right.length).fill(0), ...right];
|
|
108
|
+
}
|
|
109
|
+
else {
|
|
110
|
+
groups = parse(text);
|
|
111
|
+
}
|
|
112
|
+
return groups.length === 8 ? groups : null;
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* Check whether an address is one a user-supplied URL must not reach: a
|
|
116
|
+
* private, loopback, link-local or reserved address, or the unspecified
|
|
117
|
+
* address (`0.0.0.0` or `::`), which connects to the local host.
|
|
118
|
+
*
|
|
119
|
+
* Accepts IPv6 in brackets (as `URL.hostname` gives it) and with a zone id.
|
|
120
|
+
* An IPv4-mapped IPv6 address (`::ffff:169.254.169.254`, in any spelling)
|
|
121
|
+
* reaches the IPv4 host, so the IPv4 address it carries is what's checked.
|
|
122
|
+
* A string that isn't an IP address returns `false`.
|
|
123
|
+
*
|
|
73
124
|
* @param ip - The IP address string to check.
|
|
74
|
-
* @returns True if the
|
|
125
|
+
* @returns True if the address is private, internal or unspecified.
|
|
75
126
|
*/
|
|
76
127
|
export function isPrivateIp(ip) {
|
|
77
|
-
|
|
78
|
-
if (
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
if (
|
|
85
|
-
return
|
|
86
|
-
if (
|
|
87
|
-
return
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
if (
|
|
92
|
-
return true;
|
|
93
|
-
if (/^f[cd]/i.test(ip))
|
|
128
|
+
let addr = ip.trim();
|
|
129
|
+
if (addr.startsWith('[') && addr.endsWith(']'))
|
|
130
|
+
addr = addr.slice(1, -1);
|
|
131
|
+
const zone = addr.indexOf('%');
|
|
132
|
+
if (zone !== -1)
|
|
133
|
+
addr = addr.slice(0, zone);
|
|
134
|
+
const family = isIP(addr);
|
|
135
|
+
if (family === 4)
|
|
136
|
+
return BLOCKED_NETWORKS.check(addr, 'ipv4');
|
|
137
|
+
if (family !== 6)
|
|
138
|
+
return false;
|
|
139
|
+
const groups = ipv6Groups(addr);
|
|
140
|
+
if (!groups)
|
|
141
|
+
return false;
|
|
142
|
+
if (groups.every((g) => g === 0))
|
|
94
143
|
return true;
|
|
95
|
-
|
|
144
|
+
const mapped = groups.slice(0, 5).every((g) => g === 0) && groups[5] === 0xffff;
|
|
145
|
+
if (mapped) {
|
|
146
|
+
const v4 = [groups[6] >> 8, groups[6] & 0xff, groups[7] >> 8, groups[7] & 0xff].join('.');
|
|
147
|
+
return BLOCKED_NETWORKS.check(v4, 'ipv4');
|
|
148
|
+
}
|
|
149
|
+
return BLOCKED_NETWORKS.check(addr, 'ipv6');
|
|
150
|
+
}
|
|
151
|
+
/** True when the caller or `SWML_ALLOW_PRIVATE_URLS` (1/true/yes) permits private addresses. */
|
|
152
|
+
export function _privateUrlsAllowed(allowPrivate = false) {
|
|
153
|
+
if (allowPrivate)
|
|
96
154
|
return true;
|
|
97
|
-
|
|
155
|
+
const env = (process.env['SWML_ALLOW_PRIVATE_URLS'] ?? '').toLowerCase();
|
|
156
|
+
return env === '1' || env === 'true' || env === 'yes';
|
|
98
157
|
}
|
|
158
|
+
const lookupAll = (hostname) => lookup(hostname, { all: true });
|
|
99
159
|
/**
|
|
100
|
-
*
|
|
101
|
-
*
|
|
102
|
-
*
|
|
103
|
-
* @
|
|
160
|
+
* Check a URL a user or the model supplied before fetching it. Throws with a
|
|
161
|
+
* reason when the URL isn't http(s), has no hostname, can't be resolved, or
|
|
162
|
+
* resolves to any private or internal address. Shared by
|
|
163
|
+
* {@link resolveAndValidateUrl} and the SDK's URL-fetching skills.
|
|
164
|
+
*
|
|
165
|
+
* @param url - The URL to check.
|
|
166
|
+
* @param allowPrivate - Skip the address checks (so does `SWML_ALLOW_PRIVATE_URLS`).
|
|
167
|
+
* @param resolve - The DNS lookup to use; tests pass their own.
|
|
104
168
|
*/
|
|
105
|
-
export async function
|
|
106
|
-
|
|
107
|
-
return;
|
|
108
|
-
let hostname;
|
|
169
|
+
export async function _checkUrl(url, allowPrivate = false, resolve = lookupAll) {
|
|
170
|
+
let parsed;
|
|
109
171
|
try {
|
|
110
|
-
|
|
172
|
+
parsed = new URL(url);
|
|
111
173
|
}
|
|
112
174
|
catch {
|
|
113
|
-
throw new Error(`Invalid URL: ${url}`);
|
|
175
|
+
throw new Error(`Invalid URL: ${redactUrl(url)}`);
|
|
114
176
|
}
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
throw new Error(`URL resolves to a private IP address: ${hostname}`);
|
|
177
|
+
if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
|
|
178
|
+
throw new Error(`URL rejected: invalid scheme ${parsed.protocol}`);
|
|
118
179
|
}
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
180
|
+
let hostname = parsed.hostname;
|
|
181
|
+
if (hostname.startsWith('[') && hostname.endsWith(']'))
|
|
182
|
+
hostname = hostname.slice(1, -1);
|
|
183
|
+
if (!hostname)
|
|
184
|
+
throw new Error('URL rejected: no hostname');
|
|
185
|
+
if (_privateUrlsAllowed(allowPrivate))
|
|
186
|
+
return;
|
|
187
|
+
if (isIP(hostname)) {
|
|
188
|
+
if (isPrivateIp(hostname)) {
|
|
189
|
+
throw new Error(`URL rejected: ${hostname} is a private IP address`);
|
|
124
190
|
}
|
|
191
|
+
return;
|
|
125
192
|
}
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
193
|
+
let addresses;
|
|
194
|
+
try {
|
|
195
|
+
addresses = await resolve(hostname);
|
|
196
|
+
}
|
|
197
|
+
catch {
|
|
198
|
+
throw new Error(`URL rejected: could not resolve hostname ${hostname}`);
|
|
199
|
+
}
|
|
200
|
+
for (const { address } of addresses) {
|
|
201
|
+
if (isPrivateIp(address)) {
|
|
202
|
+
throw new Error(`URL rejected: ${hostname} resolves to private IP ${address}`);
|
|
130
203
|
}
|
|
131
|
-
// DNS lookup failure - let the actual HTTP request handle it
|
|
132
204
|
}
|
|
133
205
|
}
|
|
206
|
+
/**
|
|
207
|
+
* Check that a URL is safe to fetch, and throw if it isn't.
|
|
208
|
+
*
|
|
209
|
+
* The URL must be http or https, and its hostname must resolve, with every
|
|
210
|
+
* address it resolves to outside the private and internal ranges (see
|
|
211
|
+
* {@link isPrivateIp}). A hostname that can't be resolved is refused.
|
|
212
|
+
*
|
|
213
|
+
* @param url - The full URL to validate.
|
|
214
|
+
* @param allowPrivate - When true, skip the private-IP check (default false).
|
|
215
|
+
* `SWML_ALLOW_PRIVATE_URLS` (1/true/yes) does the same.
|
|
216
|
+
* @throws If the URL is invalid, can't be resolved, or reaches a private address.
|
|
217
|
+
*/
|
|
218
|
+
export async function resolveAndValidateUrl(url, allowPrivate = false) {
|
|
219
|
+
await _checkUrl(url, allowPrivate);
|
|
220
|
+
}
|
|
134
221
|
/**
|
|
135
222
|
* Validate that a URL is safe to fetch (not pointing to private/internal resources).
|
|
136
223
|
*
|
|
@@ -154,10 +241,25 @@ export async function validateUrl(url, allowPrivate = false) {
|
|
|
154
241
|
* Whether the current process is running in a serverless environment
|
|
155
242
|
* (anything other than a long-lived ``server`` runtime).
|
|
156
243
|
*
|
|
157
|
-
* Python
|
|
244
|
+
* Python equivalent: ``signalwire.utils.is_serverless_mode``.
|
|
158
245
|
*/
|
|
159
246
|
export function isServerlessMode() {
|
|
160
|
-
const
|
|
247
|
+
const mode = getExecutionMode();
|
|
161
248
|
return mode !== 'server';
|
|
162
249
|
}
|
|
250
|
+
/**
|
|
251
|
+
* The CORS `origin` option from `SWML_CORS_ORIGINS`: `'*'` when it's unset or
|
|
252
|
+
* lists `*` (which allows every origin, as the Python SDK reads it), else the
|
|
253
|
+
* listed origins.
|
|
254
|
+
* @internal
|
|
255
|
+
*/
|
|
256
|
+
export function corsOriginsFromEnv(value = process.env['SWML_CORS_ORIGINS']) {
|
|
257
|
+
if (!value)
|
|
258
|
+
return '*';
|
|
259
|
+
const list = value
|
|
260
|
+
.split(',')
|
|
261
|
+
.map((o) => o.trim())
|
|
262
|
+
.filter(Boolean);
|
|
263
|
+
return list.length === 0 || list.includes('*') ? '*' : list;
|
|
264
|
+
}
|
|
163
265
|
//# sourceMappingURL=SecurityUtils.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SecurityUtils.js","sourceRoot":"","sources":["../src/SecurityUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,kEAAkE;AAClE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,
|
|
1
|
+
{"version":3,"file":"SecurityUtils.js","sourceRoot":"","sources":["../src/SecurityUtils.ts"],"names":[],"mappings":"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"}
|
|
@@ -16,15 +16,92 @@ export interface ServerlessEvent {
|
|
|
16
16
|
headers?: Record<string, string>;
|
|
17
17
|
/** Request body, either raw JSON string or parsed object. */
|
|
18
18
|
body?: string | Record<string, unknown>;
|
|
19
|
+
/** When true, `body` is base64-encoded (AWS API Gateway proxy integration). */
|
|
20
|
+
isBase64Encoded?: boolean;
|
|
19
21
|
/** Request path. */
|
|
20
22
|
path?: string;
|
|
21
23
|
/** Raw request path (AWS API Gateway v2). */
|
|
22
24
|
rawPath?: string;
|
|
23
25
|
/** Query string parameters as key-value pairs. */
|
|
24
26
|
queryStringParameters?: Record<string, string>;
|
|
27
|
+
/** Repeated query parameters (AWS API Gateway REST). */
|
|
28
|
+
multiValueQueryStringParameters?: Record<string, string[]>;
|
|
29
|
+
/** The raw, still-encoded query string (AWS API Gateway v2 and function URLs). */
|
|
30
|
+
rawQueryString?: string;
|
|
31
|
+
/** Path parameters; `proxy` is the path below a `{proxy+}` resource (AWS API Gateway REST). */
|
|
32
|
+
pathParameters?: Record<string, string>;
|
|
25
33
|
/** Platform-specific request context metadata. */
|
|
26
34
|
requestContext?: Record<string, unknown>;
|
|
27
35
|
}
|
|
36
|
+
/** Minimal Google Cloud Functions request shape (Express-style) consumed by {@link ServerlessAdapter.createGcfHandler}. */
|
|
37
|
+
interface GcfRequest {
|
|
38
|
+
method?: string;
|
|
39
|
+
headers?: Record<string, string>;
|
|
40
|
+
body?: string | Record<string, unknown>;
|
|
41
|
+
/** The unparsed request body, as the platform received it. */
|
|
42
|
+
rawBody?: Buffer | string;
|
|
43
|
+
path?: string;
|
|
44
|
+
url?: string;
|
|
45
|
+
originalUrl?: string;
|
|
46
|
+
protocol?: string;
|
|
47
|
+
/** The client's address (Express). */
|
|
48
|
+
ip?: string;
|
|
49
|
+
socket?: {
|
|
50
|
+
remoteAddress?: string;
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
/** Minimal Google Cloud Functions response shape (Express-style) consumed by {@link ServerlessAdapter.createGcfHandler}. */
|
|
54
|
+
interface GcfResponse {
|
|
55
|
+
status(code: number): void;
|
|
56
|
+
set(field: string, value: string): void;
|
|
57
|
+
send(body: string): void;
|
|
58
|
+
}
|
|
59
|
+
/** Minimal Azure Functions request shape consumed by {@link ServerlessAdapter.createAzureHandler}. */
|
|
60
|
+
interface AzureRequest {
|
|
61
|
+
method?: string;
|
|
62
|
+
headers?: Record<string, string>;
|
|
63
|
+
body?: string | Record<string, unknown>;
|
|
64
|
+
/** The unparsed request body, as the platform received it. */
|
|
65
|
+
rawBody?: Buffer | string;
|
|
66
|
+
url?: string;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* A URL a serverless request's webhook signature may have been computed over,
|
|
70
|
+
* with the path and query below the app's root to join to `SWML_PROXY_URL_BASE`.
|
|
71
|
+
* The adapter passes these to the app in Hono's `env` (see
|
|
72
|
+
* {@link _SIGNATURE_TARGETS_ENV_KEY}), where a client can't set them.
|
|
73
|
+
*/
|
|
74
|
+
export interface _SignatureTarget {
|
|
75
|
+
/** The full URL the platform received the request on. */
|
|
76
|
+
url: string;
|
|
77
|
+
/** The path below the app's root, with the query, e.g. `/swaig?x=1`. */
|
|
78
|
+
pathAndQuery: string;
|
|
79
|
+
}
|
|
80
|
+
/** The Hono `env` key under which the adapter passes {@link _SignatureTarget}s. */
|
|
81
|
+
export declare const _SIGNATURE_TARGETS_ENV_KEY = "signalwireSignatureTargets";
|
|
82
|
+
/**
|
|
83
|
+
* The Hono `env` key under which the adapter passes the base URL the platform
|
|
84
|
+
* serves the function on, when the request shows it (Azure's
|
|
85
|
+
* `https://<app>.azurewebsites.net/api/<function>`, a Google Cloud Function's
|
|
86
|
+
* origin). An agent renders its webhook URLs from it, unless
|
|
87
|
+
* `SWML_PROXY_URL_BASE` is set.
|
|
88
|
+
*/
|
|
89
|
+
export declare const _PLATFORM_BASE_ENV_KEY = "signalwirePlatformBase";
|
|
90
|
+
/**
|
|
91
|
+
* Hono env key for the client's address as the platform reports it (Lambda's
|
|
92
|
+
* requestContext source IP, a Cloud Function request's `ip`, CGI's
|
|
93
|
+
* REMOTE_ADDR), which the agent's rate limit keys on.
|
|
94
|
+
* @internal
|
|
95
|
+
*/
|
|
96
|
+
export declare const _CLIENT_ADDRESS_ENV_KEY = "signalwireClientAddress";
|
|
97
|
+
/** Minimal Azure Functions invocation context consumed by {@link ServerlessAdapter.createAzureHandler}. */
|
|
98
|
+
interface AzureContext {
|
|
99
|
+
res?: {
|
|
100
|
+
status: number;
|
|
101
|
+
headers: Record<string, string>;
|
|
102
|
+
body: string;
|
|
103
|
+
};
|
|
104
|
+
}
|
|
28
105
|
/** Normalized outgoing response returned to a serverless platform. */
|
|
29
106
|
export interface ServerlessResponse {
|
|
30
107
|
/** HTTP status code. */
|
|
@@ -47,7 +124,7 @@ export interface ServerlessResponse {
|
|
|
47
124
|
* const agent = new AgentBase({ name: 'lambda', route: '/' });
|
|
48
125
|
* agent.setPromptText('You are a helpful assistant.');
|
|
49
126
|
*
|
|
50
|
-
* const adapter = new ServerlessAdapter('
|
|
127
|
+
* const adapter = new ServerlessAdapter('lambda');
|
|
51
128
|
*
|
|
52
129
|
* export const handler = async (event: any) => {
|
|
53
130
|
* return adapter.handleRequest(agent.asRouter(), event);
|
|
@@ -73,13 +150,27 @@ export declare class ServerlessAdapter {
|
|
|
73
150
|
getPlatform(): ServerlessPlatform;
|
|
74
151
|
/**
|
|
75
152
|
* Convert a serverless event into a standard Request, route it through the Hono app, and return a normalized response.
|
|
153
|
+
*
|
|
154
|
+
* The app also receives, in its `env`, the URL the platform was called on,
|
|
155
|
+
* so a webhook signature is checked against the URL SignalWire signed: with
|
|
156
|
+
* an API Gateway stage or other platform prefix, and the query as the
|
|
157
|
+
* platform received it (for API Gateway REST, which decodes the query, both
|
|
158
|
+
* common encodings are tried).
|
|
159
|
+
*
|
|
76
160
|
* @param app - A Hono-compatible application with a `fetch` method.
|
|
77
161
|
* @param event - The incoming serverless event to process.
|
|
78
162
|
* @returns The normalized serverless response.
|
|
79
163
|
*/
|
|
80
164
|
handleRequest(app: {
|
|
81
|
-
fetch: (req: Request) => Response | Promise<Response>;
|
|
165
|
+
fetch: (req: Request, env?: Record<string, unknown>) => Response | Promise<Response>;
|
|
82
166
|
}, event: ServerlessEvent): Promise<ServerlessResponse>;
|
|
167
|
+
/**
|
|
168
|
+
* Reduce a Lambda-style event (a function URL, API Gateway REST or HTTP API
|
|
169
|
+
* event, or a hand-built event) to a {@link PlatformRequest}.
|
|
170
|
+
*/
|
|
171
|
+
private static fromEvent;
|
|
172
|
+
/** Route one reduced request through the app and normalize its response. */
|
|
173
|
+
private dispatch;
|
|
83
174
|
/**
|
|
84
175
|
* Generate the platform-specific invocation URL for a deployed function.
|
|
85
176
|
* @param opts - Optional overrides for region, project, function name, stage, or API ID.
|
|
@@ -98,7 +189,7 @@ export declare class ServerlessAdapter {
|
|
|
98
189
|
* @returns A function that accepts a Lambda event and returns a promise of a serverless response.
|
|
99
190
|
*/
|
|
100
191
|
static createLambdaHandler(app: {
|
|
101
|
-
fetch: (req: Request) => Response | Promise<Response>;
|
|
192
|
+
fetch: (req: Request, env?: Record<string, unknown>) => Response | Promise<Response>;
|
|
102
193
|
}): (event: ServerlessEvent) => Promise<ServerlessResponse>;
|
|
103
194
|
/**
|
|
104
195
|
* Create a Google Cloud Functions-compatible handler from a Hono app.
|
|
@@ -106,14 +197,72 @@ export declare class ServerlessAdapter {
|
|
|
106
197
|
* @returns A function that accepts GCF request/response objects.
|
|
107
198
|
*/
|
|
108
199
|
static createGcfHandler(app: {
|
|
109
|
-
fetch: (req: Request) => Response | Promise<Response>;
|
|
110
|
-
}): (req:
|
|
200
|
+
fetch: (req: Request, env?: Record<string, unknown>) => Response | Promise<Response>;
|
|
201
|
+
}): (req: GcfRequest, res: GcfResponse) => Promise<void>;
|
|
202
|
+
/**
|
|
203
|
+
* Reduce a Google Cloud Functions (Express-style) request. The signature is
|
|
204
|
+
* checked over the raw body, since a re-serialized parsed body can differ
|
|
205
|
+
* from the bytes SignalWire signed, and over the URL with its query.
|
|
206
|
+
*/
|
|
207
|
+
private static fromGcfRequest;
|
|
208
|
+
/**
|
|
209
|
+
* Reduce an Azure Functions request. Its URL is absolute, e.g.
|
|
210
|
+
* `https://app.azurewebsites.net/api/<function>/swaig?code=...`; the path
|
|
211
|
+
* below `/api/<function>` is routed, and the whole URL is what was signed.
|
|
212
|
+
*/
|
|
213
|
+
private static fromAzureRequest;
|
|
214
|
+
/**
|
|
215
|
+
* Reduce a CGI request from its environment and the body read from stdin.
|
|
216
|
+
* `PATH_INFO` is routed; the signed URL includes the script's own path
|
|
217
|
+
* (`SCRIPT_NAME`), as `REQUEST_URI` gives it.
|
|
218
|
+
*/
|
|
219
|
+
private static fromCgiEnv;
|
|
220
|
+
/** Maximum CGI request body size (10MB), matching Python's `MAX_CGI_BODY_SIZE`. */
|
|
221
|
+
static readonly MAX_CGI_BODY_SIZE: number;
|
|
222
|
+
/**
|
|
223
|
+
* Build a {@link ServerlessEvent} from a CGI environment + request body.
|
|
224
|
+
*
|
|
225
|
+
* CGI has no "event" object: the request is described by environment variables
|
|
226
|
+
* (`REQUEST_METHOD`, `PATH_INFO`, `QUERY_STRING`, `CONTENT_TYPE`, `HTTP_*`) and
|
|
227
|
+
* the body arrives on stdin. This reconstructs the normalized event so a CGI
|
|
228
|
+
* invocation dispatches through the same Hono routing as Lambda/GCF/Azure
|
|
229
|
+
* (mirrors Python `serverless_mixin` CGI mode: `PATH_INFO` + stdin body).
|
|
230
|
+
*
|
|
231
|
+
* @param env - The process environment (defaults to `process.env`).
|
|
232
|
+
* @param body - The already-read request body from stdin (optional).
|
|
233
|
+
* @returns A normalized serverless event.
|
|
234
|
+
*/
|
|
235
|
+
static buildCgiEvent(env?: NodeJS.ProcessEnv, body?: string): ServerlessEvent;
|
|
236
|
+
/**
|
|
237
|
+
* Create a CGI handler that reads the request from the CGI environment + stdin,
|
|
238
|
+
* routes it through the Hono app, and writes a CGI response (status line,
|
|
239
|
+
* headers, blank line, body) to stdout.
|
|
240
|
+
*
|
|
241
|
+
* @param app - A Hono-compatible application with a `fetch` method.
|
|
242
|
+
* @returns An async function that performs one CGI request/response cycle.
|
|
243
|
+
*/
|
|
244
|
+
static createCgiHandler(app: {
|
|
245
|
+
fetch: (req: Request, env?: Record<string, unknown>) => Response | Promise<Response>;
|
|
246
|
+
}): () => Promise<void>;
|
|
247
|
+
/**
|
|
248
|
+
* Run one CGI request/response cycle: read the body from stdin, route the
|
|
249
|
+
* request, write the CGI response to stdout, and return it.
|
|
250
|
+
* @internal Used by {@link createCgiHandler} and `AgentBase.runServerless`.
|
|
251
|
+
*/
|
|
252
|
+
_runCgi(app: {
|
|
253
|
+
fetch: (req: Request, env?: Record<string, unknown>) => Response | Promise<Response>;
|
|
254
|
+
}, env: NodeJS.ProcessEnv, body?: string, write?: (text: string) => void): Promise<ServerlessResponse>;
|
|
255
|
+
/** A complete CGI response: a status line, headers, a blank line, then the body. */
|
|
256
|
+
private static cgiResponseText;
|
|
257
|
+
/** Read the request body from stdin, honoring `CONTENT_LENGTH` when present. */
|
|
258
|
+
private readStdin;
|
|
111
259
|
/**
|
|
112
260
|
* Create an Azure Functions-compatible handler from a Hono app.
|
|
113
261
|
* @param app - A Hono-compatible application with a `fetch` method.
|
|
114
262
|
* @returns A function that accepts an Azure context and request object.
|
|
115
263
|
*/
|
|
116
264
|
static createAzureHandler(app: {
|
|
117
|
-
fetch: (req: Request) => Response | Promise<Response>;
|
|
118
|
-
}): (context:
|
|
265
|
+
fetch: (req: Request, env?: Record<string, unknown>) => Response | Promise<Response>;
|
|
266
|
+
}): (context: AzureContext, req: AzureRequest) => Promise<void>;
|
|
119
267
|
}
|
|
268
|
+
export {};
|