chore: import upstream snapshot with attribution

2026-07-13 12:31:57 +08:00
commit d718c5a372
986 changed files with 74597 additions and 0 deletions
@@ -0,0 +1,39 @@
+INSERT INTO sqlpage_functions (
+        "name",
+        "introduced_in_version",
+        "icon",
+        "description_md"
+    )
+VALUES (
+        'headers',
+        '0.33.0',
+        'circle-dotted-letter-h',
+        'Returns all HTTP request headers as a JSON object.
+
+### Example
+
+The following displays all HTTP request headers in a list,
+using SQLite''s `json_each()` function.
+
+```sql
+select ''list'' as component;
+
+select key as title, value as description
+from json_each(sqlpage.headers()); -- json_each() is SQLite only
+```
+
+If not on SQLite, use your [database''s JSON function](/blog.sql?post=JSON%20in%20SQL%3A%20A%20Comprehensive%20Guide).
+
+### Details
+
+The function returns a JSON object where:
+- Keys are lowercase header names
+- Values are the corresponding header values
+- If no headers are present, returns an empty JSON object `{}`
+
+This is useful when you need to:
+- Debug HTTP requests
+- Access multiple headers at once
+
+If you only need access to a single known header, use [`sqlpage.header(name)`](?function=header) instead.
+');