@supersoniks/concorde 4.9.91 → 4.9.92

package/docs/crawl/docs/_decorators/get.html

@@ -4,13 +4,13 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>@get — Concorde</title>
-  <meta name="description" content="@get loads data and stores the result in an ApiResult&lt;T&gt; | null property.">
-  <meta name="keywords" content="Concorde, supersoniks, docs/_decorators/get, get, @get, decorator, ApiResult | null, payload.result, payload.response, payload.request, 
+  <meta name="description" content="@get loads data and stores the result in an optional ApiResult&lt;T&gt; property.">
+  <meta name="keywords" content="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">
+">
   <meta name="concorde-doc-id" content="docs/_decorators/get">
   <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_decorators/get.html">
 </head>
@@ -20,14 +20,15 @@ The first argument is always an
   </header>
   <main>
     <article>
-      <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @get</strong>. @get loads data and stores the result in an ApiResult&lt;T&gt; | null property. <span>Doc ID: <code>docs/_decorators/get</code>. Keywords: Concorde, supersoniks, docs/_decorators/get, get, @get, decorator, ApiResult | null, payload.result, payload.response, payload.request, 
+      <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @get</strong>. @get loads data and stores the result in an optional ApiResult&lt;T&gt; property. <span>Doc ID: <code>docs/_decorators/get</code>. 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. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/get.html">https://concorde.supersoniks.org/crawl/docs/_decorators/get.html</a>.</span></p>
+. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/get.html">https://concorde.supersoniks.org/crawl/docs/_decorators/get.html</a>.</span></p>
       <h1 id="get">@get</h1>
-<p><code>@get</code> loads data and stores the result in an <code>ApiResult&lt;T&gt; | null</code> property.</p>
+<p><code>@get</code> loads data and stores the result in an optional <code>ApiResult&lt;T&gt;</code> property.
+The property is <code>undefined</code> until a result is available.</p>
 <ul>
 <li><code>payload.result</code>: typed data;</li>
 <li><code>payload.response</code>: the HTTP response;</li>
@@ -38,7 +39,7 @@ The first argument is always an
 
 @get(usersEndpoint)
 @state()
-payload: ApiResult&lt;User[]&gt; | null = null;
+payload?: ApiResult&lt;User[]&gt;;
 </code></pre>
 <p>The first argument is always an
 <a href="../_misc/endpoint.html#endpoint"><code>Endpoint&lt;T&gt;</code></a>. API configuration is read
@@ -53,12 +54,34 @@ result.</p>
 
 @usersGet
 @state()
-payload: ApiResult&lt;User[]&gt; | null = null;
+payload?: ApiResult&lt;User[]&gt;;
 
-refresh() {
-  usersGet.refetch(this);
+async refresh() {
+  const payload = await usersGet.refetch(this);
+  console.log(payload?.result);
 }
 </code></pre>
+<p><code>refetch(component)</code> returns a <code>Promise&lt;ApiResult&lt;T&gt; | undefined&gt;</code> that resolves
+after the GET has completed.</p>
+<h3 id="from-a-method-decorator">From a method decorator</h3>
+<p>The refetch can decorate a local method. The default is <code>after</code>; if the
+method returns a Promise, the GET waits for its resolution. The decorated method
+call also waits for the refetch to complete.</p>
+<pre><code class="language-typescript">import { refetch } from &quot;@supersoniks/concorde/decorators&quot;;
+
+@refetch(usersGet)
+async reload() {
+  this.userId = &quot;42&quot;;
+}
+</code></pre>
+<p>Use <code>{ when: &quot;before&quot; }</code> when the GET must complete before the method runs:</p>
+<pre><code class="language-typescript">@refetch(usersGet, { when: &quot;before&quot; })
+reloadBefore() {
+  // The refetch has completed before this method runs.
+}
+</code></pre>
+<p>The method decorator adds an explicit trigger; changes to dynamic endpoint
+properties and configuration publishers keep their existing automatic behavior.</p>
 <h2 id="options-getoptions">Options (<code>GetOptions</code>)</h2>
 <p>Options are the second argument, or the third argument when an API
 configuration key is provided.</p>
@@ -66,6 +89,7 @@ configuration key is provided.</p>
 <li><code>skipEmptyPlaceholder</code>: blocks the GET when <code>${prop}</code> is <code>&quot;&quot;</code>.</li>
 <li><code>refetchEveryMs</code>: automatically runs the GET again after this interval
 (milliseconds). Omit the option, or use <code>0</code>, to disable polling.</li>
+<li><code>triggerKey</code>: a publisher whose <code>invalidate()</code> runs the GET again.</li>
 </ul>
 <p>With a configuration key, use:</p>
 <pre><code class="language-typescript">@get(usersEndpoint, apiConfigurationKey)
@@ -75,6 +99,7 @@ configuration key is provided.</p>
 <li>when the component connects and configuration is available;</li>
 <li>when a property used in <code>${...}</code> changes;</li>
 <li>when a configuration publisher changes;</li>
+<li>when the <code>triggerKey</code> publisher is invalidated;</li>
 <li>after each response when <code>refetchEveryMs</code> is set.</li>
 </ul>
 <p>See <a href="../_misc/dynamic-path.html#dynamic-path">Dynamic path placeholders</a> for

package/docs/crawl/docs/_decorators/patch.html

@@ -5,7 +5,9 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>@patch — Concorde</title>
   <meta name="description" content="@patch applies a partial update with the body from a publisher. It uses the">
-  <meta name="keywords" content="Concorde, supersoniks, docs/_decorators/patch, patch, @patch, decorator, Endpoint, DataProviderKey, ApiResult, send(component), autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing, refetchEveryMs, skipEmptyPlaceholder">
+  <meta name="keywords" content="Concorde, supersoniks, docs/_decorators/patch, patch, @patch, decorator, Endpoint, DataProviderKey, ApiResult, send(component), 
+
+, when: &quot;before&quot;, autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing">
   <meta name="concorde-doc-id" content="docs/_decorators/patch">
   <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html">
 </head>
@@ -15,7 +17,9 @@
   </header>
   <main>
     <article>
-      <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @patch</strong>. @patch applies a partial update with the body from a publisher. It uses the <span>Doc ID: <code>docs/_decorators/patch</code>. Keywords: Concorde, supersoniks, docs/_decorators/patch, patch, @patch, decorator, Endpoint, DataProviderKey, ApiResult, send(component), autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing, refetchEveryMs, skipEmptyPlaceholder. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html">https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html</a>.</span></p>
+      <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @patch</strong>. @patch applies a partial update with the body from a publisher. It uses the <span>Doc ID: <code>docs/_decorators/patch</code>. Keywords: Concorde, supersoniks, docs/_decorators/patch, patch, @patch, decorator, Endpoint, DataProviderKey, ApiResult, send(component), 
+
+, when: &quot;before&quot;, autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html">https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html</a>.</span></p>
       <h1 id="patch">@patch</h1>
 <p><code>@patch</code> applies a partial update with the body from a publisher. It uses the
 same model as <a href="./post.html#post">@post</a>:
@@ -27,13 +31,16 @@ const patchUser = patch(new Endpoint&lt;User&gt;(&quot;users/42&quot;), bodyKey)
 
 @patchUser
 @state()
-payload: ApiResult&lt;User&gt; | null = null;
+payload?: ApiResult&lt;User&gt;;
 </code></pre>
 <p>To run the operation again from the component:</p>
-<pre><code class="language-typescript">savePatch() {
-  patchUser.send(this);
+<pre><code class="language-typescript">async savePatch() {
+  await patchUser.send(this);
 }
 </code></pre>
+<p><code>send(component)</code> returns a Promise resolved after the PATCH completes. See
+<a href="./post.html#post">@post</a> for the method-decorator form and the
+<code>when: &quot;before&quot;</code> option.</p>
 <p>The PATCH is also sent automatically when the body mutates, unless
 <code>autoPostOnBodyMutation: false</code> is set. The available options are described in
 <a href="./post.html#post">@post</a>:</p>
@@ -42,6 +49,7 @@ payload: ApiResult&lt;User&gt; | null = null;
 <li><code>skipIfBodyMissing</code></li>
 <li><code>refetchEveryMs</code></li>
 <li><code>skipEmptyPlaceholder</code></li>
+<li><code>triggerKey</code></li>
 </ul>
 <p>Pass explicit API configuration as the third argument:</p>
 <pre><code class="language-typescript">@patch(endpoint, bodyKey, apiConfigurationKey)

package/docs/crawl/docs/_decorators/post.html

@@ -5,11 +5,13 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>@post — Concorde</title>
   <meta name="description" content="@post sends the contents of a publisher and stores the response in an">
-  <meta name="keywords" content="Concorde, supersoniks, docs/_decorators/post, post, @post, decorator, ApiResult | null, Endpoint, DataProviderKey, 
+  <meta name="keywords" content="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 ">
   <meta name="concorde-doc-id" content="docs/_decorators/post">
   <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_decorators/post.html">
 </head>
@@ -19,14 +21,17 @@ The current body is read from , send(component),
   </header>
   <main>
     <article>
-      <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @post</strong>. @post sends the contents of a publisher and stores the response in an <span>Doc ID: <code>docs/_decorators/post</code>. Keywords: Concorde, supersoniks, docs/_decorators/post, post, @post, decorator, ApiResult | null, Endpoint, DataProviderKey, 
+      <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @post</strong>. @post sends the contents of a publisher and stores the response in an <span>Doc ID: <code>docs/_decorators/post</code>. Keywords: Concorde, supersoniks, docs/_decorators/post, post, @post, decorator, ApiResult, undefined, Endpoint, DataProviderKey, 
 
 The current body is read from , send(component), 
 
-, PostOptions, autoPostOnBodyMutation, true. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/post.html">https://concorde.supersoniks.org/crawl/docs/_decorators/post.html</a>.</span></p>
+,  returns a , 
+
+Use . URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/post.html">https://concorde.supersoniks.org/crawl/docs/_decorators/post.html</a>.</span></p>
       <h1 id="post">@post</h1>
 <p><code>@post</code> sends the contents of a publisher and stores the response in an
-<code>ApiResult&lt;T&gt; | null</code> property.</p>
+optional <code>ApiResult&lt;T&gt;</code> property. The property is <code>undefined</code> until a result
+is available.</p>
 <h2 id="minimal-usage">Minimal usage</h2>
 <p>Pass an <code>Endpoint&lt;T&gt;</code> and a <code>DataProviderKey&lt;B&gt;</code> for the request body.</p>
 <pre><code class="language-typescript">const userBodyKey = new DataProviderKey&lt;CreateUser&gt;(&quot;users.form&quot;);
@@ -34,7 +39,7 @@ const createUser = post(new Endpoint&lt;User&gt;(&quot;users&quot;), userBodyKey
 
 @createUser
 @state()
-payload: ApiResult&lt;User&gt; | null = null;
+payload?: ApiResult&lt;User&gt;;
 </code></pre>
 <p>The current body is read from <code>userBodyKey</code>. By default, the POST is sent when
 the component connects and after each body mutation. Mutations in the same
@@ -45,12 +50,34 @@ frame are coalesced into one request.</p>
 <h3 id="from-the-component">From the component</h3>
 <p>Keep the decorator to access <code>send(component)</code>. The body is read again when the
 operation runs.</p>
-<pre><code class="language-typescript">saveAgain() {
-  createUser.send(this);
+<pre><code class="language-typescript">async saveAgain() {
+  const payload = await createUser.send(this);
+  console.log(payload?.result);
+}
+</code></pre>
+<p><code>send()</code> returns a <code>Promise&lt;ApiResult&lt;T&gt; | undefined&gt;</code> that resolves after the
+operation completes. It is useful for “Save” or “Retry” buttons and can repeat
+an operation with side effects.</p>
+<h3 id="from-a-method-decorator">From a method decorator</h3>
+<p>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:</p>
+<pre><code class="language-typescript">import { send } from &quot;@supersoniks/concorde/decorators&quot;;
+
+@send(createUser)
+async save() {
+  // Prepare local state or validate the form.
+}
+</code></pre>
+<p>Use <code>{ when: &quot;before&quot; }</code> when the send must complete before the method runs:</p>
+<pre><code class="language-typescript">@send(createUser, { when: &quot;before&quot; })
+saveBefore() {
+  // The POST has completed before this method runs.
 }
 </code></pre>
-<p><code>send()</code> is useful for “Save” or “Retry” buttons. It can repeat an operation
-with side effects.</p>
+<p>The method decorator adds an explicit send. If the method also mutates the body
+publisher, set <code>autoPostOnBodyMutation: false</code> when the decorated method must
+be the only trigger.</p>
 <h2 id="options-postoptions">Options (<code>PostOptions</code>)</h2>
 <p>Options are the third argument, or the fourth argument when a configuration key
 is provided.</p>
@@ -63,6 +90,7 @@ it to <code>false</code> to use <code>send()</code>.</li>
 repeating the operation is intended.</li>
 <li><code>skipEmptyPlaceholder</code>: block the request when a <code>${...}</code> placeholder is
 <code>&quot;&quot;</code>.</li>
+<li><code>triggerKey</code>: a publisher whose <code>invalidate()</code> sends the POST again.</li>
 </ul>
 <p>With a configuration key:</p>
 <pre><code class="language-typescript">@post(endpoint, userBodyKey, apiConfigurationKey)
@@ -75,6 +103,7 @@ dynamic path details.</p>
 <li>after a body mutation, unless <code>autoPostOnBodyMutation: false</code>;</li>
 <li>when a property used in <code>${...}</code> changes;</li>
 <li>when a configuration publisher changes;</li>
+<li>when the <code>triggerKey</code> publisher is invalidated;</li>
 <li>when <code>send()</code> is called;</li>
 <li>after each response when <code>refetchEveryMs</code> is set.</li>
 </ul>

package/docs/crawl/docs/_decorators/put.html

@@ -5,7 +5,9 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>@put — Concorde</title>
   <meta name="description" content="@put replaces a resource with the body from a publisher. It uses exactly the">
-  <meta name="keywords" content="Concorde, supersoniks, docs/_decorators/put, put, @put, decorator, Endpoint, DataProviderKey, ApiResult, send(component), autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing, refetchEveryMs, skipEmptyPlaceholder">
+  <meta name="keywords" content="Concorde, supersoniks, docs/_decorators/put, put, @put, decorator, Endpoint, DataProviderKey, ApiResult, send(component), 
+
+, when: &quot;before&quot;, autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing">
   <meta name="concorde-doc-id" content="docs/_decorators/put">
   <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_decorators/put.html">
 </head>
@@ -15,7 +17,9 @@
   </header>
   <main>
     <article>
-      <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @put</strong>. @put replaces a resource with the body from a publisher. It uses exactly the <span>Doc ID: <code>docs/_decorators/put</code>. Keywords: Concorde, supersoniks, docs/_decorators/put, put, @put, decorator, Endpoint, DataProviderKey, ApiResult, send(component), autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing, refetchEveryMs, skipEmptyPlaceholder. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/put.html">https://concorde.supersoniks.org/crawl/docs/_decorators/put.html</a>.</span></p>
+      <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @put</strong>. @put replaces a resource with the body from a publisher. It uses exactly the <span>Doc ID: <code>docs/_decorators/put</code>. Keywords: Concorde, supersoniks, docs/_decorators/put, put, @put, decorator, Endpoint, DataProviderKey, ApiResult, send(component), 
+
+, when: &quot;before&quot;, autoPostOnBodyMutation: false, autoPostOnBodyMutation, skipIfBodyMissing. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/put.html">https://concorde.supersoniks.org/crawl/docs/_decorators/put.html</a>.</span></p>
       <h1 id="put">@put</h1>
 <p><code>@put</code> replaces a resource with the body from a publisher. It uses exactly the
 same model as <a href="./post.html#post">@post</a>:
@@ -27,13 +31,16 @@ const updateUser = put(new Endpoint&lt;User&gt;(&quot;users/42&quot;), bodyKey);
 
 @updateUser
 @state()
-payload: ApiResult&lt;User&gt; | null = null;
+payload?: ApiResult&lt;User&gt;;
 </code></pre>
 <p>To run the operation again from the component:</p>
-<pre><code class="language-typescript">update() {
-  updateUser.send(this);
+<pre><code class="language-typescript">async update() {
+  await updateUser.send(this);
 }
 </code></pre>
+<p><code>send(component)</code> returns a Promise resolved after the PUT completes. See
+<a href="./post.html#post">@post</a> for the method-decorator form and the
+<code>when: &quot;before&quot;</code> option.</p>
 <p>The PUT is also sent automatically when the body mutates, unless
 <code>autoPostOnBodyMutation: false</code> is set. See
 <a href="./post.html#post">@post</a> for the option details:</p>
@@ -42,6 +49,7 @@ payload: ApiResult&lt;User&gt; | null = null;
 <li><code>skipIfBodyMissing</code></li>
 <li><code>refetchEveryMs</code></li>
 <li><code>skipEmptyPlaceholder</code></li>
+<li><code>triggerKey</code></li>
 </ul>
 <p>Pass explicit API configuration as the third argument:</p>
 <pre><code class="language-typescript">@put(endpoint, bodyKey, apiConfigurationKey)

package/docs/crawl/hubs/decorators.html

@@ -149,10 +149,11 @@ export class DemoBind extends LitElement {
 <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;
@@ -164,7 +165,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
@@ -183,22 +184,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-handle" data-doc-id="docs/_decorators/handle">
   <h2><a href="../docs/_decorators/handle.html">@handle</a></h2>
@@ -293,14 +292,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:
@@ -309,6 +312,7 @@ autoPostOnBodyMutation: false is set. The available options are described in
 - skipIfBodyMissing
 - refetchEveryMs
 - skipEmptyPlaceholder
+- triggerKey
 
 Pass explicit API configuration as the third argument:
 
@@ -322,9 +326,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>
@@ -333,7 +335,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
 
@@ -344,7 +347,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
@@ -360,23 +363,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-publish" data-doc-id="docs/_decorators/publish">
   <h2><a href="../docs/_decorators/publish.html">@publish</a></h2>
@@ -439,14 +438,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:
@@ -455,6 +458,7 @@ autoPostOnBodyMutation: false is set. See
 - skipIfBodyMissing
 - refetchEveryMs
 - skipEmptyPlaceholder
+- triggerKey
 
 Pass explicit API configuration as the third argument:
 
@@ -469,8 +473,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-_decorators-subscribe" data-doc-id="docs/_decorators/subscribe">
   <h2><a href="../docs/_decorators/subscribe.html">@subscribe</a></h2>