From 855fad8ec92e143280cfd35989156c2fc35df01a Mon Sep 17 00:00:00 2001
From: Matt Leon <mattleon@google.com>
Date: Wed, 3 Jun 2026 10:57:37 -0400
Subject: [PATCH] Add IWYU pragmas to SDK headers

This directs clang to recommend including `proxy_wasm_intrinsics.h` rather than
the individual headers, which is the pattern displayed by the examples.

Signed-off-by: Matt Leon <mattleon@google.com>
---
 proxy_wasm_api.h             | 3 +++
 proxy_wasm_common.h          | 3 +++
 proxy_wasm_enums.h           | 3 +++
 proxy_wasm_externs.h         | 3 +++
 proxy_wasm_intrinsics.h      | 2 ++
 proxy_wasm_intrinsics_full.h | 2 +-
 proxy_wasm_intrinsics_lite.h | 2 +-
 7 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/proxy_wasm_api.h b/proxy_wasm_api.h
index f9f49b8..90028b9 100644
--- a/proxy_wasm_api.h
+++ b/proxy_wasm_api.h
@@ -21,6 +21,9 @@
 // NOLINT(namespace-envoy)
 #pragma once
 
+// IWYU pragma: private, include "proxy_wasm_intrinsics.h"
+// IWYU pragma: friend "proxy_wasm_.*"
+
 #ifdef PROXY_WASM_PROTOBUF
 #include "google/protobuf/message_lite.h"
 #endif
diff --git a/proxy_wasm_common.h b/proxy_wasm_common.h
index 0787cd8..c0cf873 100644
--- a/proxy_wasm_common.h
+++ b/proxy_wasm_common.h
@@ -21,6 +21,9 @@
 // NOLINT(namespace-envoy)
 #pragma once
 
+// IWYU pragma: private, include "proxy_wasm_intrinsics.h"
+// IWYU pragma: friend "proxy_wasm_.*"
+
 #include <cstdint>
 #include <string>
 
diff --git a/proxy_wasm_enums.h b/proxy_wasm_enums.h
index ca42126..712c115 100644
--- a/proxy_wasm_enums.h
+++ b/proxy_wasm_enums.h
@@ -21,6 +21,9 @@
 // NOLINT(namespace-envoy)
 #pragma once
 
+// IWYU pragma: private, include "proxy_wasm_intrinsics.h"
+// IWYU pragma: friend "proxy_wasm_.*"
+
 #include <cstdint>
 
 // Severity levels for logging operations.
diff --git a/proxy_wasm_externs.h b/proxy_wasm_externs.h
index 03461a1..83057af 100644
--- a/proxy_wasm_externs.h
+++ b/proxy_wasm_externs.h
@@ -21,6 +21,9 @@
 // NOLINT(namespace-envoy)
 #pragma once
 
+// IWYU pragma: private, include "proxy_wasm_intrinsics.h"
+// IWYU pragma: friend "proxy_wasm_.*"
+
 #include <stddef.h>
 #include <stdint.h>
 
diff --git a/proxy_wasm_intrinsics.h b/proxy_wasm_intrinsics.h
index 3c8fbc1..b8724a8 100644
--- a/proxy_wasm_intrinsics.h
+++ b/proxy_wasm_intrinsics.h
@@ -29,6 +29,7 @@
 #define START_WASM_PLUGIN(_x)
 #define END_WASM_PLUGIN
 
+// IWYU pragma: begin_exports
 #include <cstdint>
 #include <string_view>
 #include <optional>
@@ -45,3 +46,4 @@
 #include "proxy_wasm_intrinsics_lite.pb.h"
 #endif
 #include "proxy_wasm_api.h"
+// IWYU pragma: end_exports
diff --git a/proxy_wasm_intrinsics_full.h b/proxy_wasm_intrinsics_full.h
index 07a4931..e712573 100644
--- a/proxy_wasm_intrinsics_full.h
+++ b/proxy_wasm_intrinsics_full.h
@@ -22,4 +22,4 @@
 #pragma once
 
 #define PROXY_WASM_PROTOBUF_FULL 1
-#include "proxy_wasm_intrinsics.h"
+#include "proxy_wasm_intrinsics.h" // IWYU pragma: export
diff --git a/proxy_wasm_intrinsics_lite.h b/proxy_wasm_intrinsics_lite.h
index 9792ff5..b9af437 100644
--- a/proxy_wasm_intrinsics_lite.h
+++ b/proxy_wasm_intrinsics_lite.h
@@ -22,4 +22,4 @@
 #pragma once
 
 #define PROXY_WASM_PROTOBUF_LITE 1
-#include "proxy_wasm_intrinsics.h"
+#include "proxy_wasm_intrinsics.h" // IWYU pragma: export