docs(apps): require HTTP action for external requests

package.json

@@ -1,7 +1,7 @@
 {
     "name": "@datadog/build-plugins",
     "private": true,
-    "version": "3.2.12",
+    "version": "3.2.13",
     "license": "MIT",
     "author": "Datadog",
     "description": "Root of Datadog's Build Plugins monorepo",

packages/plugins/apps/README.md

@@ -15,6 +15,7 @@ A plugin to upload assets to Datadog's storage
 <!-- #toc -->
 -   [Configuration](#configuration)
 -   [Assets Upload](#assets-upload)
+    -   [External HTTP requests](#external-http-requests)
     -   [apps.dryRun](#appsdryrun)
     -   [apps.enable](#appsenable)
     -   [apps.include](#appsinclude)
@@ -58,6 +59,29 @@ Upload built assets to Datadog storage as a compressed archive.
 > You can override the domain used in the request with the `DATADOG_SITE` environment variable or the `auth.site` options (eg. `datadoghq.eu`).
 > You can override the full intake URL by setting the `DATADOG_APPS_INTAKE_URL` environment variable (eg. `https://apps-intake.datadoghq.com/api/v1/apps`).
 
+### External HTTP requests
+
+External HTTP requests from an app must use the generic HTTP action from the Action Catalog in a backend function. Do not call `fetch` or use Node.js networking APIs to access an external service directly.
+
+```ts
+import { request } from '@datadog/action-catalog/http/http';
+
+export async function getExternalData() {
+    return request({
+        inputs: {
+            verb: 'GET',
+            url: 'https://api.example.com/data',
+            responseParsing: 'json',
+            errorOnStatus: ['400-599'],
+        },
+    });
+}
+```
+
+An HTTP connection is not required. Omit `connectionId` unless an HTTP connection already exists in the user's Datadog organization and contains authentication information the request needs. Connections must be created manually in the Datadog UI and their IDs copied into the app, so most external requests will not use one. When a suitable connection does exist, pass its ID as `connectionId` alongside `inputs`.
+
+Frontend code should call the backend function rather than contacting the external service directly.
+
 ### apps.dryRun
 
 > default: `true`

packages/published/esbuild-plugin/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@datadog/esbuild-plugin",
     "packageManager": "yarn@4.0.2",
-    "version": "3.2.12",
+    "version": "3.2.13",
     "license": "MIT",
     "author": "Datadog",
     "description": "Datadog ESBuild Plugin",

packages/published/rollup-plugin/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@datadog/rollup-plugin",
     "packageManager": "yarn@4.0.2",
-    "version": "3.2.12",
+    "version": "3.2.13",
     "license": "MIT",
     "author": "Datadog",
     "description": "Datadog Rollup Plugin",

packages/published/rspack-plugin/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@datadog/rspack-plugin",
     "packageManager": "yarn@4.0.2",
-    "version": "3.2.12",
+    "version": "3.2.13",
     "license": "MIT",
     "author": "Datadog",
     "description": "Datadog Rspack Plugin",

packages/published/vite-plugin/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@datadog/vite-plugin",
     "packageManager": "yarn@4.0.2",
-    "version": "3.2.12",
+    "version": "3.2.13",
     "license": "MIT",
     "author": "Datadog",
     "description": "Datadog Vite Plugin",

packages/published/webpack-plugin/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@datadog/webpack-plugin",
     "packageManager": "yarn@4.0.2",
-    "version": "3.2.12",
+    "version": "3.2.13",
     "license": "MIT",
     "author": "Datadog",
     "description": "Datadog Webpack Plugin",