@molecule/app-http-axios 1.0.4 → 1.0.5

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-17T00:20:54.724Z
+Generated: 2026-10-17T07:40:43.120Z
 -->
 
 # @molecule/app-http-axios
@@ -13,6 +13,12 @@ Axios HTTP client provider for `@molecule/app-http`.
 This package provides an Axios-based implementation of the molecule HttpClient interface,
 allowing you to use molecule's HTTP abstractions with Axios.
 
+**The body is the SECOND argument: `post(url, data, config?)` — likewise `put` and `patch`.**
+`data` IS the request body, so `post(url, { data: body })` sends the JSON body
+`{"data":body}`, not `body`, and the API finds none of its fields at the top level (it
+answers `422 {"errors":{"username":["can't be blank"],…}}`). Write `post('/users', { user })`,
+never `post('/users', { data: { user } })`; a config (headers, params) is the THIRD argument.
+
 > **Auto-generated, AI-first package reference** for the [molecule.dev](https://molecule.dev) ecosystem.
 > It is written to be read by coding agents as much as by people, and is generated from this
 > package's source — edit `src/index.ts` JSDoc, not this file.
@@ -116,7 +122,8 @@ interface HttpClient {
    */
   defaultHeaders: Record<string, string>
   /**
-   * Makes a generic HTTP request.
+   * Makes a generic HTTP request. `data` is a field of THIS config object — the same body
+   * `post(url, data, config)` takes as its second argument.
    */
   request<T = unknown>(config: FullRequestConfig): Promise<HttpResponse<T>>
   /**
@@ -124,15 +131,19 @@ interface HttpClient {
    */
   get<T = unknown>(url: string, config?: RequestConfig): Promise<HttpResponse<T>>
   /**
-   * Makes a POST request.
+   * Makes a POST request. `data` is the request BODY, not a config object: the wire body is
+   * `data` itself, so `post(url, { data: body })` sends `{"data":body}` — pass `body` directly.
+   * A config (headers, params) is the THIRD argument.
    */
   post<T = unknown>(url: string, data?: unknown, config?: RequestConfig): Promise<HttpResponse<T>>
   /**
-   * Makes a PUT request.
+   * Makes a PUT request. `data` is the request BODY (second argument) — never `{ data: body }`,
+   * which sends `{"data":body}`; a config is the THIRD argument.
    */
   put<T = unknown>(url: string, data?: unknown, config?: RequestConfig): Promise<HttpResponse<T>>
   /**
-   * Makes a PATCH request.
+   * Makes a PATCH request. `data` is the request BODY (second argument) — never `{ data: body }`,
+   * which sends `{"data":body}`; a config is the THIRD argument.
    */
   patch<T = unknown>(url: string, data?: unknown, config?: RequestConfig): Promise<HttpResponse<T>>
   /**
@@ -255,7 +266,11 @@ interface RequestConfig {
    */
   signal?: AbortSignal
   /**
-   * Request body data.
+   * Request body data, as a field of THIS config object — the `request({ method, url, data })`
+   * form. The verb methods take the body as their SECOND argument: `post(url, data, config)`,
+   * `put(url, data, config)`, `patch(url, data, config)`. Never wrap it there as
+   * `{ data: body }`: that object is the body, so the wire sends `{"data":body}` and the API
+   * sees none of the fields at its top level.
    */
   data?: unknown
   /**
@@ -280,7 +295,7 @@ interface FullRequestConfig extends RequestConfig {
    */
   url: string
   /**
-   * Request body data.
+   * Request body data — a field of this config object, never a second argument here.
    */
   data?: unknown
 }

package/dist/index.d.ts

@@ -4,6 +4,12 @@
  * This package provides an Axios-based implementation of the molecule HttpClient interface,
  * allowing you to use molecule's HTTP abstractions with Axios.
  *
+ * **The body is the SECOND argument: `post(url, data, config?)` — likewise `put` and `patch`.**
+ * `data` IS the request body, so `post(url, { data: body })` sends the JSON body
+ * `{"data":body}`, not `body`, and the API finds none of its fields at the top level (it
+ * answers `422 {"errors":{"username":["can't be blank"],…}}`). Write `post('/users', { user })`,
+ * never `post('/users', { data: { user } })`; a config (headers, params) is the THIRD argument.
+ *
  * @module `@molecule/app-http-axios`
  *
  * @example

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -4,6 +4,12 @@
  * This package provides an Axios-based implementation of the molecule HttpClient interface,
  * allowing you to use molecule's HTTP abstractions with Axios.
  *
+ * **The body is the SECOND argument: `post(url, data, config?)` — likewise `put` and `patch`.**
+ * `data` IS the request body, so `post(url, { data: body })` sends the JSON body
+ * `{"data":body}`, not `body`, and the API finds none of its fields at the top level (it
+ * answers `422 {"errors":{"username":["can't be blank"],…}}`). Write `post('/users', { user })`,
+ * never `post('/users', { data: { user } })`; a config (headers, params) is the THIRD argument.
+ *
  * @module `@molecule/app-http-axios`
  *
  * @example

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/app-http-axios",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Axios HTTP client provider for @molecule/app-http",
   "type": "module",
   "main": "dist/index.js",