@supersoniks/concorde 4.9.91 → 4.9.93

package/docs/crawl/hubs/remote-data.html

@@ -153,10 +153,11 @@ dp(c</pre>
 <section id="docs-_decorators-get" data-doc-id="docs/_decorators/get">
   <h2><a href="../docs/_decorators/get.html">@get</a></h2>
   <p><strong>Doc ID:</strong> <code>docs/_decorators/get</code> · <a href="../docs/_decorators/get.html">full page</a></p>
-  <p>@get loads data and stores the result in an ApiResult&lt;T&gt; | null property.</p>
+  <p>@get loads data and stores the result in an optional ApiResult&lt;T&gt; property.</p>
   <pre class="doc-excerpt">@get
 
-@get loads data and stores the result in an ApiResult  | null property.
+@get loads data and stores the result in an optional ApiResult  property.
+The property is undefined until a result is available.
 
 - payload.result: typed data;
 - payload.response: the HTTP response;
@@ -168,7 +169,7 @@ const usersEndpoint = new Endpoint (&quot;users&quot;);
 
 @get(usersEndpoint)
 @state()
-payload: ApiResult  | null = null;
+payload?: ApiResult ;
 
 The first argument is always an
 Endpoint . API configuration is read
@@ -187,22 +188,20 @@ const usersGet = get(new Endpoint (&quot;users&quot;));
 
 @usersGet
 @state()
-payload: ApiResult  | null = null;
+payload?: ApiResult ;
 
-refresh() {
-  usersGet.refetch(this);
+async refresh() {
+  const payload = await usersGet.refetch(this);
+  console.log(payload?.result);
 }
 
-Options (GetOptions)
+refetch(component) returns a Promise  | undefined&gt; that resolves
+after the GET has completed.
 
-Options are the second argument, or the third argument when an API
-configuration key is provided.
+From a method decorator
 
-- skipEmptyPlaceholder: blocks the GET when ${prop} is &quot;&quot;.
-- refetchEveryMs: automatically runs the GET again after this interval
-  (milliseconds). Omit the option, or use 0, to disable polling.
-
-With a configurat</pre>
+The refetch can decorate a local method. The default is after; if the
+method returns a Promise, the GET waits for its resol</pre>
 </section>
 <section id="docs-_decorators-patch" data-doc-id="docs/_decorators/patch">
   <h2><a href="../docs/_decorators/patch.html">@patch</a></h2>
@@ -222,14 +221,18 @@ const patchUser = patch(new Endpoint (&quot;users/42&quot;), bodyKey);
 
 @patchUser
 @state()
-payload: ApiResult  | null = null;
+payload?: ApiResult ;
 
 To run the operation again from the component:
 
-savePatch() {
-  patchUser.send(this);
+async savePatch() {
+  await patchUser.send(this);
 }
 
+send(component) returns a Promise resolved after the PATCH completes. See
+@post for the method-decorator form and the
+when: &quot;before&quot; option.
+
 The PATCH is also sent automatically when the body mutates, unless
 autoPostOnBodyMutation: false is set. The available options are described in
 @post:
@@ -238,6 +241,7 @@ autoPostOnBodyMutation: false is set. The available options are described in
 - skipIfBodyMissing
 - refetchEveryMs
 - skipEmptyPlaceholder
+- triggerKey
 
 Pass explicit API configuration as the third argument:
 
@@ -251,9 +255,7 @@ import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
 
 See also
 
-- @post — options and triggers
-- @put — full replacement
-- Dynamic path placeholders</pre>
+- @post —</pre>
 </section>
 <section id="docs-_decorators-post" data-doc-id="docs/_decorators/post">
   <h2><a href="../docs/_decorators/post.html">@post</a></h2>
@@ -262,7 +264,8 @@ See also
   <pre class="doc-excerpt">@post
 
 @post sends the contents of a publisher and stores the response in an
-ApiResult  | null property.
+optional ApiResult  property. The property is undefined until a result
+is available.
 
 Minimal usage
 
@@ -273,7 +276,7 @@ const createUser = post(new Endpoint (&quot;users&quot;), userBodyKey);
 
 @createUser
 @state()
-payload: ApiResult  | null = null;
+payload?: ApiResult ;
 
 The current body is read from userBodyKey. By default, the POST is sent when
 the component connects and after each body mutation. Mutations in the same
@@ -289,23 +292,19 @@ From the component
 Keep the decorator to access send(component). The body is read again when the
 operation runs.
 
-saveAgain() {
-  createUser.send(this);
+async saveAgain() {
+  const payload = await createUser.send(this);
+  console.log(payload?.result);
 }
 
-send() is useful for “Save” or “Retry” buttons. It can repeat an operation
-with side effects.
+send() returns a Promise  | undefined&gt; that resolves after the
+operation completes. It is useful for “Save” or “Retry” buttons and can repeat
+an operation with side effects.
 
-Options (PostOptions)
+From a method decorator
 
-Options are the third argument, or the fourth argument when a configuration key
-is provided.
-
-- autoPostOnBodyMutation: send after a body mutation (default: true). Set
-  it to false to use send().
-- skipIfBodyMissing: skip when the body is null or undefined (default:
-  true).
-- refetchE</pre>
+The send action can decorate a local method. It runs after the method by
+default, waits for an eventu</pre>
 </section>
 <section id="docs-_decorators-put" data-doc-id="docs/_decorators/put">
   <h2><a href="../docs/_decorators/put.html">@put</a></h2>
@@ -325,14 +324,18 @@ const updateUser = put(new Endpoint (&quot;users/42&quot;), bodyKey);
 
 @updateUser
 @state()
-payload: ApiResult  | null = null;
+payload?: ApiResult ;
 
 To run the operation again from the component:
 
-update() {
-  updateUser.send(this);
+async update() {
+  await updateUser.send(this);
 }
 
+send(component) returns a Promise resolved after the PUT completes. See
+@post for the method-decorator form and the
+when: &quot;before&quot; option.
+
 The PUT is also sent automatically when the body mutates, unless
 autoPostOnBodyMutation: false is set. See
 @post for the option details:
@@ -341,6 +344,7 @@ autoPostOnBodyMutation: false is set. See
 - skipIfBodyMissing
 - refetchEveryMs
 - skipEmptyPlaceholder
+- triggerKey
 
 Pass explicit API configuration as the third argument:
 
@@ -355,8 +359,7 @@ import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
 See also
 
 - @post — options and triggers
-- @patch — partial update
-- Dynamic path placeholders</pre>
+- @</pre>
 </section>
 <section id="docs-_misc-api-configuration" data-doc-id="docs/_misc/api-configuration">
   <h2><a href="../docs/_misc/api-configuration.html">API configuration</a></h2>

package/docs/index.html

@@ -10,8 +10,8 @@
     <!-- <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
      -->
     <script src="https://cdn.jsdelivr.net/npm/marked@13.0.3"></script>
-    <script type="module" crossorigin src="./assets/index-DVn8AeyA.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-BL6WVF7g.css">
+    <script type="module" crossorigin src="./assets/index-DURr6O71.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-D2Q3JyQ6.css">
   </head>
   <body class="px-6 lg:px-20">
     <sonic-theme

package/docs/llms-full.txt

@@ -3134,16 +3134,17 @@ Shared data: Sharing data.
 
 - URL: https://concorde.supersoniks.org/crawl/docs/_decorators/get.html
 - Doc ID: docs/_decorators/get
-- Keywords: Concorde, supersoniks, docs/_decorators/get, get, @get, decorator, ApiResult | null, payload.result, payload.response, payload.request, 
+- Keywords: Concorde, supersoniks, docs/_decorators/get, get, @get, decorator, ApiResult, undefined, payload.result, payload.response, payload.request, 
 
 The first argument is always an
 [, serviceURL, refetch(component), 
 
-## Options (, skipEmptyPlaceholder
+
 
 @get
 
-@get loads data and stores the result in an ApiResult  | null property.
+@get loads data and stores the result in an optional ApiResult  property.
+The property is undefined until a result is available.
 
 - payload.result: typed data;
 - payload.response: the HTTP response;
@@ -3155,7 +3156,7 @@ const usersEndpoint = new Endpoint ("users");
 
 @get(usersEndpoint)
 @state()
-payload: ApiResult  | null = null;
+payload?: ApiResult ;
 
 The first argument is always an
 Endpoint . API configuration is read
@@ -3174,12 +3175,39 @@ const usersGet = get(new Endpoint ("users"));
 
 @usersGet
 @state()
-payload: ApiResult  | null = null;
+payload?: ApiResult ;
+
+async refresh() {
+  const payload = await usersGet.refetch(this);
+  console.log(payload?.result);
+}
+
+refetch(component) returns a Promise  | undefined> that resolves
+after the GET has completed.
+
+From a method decorator
+
+The refetch can decorate a local method. The default is after; if the
+method returns a Promise, the GET waits for its resolution. The decorated method
+call also waits for the refetch to complete.
+
+import { refetch } from "@supersoniks/concorde/decorators";
 
-refresh() {
-  usersGet.refetch(this);
+@refetch(usersGet)
+async reload() {
+  this.userId = "42";
 }
 
+Use { when: "before" } when the GET must complete before the method runs:
+
+@refetch(usersGet, { when: "before" })
+reloadBefore() {
+  // The refetch has completed before this method runs.
+}
+
+The method decorator adds an explicit trigger; changes to dynamic endpoint
+properties and configuration publishers keep their existing automatic behavior.
+
 Options (GetOptions)
 
 Options are the second argument, or the third argument when an API
@@ -3188,6 +3216,7 @@ configuration key is provided.
 - skipEmptyPlaceholder: blocks the GET when ${prop} is "".
 - refetchEveryMs: automatically runs the GET again after this interval
   (milliseconds). Omit the option, or use 0, to disable polling.
+- triggerKey: a publisher whose invalidate() runs the GET again.
 
 With a configuration key, use:
 
@@ -3198,6 +3227,7 @@ When the GET runs again
 - when the component connects and configuration is available;
 - when a property used in ${...} changes;
 - when a configuration publisher changes;
+- when the triggerKey publisher is invalidated;
 - after each response when refetchEveryMs is set.
 
 See Dynamic path placeholders for
@@ -3725,7 +3755,9 @@ Notes
 
 - URL: https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html
 - Doc ID: docs/_decorators/patch
-- Keywords: Concorde, supersoniks, docs/_decorators/patch, patch, @patch, decorator, Endpoint, DataProviderKey, ApiResult, send(component), autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing, refetchEveryMs, skipEmptyPlaceholder
+- Keywords: Concorde, supersoniks, docs/_decorators/patch, patch, @patch, decorator, Endpoint, DataProviderKey, ApiResult, send(component), 
+
+, when: "before", autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing
 
 @patch
 
@@ -3741,14 +3773,18 @@ const patchUser = patch(new Endpoint ("users/42"), bodyKey);
 
 @patchUser
 @state()
-payload: ApiResult  | null = null;
+payload?: ApiResult ;
 
 To run the operation again from the component:
 
-savePatch() {
-  patchUser.send(this);
+async savePatch() {
+  await patchUser.send(this);
 }
 
+send(component) returns a Promise resolved after the PATCH completes. See
+@post for the method-decorator form and the
+when: "before" option.
+
 The PATCH is also sent automatically when the body mutates, unless
 autoPostOnBodyMutation: false is set. The available options are described in
 @post:
@@ -3757,6 +3793,7 @@ autoPostOnBodyMutation: false is set. The available options are described in
 - skipIfBodyMissing
 - refetchEveryMs
 - skipEmptyPlaceholder
+- triggerKey
 
 Pass explicit API configuration as the third argument:
 
@@ -3780,16 +3817,19 @@ See also
 
 - URL: https://concorde.supersoniks.org/crawl/docs/_decorators/post.html
 - Doc ID: docs/_decorators/post
-- Keywords: Concorde, supersoniks, docs/_decorators/post, post, @post, decorator, ApiResult | null, Endpoint, DataProviderKey, 
+- Keywords: Concorde, supersoniks, docs/_decorators/post, post, @post, decorator, ApiResult, undefined, Endpoint, DataProviderKey, 
 
 The current body is read from , send(component), 
 
-, PostOptions, autoPostOnBodyMutation, true
+,  returns a , 
+
+Use 
 
 @post
 
 @post sends the contents of a publisher and stores the response in an
-ApiResult  | null property.
+optional ApiResult  property. The property is undefined until a result
+is available.
 
 Minimal usage
 
@@ -3800,7 +3840,7 @@ const createUser = post(new Endpoint ("users"), userBodyKey);
 
 @createUser
 @state()
-payload: ApiResult  | null = null;
+payload?: ApiResult ;
 
 The current body is read from userBodyKey. By default, the POST is sent when
 the component connects and after each body mutation. Mutations in the same
@@ -3816,12 +3856,38 @@ From the component
 Keep the decorator to access send(component). The body is read again when the
 operation runs.
 
-saveAgain() {
-  createUser.send(this);
+async saveAgain() {
+  const payload = await createUser.send(this);
+  console.log(payload?.result);
+}
+
+send() returns a Promise  | undefined> that resolves after the
+operation completes. It is useful for “Save” or “Retry” buttons and can repeat
+an operation with side effects.
+
+From a method decorator
+
+The send action can decorate a local method. It runs after the method by
+default, waits for an eventual Promise to resolve, and the decorated method
+call waits for the send to complete:
+
+import { send } from "@supersoniks/concorde/decorators";
+
+@send(createUser)
+async save() {
+  // Prepare local state or validate the form.
+}
+
+Use { when: "before" } when the send must complete before the method runs:
+
+@send(createUser, { when: "before" })
+saveBefore() {
+  // The POST has completed before this method runs.
 }
 
-send() is useful for “Save” or “Retry” buttons. It can repeat an operation
-with side effects.
+The method decorator adds an explicit send. If the method also mutates the body
+publisher, set autoPostOnBodyMutation: false when the decorated method must
+be the only trigger.
 
 Options (PostOptions)
 
@@ -3836,6 +3902,7 @@ is provided.
   repeating the operation is intended.
 - skipEmptyPlaceholder: block the request when a ${...} placeholder is
   "".
+- triggerKey: a publisher whose invalidate() sends the POST again.
 
 With a configuration key:
 
@@ -3850,6 +3917,7 @@ When the POST is sent
 - after a body mutation, unless autoPostOnBodyMutation: false;
 - when a property used in ${...} changes;
 - when a configuration publisher changes;
+- when the triggerKey publisher is invalidated;
 - when send() is called;
 - after each response when refetchEveryMs is set.
 
@@ -3923,7 +3991,9 @@ Dynamic paths use the same placeholder rules as @bind / @subscribe. Resolution a
 
 - URL: https://concorde.supersoniks.org/crawl/docs/_decorators/put.html
 - Doc ID: docs/_decorators/put
-- Keywords: Concorde, supersoniks, docs/_decorators/put, put, @put, decorator, Endpoint, DataProviderKey, ApiResult, send(component), autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing, refetchEveryMs, skipEmptyPlaceholder
+- Keywords: Concorde, supersoniks, docs/_decorators/put, put, @put, decorator, Endpoint, DataProviderKey, ApiResult, send(component), 
+
+, when: "before", autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing
 
 @put
 
@@ -3939,14 +4009,18 @@ const updateUser = put(new Endpoint ("users/42"), bodyKey);
 
 @updateUser
 @state()
-payload: ApiResult  | null = null;
+payload?: ApiResult ;
 
 To run the operation again from the component:
 
-update() {
-  updateUser.send(this);
+async update() {
+  await updateUser.send(this);
 }
 
+send(component) returns a Promise resolved after the PUT completes. See
+@post for the method-decorator form and the
+when: "before" option.
+
 The PUT is also sent automatically when the body mutates, unless
 autoPostOnBodyMutation: false is set. See
 @post for the option details:
@@ -3955,6 +4029,7 @@ autoPostOnBodyMutation: false is set. See
 - skipIfBodyMissing
 - refetchEveryMs
 - skipEmptyPlaceholder
+- triggerKey
 
 Pass explicit API configuration as the third argument:
 

package/docs/llms.txt

@@ -71,7 +71,7 @@ Custom
 - [@ancestorAttribute](https://concorde.supersoniks.org/crawl/docs/_decorators/ancestor-attribute.html) (docs/_decorators/ancestor-attribute): The @ancestorAttribute decorator automatically injects the value of an ancestor's attribute into a class property at the time of connectedCallback.
 - [@autoSubscribe](https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html) (docs/_decorators/auto-subscribe): > Legacy: prefer @subscribe + DataProviderKey. Examples below may still show PublisherManager for existing codebases.
 - [@bind](https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html) (docs/_decorators/bind): Binds a class property to a path in a publisher. The property updates when publisher data changes.
-- [@get](https://concorde.supersoniks.org/crawl/docs/_decorators/get.html) (docs/_decorators/get): @get loads data and stores the result in an ApiResult<T> | null property.
+- [@get](https://concorde.supersoniks.org/crawl/docs/_decorators/get.html) (docs/_decorators/get): @get loads data and stores the result in an optional ApiResult<T> property.
 - [@handle](https://concorde.supersoniks.org/crawl/docs/_decorators/handle.html) (docs/_decorators/handle): Typed callback on one or more DataProviderKey<T> paths: invokes the decorated method when a publisher assigns a value (calculations, side effects, updating other @state properties, etc.).
 - [@onAssign](https://concorde.supersoniks.org/crawl/docs/_decorators/on-assign.html) (docs/_decorators/on-assign): > New apps: use @handle with DataProviderKey (Data flow). @onAssign uses untyped string paths; it remains documented for existing codebases — see Migrating to @handle below.
 - [@patch](https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html) (docs/_decorators/patch): @patch applies a partial update with the body from a publisher. It uses the

package/docs/src/docs/_decorators/get.md

@@ -1,6 +1,7 @@
 # @get
 
-`@get` loads data and stores the result in an `ApiResult<T> | null` property.
+`@get` loads data and stores the result in an optional `ApiResult<T>` property.
+The property is `undefined` until a result is available.
 
 - `payload.result`: typed data;
 - `payload.response`: the HTTP response;
@@ -13,7 +14,7 @@ const usersEndpoint = new Endpoint<User[]>("users");
 
 @get(usersEndpoint)
 @state()
-payload: ApiResult<User[]> | null = null;
+payload?: ApiResult<User[]>;
 ```
 
 The first argument is always an
@@ -34,13 +35,44 @@ const usersGet = get(new Endpoint<User[]>("users"));
 
 @usersGet
 @state()
-payload: ApiResult<User[]> | null = null;
+payload?: ApiResult<User[]>;
 
-refresh() {
-  usersGet.refetch(this);
+async refresh() {
+  const payload = await usersGet.refetch(this);
+  console.log(payload?.result);
 }
 ```
 
+`refetch(component)` returns a `Promise<ApiResult<T> | undefined>` that resolves
+after the GET has completed.
+
+### From a method decorator
+
+The refetch can decorate a local method. The default is `after`; if the
+method returns a Promise, the GET waits for its resolution. The decorated method
+call also waits for the refetch to complete.
+
+```typescript
+import { refetch } from "@supersoniks/concorde/decorators";
+
+@refetch(usersGet)
+async reload() {
+  this.userId = "42";
+}
+```
+
+Use `{ when: "before" }` when the GET must complete before the method runs:
+
+```typescript
+@refetch(usersGet, { when: "before" })
+reloadBefore() {
+  // The refetch has completed before this method runs.
+}
+```
+
+The method decorator adds an explicit trigger; changes to dynamic endpoint
+properties and configuration publishers keep their existing automatic behavior.
+
 ## Options (`GetOptions`)
 
 Options are the second argument, or the third argument when an API
@@ -49,6 +81,7 @@ configuration key is provided.
 - `skipEmptyPlaceholder`: blocks the GET when `${prop}` is `""`.
 - `refetchEveryMs`: automatically runs the GET again after this interval
   (milliseconds). Omit the option, or use `0`, to disable polling.
+- `triggerKey`: a publisher whose `invalidate()` runs the GET again.
 
 With a configuration key, use:
 
@@ -61,6 +94,7 @@ With a configuration key, use:
 - when the component connects and configuration is available;
 - when a property used in `${...}` changes;
 - when a configuration publisher changes;
+- when the `triggerKey` publisher is invalidated;
 - after each response when `refetchEveryMs` is set.
 
 See [Dynamic path placeholders](#docs/_misc/dynamic-path.md/dynamic-path) for

package/docs/src/docs/_decorators/patch.md

@@ -13,17 +13,21 @@ const patchUser = patch(new Endpoint<User>("users/42"), bodyKey);
 
 @patchUser
 @state()
-payload: ApiResult<User> | null = null;
+payload?: ApiResult<User>;
 ```
 
 To run the operation again from the component:
 
 ```typescript
-savePatch() {
-  patchUser.send(this);
+async savePatch() {
+  await patchUser.send(this);
 }
 ```
 
+`send(component)` returns a Promise resolved after the PATCH completes. See
+[@post](#docs/_decorators/post.md/post) for the method-decorator form and the
+`when: "before"` option.
+
 The PATCH is also sent automatically when the body mutates, unless
 `autoPostOnBodyMutation: false` is set. The available options are described in
 [@post](#docs/_decorators/post.md/post):
@@ -32,6 +36,7 @@ The PATCH is also sent automatically when the body mutates, unless
 - `skipIfBodyMissing`
 - `refetchEveryMs`
 - `skipEmptyPlaceholder`
+- `triggerKey`
 
 Pass explicit API configuration as the third argument:
 

package/docs/src/docs/_decorators/post.md

@@ -1,7 +1,8 @@
 # @post
 
 `@post` sends the contents of a publisher and stores the response in an
-`ApiResult<T> | null` property.
+optional `ApiResult<T>` property. The property is `undefined` until a result
+is available.
 
 ## Minimal usage
 
@@ -13,7 +14,7 @@ const createUser = post(new Endpoint<User>("users"), userBodyKey);
 
 @createUser
 @state()
-payload: ApiResult<User> | null = null;
+payload?: ApiResult<User>;
 ```
 
 The current body is read from `userBodyKey`. By default, the POST is sent when
@@ -31,13 +32,43 @@ Keep the decorator to access `send(component)`. The body is read again when the
 operation runs.
 
 ```typescript
-saveAgain() {
-  createUser.send(this);
+async saveAgain() {
+  const payload = await createUser.send(this);
+  console.log(payload?.result);
 }
 ```
 
-`send()` is useful for “Save” or “Retry” buttons. It can repeat an operation
-with side effects.
+`send()` returns a `Promise<ApiResult<T> | undefined>` that resolves after the
+operation completes. It is useful for “Save” or “Retry” buttons and can repeat
+an operation with side effects.
+
+### From a method decorator
+
+The send action can decorate a local method. It runs after the method by
+default, waits for an eventual Promise to resolve, and the decorated method
+call waits for the send to complete:
+
+```typescript
+import { send } from "@supersoniks/concorde/decorators";
+
+@send(createUser)
+async save() {
+  // Prepare local state or validate the form.
+}
+```
+
+Use `{ when: "before" }` when the send must complete before the method runs:
+
+```typescript
+@send(createUser, { when: "before" })
+saveBefore() {
+  // The POST has completed before this method runs.
+}
+```
+
+The method decorator adds an explicit send. If the method also mutates the body
+publisher, set `autoPostOnBodyMutation: false` when the decorated method must
+be the only trigger.
 
 ## Options (`PostOptions`)
 
@@ -52,6 +83,7 @@ is provided.
   repeating the operation is intended.
 - `skipEmptyPlaceholder`: block the request when a `${...}` placeholder is
   `""`.
+- `triggerKey`: a publisher whose `invalidate()` sends the POST again.
 
 With a configuration key:
 
@@ -68,6 +100,7 @@ dynamic path details.
 - after a body mutation, unless `autoPostOnBodyMutation: false`;
 - when a property used in `${...}` changes;
 - when a configuration publisher changes;
+- when the `triggerKey` publisher is invalidated;
 - when `send()` is called;
 - after each response when `refetchEveryMs` is set.