@stdy/cli 0.15.2 → 0.15.3

package/README.md

@@ -67,6 +67,8 @@ Validator Options:
   --validator-strict-oneof             Require exactly one oneOf variant to match
   --validator-query-array-format=<fmt> Array query param serialization (see below)
   --validator-query-object-format=<fmt> Object query param serialization (see below)
+  --validator-form-array-format=<fmt>  Array form field serialization (see below)
+  --validator-form-object-format=<fmt> Object form field serialization (see below)
 
 Generator Options:
   --generator-array-size=<n>   Exact size for all generated arrays
@@ -103,6 +105,32 @@ per-request via headers.
 | `brackets`   | `id[role]=admin&id[firstName]=Alex` | `style=deepObject`          |
 | `dots`       | `id.role=admin&id.firstName=Alex`   | Non-standard (SDK compat)   |
 
+### Form Parameter Serialization
+
+Form body parameters (application/x-www-form-urlencoded) use the same formats as
+query parameters. Configure via CLI flags or per-request headers.
+
+**Array formats** (`--validator-form-array-format`):
+
+| Format     | Example                  | OpenAPI Equivalent             |
+| ---------- | ------------------------ | ------------------------------ |
+| `auto`     | Read from spec (default) | -                              |
+| `repeat`   | `tags=a&tags=b`          | `style=form, explode=true`     |
+| `comma`    | `tags=a,b`               | `style=form, explode=false`    |
+| `space`    | `tags=a%20b`             | `style=spaceDelimited`         |
+| `pipe`     | `tags=a\|b`              | `style=pipeDelimited`          |
+| `brackets` | `tags[]=a&tags[]=b`      | PHP/Rails style (non-standard) |
+
+**Object formats** (`--validator-form-object-format`):
+
+| Format       | Example                        | OpenAPI Equivalent          |
+| ------------ | ------------------------------ | --------------------------- |
+| `auto`       | Read from spec (default)       | -                           |
+| `flat`       | `name=sam&age=30`              | `style=form, explode=true`  |
+| `flat-comma` | `id=role,admin,firstName,Alex` | `style=form, explode=false` |
+| `brackets`   | `user[name]=sam`               | `style=deepObject`          |
+| `dots`       | `user.name=sam`                | Non-standard (SDK compat)   |
+
 ### Port Configuration
 
 The server port is determined in this order:
@@ -170,6 +198,8 @@ Override server behavior for individual requests:
 | `X-Steady-Mode`                | Override validation mode: `strict` or `relaxed`      |
 | `X-Steady-Query-Array-Format`  | Override array query param serialization format      |
 | `X-Steady-Query-Object-Format` | Override object query param serialization format     |
+| `X-Steady-Form-Array-Format`   | Override array form field serialization format       |
+| `X-Steady-Form-Object-Format`  | Override object form field serialization format      |
 | `X-Steady-Array-Size`          | Override array size (sets both min and max)          |
 | `X-Steady-Array-Min`           | Override minimum array size                          |
 | `X-Steady-Array-Max`           | Override maximum array size                          |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdy/cli",
-  "version": "0.15.2",
+  "version": "0.15.3",
   "description": "OpenAPI 3 mock server. Validates SDKs against OpenAPI specs with clear error attribution.",
   "license": "Elastic-2.0",
   "repository": {
@@ -29,10 +29,10 @@
     "node": ">=14.0.0"
   },
   "optionalDependencies": {
-    "@stdy/cli-linux-x64": "0.15.2",
-    "@stdy/cli-linux-arm64": "0.15.2",
-    "@stdy/cli-darwin-x64": "0.15.2",
-    "@stdy/cli-darwin-arm64": "0.15.2",
-    "@stdy/cli-win32-x64": "0.15.2"
+    "@stdy/cli-linux-x64": "0.15.3",
+    "@stdy/cli-linux-arm64": "0.15.3",
+    "@stdy/cli-darwin-x64": "0.15.3",
+    "@stdy/cli-darwin-arm64": "0.15.3",
+    "@stdy/cli-win32-x64": "0.15.3"
   }
 }