@automate.ax/codec 0.81.0 → 0.82.0

package/dist/http.d.ts

@@ -0,0 +1,17 @@
+import * as z from "zod/mini";
+declare const JSON_VALUE_SCHEMA: z.ZodMiniJSONSchema;
+export type JsonValue = z.infer<typeof JSON_VALUE_SCHEMA>;
+export type HttpRequestBody = JsonValue | Uint8Array;
+export type HttpRequestBodyType = "bytes" | "empty" | "form" | "json" | "text";
+export type DecodedHttpRequestBody = {
+    body: HttpRequestBody;
+    bodyType: HttpRequestBodyType;
+};
+/**
+ * Decodes HTTP request bytes according to the declared media type.
+ *
+ * @param rawBody - Exact request body bytes.
+ * @param contentType - Declared Content-Type header, when present.
+ */
+export declare function decodeHttpRequestBody(rawBody: Uint8Array, contentType?: string): DecodedHttpRequestBody;
+export {};

package/dist/http.js

@@ -0,0 +1,52 @@
+import * as z from "zod/mini";
+const JSON_VALUE_SCHEMA = z.json();
+/**
+ * Decodes HTTP request bytes according to the declared media type.
+ *
+ * @param rawBody - Exact request body bytes.
+ * @param contentType - Declared Content-Type header, when present.
+ */
+export function decodeHttpRequestBody(rawBody, contentType) {
+    if (rawBody.byteLength === 0) {
+        return { body: null, bodyType: "empty" };
+    }
+    const mediaType = contentType?.split(";", 1)[0]?.trim().toLowerCase() ?? "";
+    if (mediaType === "application/x-www-form-urlencoded") {
+        const values = new Map();
+        for (const [key, value] of new URLSearchParams(decodeText(rawBody))) {
+            const existing = values.get(key);
+            if (existing)
+                existing.push(value);
+            else
+                values.set(key, [value]);
+        }
+        return {
+            body: Object.fromEntries([...values].map(([key, entries]) => [
+                key,
+                entries.length === 1 ? entries[0] : entries,
+            ])),
+            bodyType: "form",
+        };
+    }
+    if (mediaType === "application/json" || mediaType.endsWith("+json")) {
+        return {
+            body: JSON_VALUE_SCHEMA.parse(JSON.parse(decodeText(rawBody))),
+            bodyType: "json",
+        };
+    }
+    if (mediaType.startsWith("text/") ||
+        mediaType === "application/javascript" ||
+        mediaType === "application/xml" ||
+        mediaType.endsWith("+xml")) {
+        return { body: decodeText(rawBody), bodyType: "text" };
+    }
+    return { body: rawBody, bodyType: "bytes" };
+}
+/**
+ * Decodes request bytes as UTF-8, replacing invalid byte sequences.
+ *
+ * @param rawBody - Exact request body bytes.
+ */
+function decodeText(rawBody) {
+    return new TextDecoder().decode(rawBody);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/codec",
-  "version": "0.81.0",
+  "version": "0.82.0",
   "description": "Msgpack-based encoding helpers for Automate.ax runtime data.",
   "license": "MIT",
   "repository": {
@@ -19,6 +19,7 @@
   "zshy": {
     "exports": {
       ".": "./src/index.ts",
+      "./http": "./src/http.ts",
       "./*": "./src/*"
     },
     "cjs": false,
@@ -32,6 +33,11 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./http": {
+      "bun": "./src/http.ts",
+      "types": "./dist/http.d.ts",
+      "default": "./dist/http.js"
+    },
     "./*": {
       "bun": "./src/*",
       "types": "./dist/*",

package/src/http.ts

@@ -0,0 +1,75 @@
+import * as z from "zod/mini"
+
+const JSON_VALUE_SCHEMA = z.json()
+
+export type JsonValue = z.infer<typeof JSON_VALUE_SCHEMA>
+
+export type HttpRequestBody = JsonValue | Uint8Array
+
+export type HttpRequestBodyType = "bytes" | "empty" | "form" | "json" | "text"
+
+export type DecodedHttpRequestBody = {
+  body: HttpRequestBody
+  bodyType: HttpRequestBodyType
+}
+
+/**
+ * Decodes HTTP request bytes according to the declared media type.
+ *
+ * @param rawBody - Exact request body bytes.
+ * @param contentType - Declared Content-Type header, when present.
+ */
+export function decodeHttpRequestBody(
+  rawBody: Uint8Array,
+  contentType?: string,
+): DecodedHttpRequestBody {
+  if (rawBody.byteLength === 0) {
+    return { body: null, bodyType: "empty" }
+  }
+
+  const mediaType = contentType?.split(";", 1)[0]?.trim().toLowerCase() ?? ""
+  if (mediaType === "application/x-www-form-urlencoded") {
+    const values = new Map<string, string[]>()
+    for (const [key, value] of new URLSearchParams(decodeText(rawBody))) {
+      const existing = values.get(key)
+      if (existing) existing.push(value)
+      else values.set(key, [value])
+    }
+    return {
+      body: Object.fromEntries(
+        [...values].map(([key, entries]): [string, string | string[]] => [
+          key,
+          entries.length === 1 ? entries[0]! : entries,
+        ]),
+      ),
+      bodyType: "form",
+    }
+  }
+
+  if (mediaType === "application/json" || mediaType.endsWith("+json")) {
+    return {
+      body: JSON_VALUE_SCHEMA.parse(JSON.parse(decodeText(rawBody))),
+      bodyType: "json",
+    }
+  }
+
+  if (
+    mediaType.startsWith("text/") ||
+    mediaType === "application/javascript" ||
+    mediaType === "application/xml" ||
+    mediaType.endsWith("+xml")
+  ) {
+    return { body: decodeText(rawBody), bodyType: "text" }
+  }
+
+  return { body: rawBody, bodyType: "bytes" }
+}
+
+/**
+ * Decodes request bytes as UTF-8, replacing invalid byte sequences.
+ *
+ * @param rawBody - Exact request body bytes.
+ */
+function decodeText(rawBody: Uint8Array) {
+  return new TextDecoder().decode(rawBody)
+}