@supersoniks/concorde 4.9.9 → 4.9.91

package/docs/src/docs/search/docs-search.json

@@ -4744,6 +4744,51 @@
       }
     }
   },
+  {
+    "search": "The decorator returned by get(...) can be kept as a typed handle. Its refetch(component) action targets only the connected component instance and works even before the first ApiResult exists:\n",
+    "files": {
+      "docs/_decorators/get.md": {
+        "title": "@get",
+        "hashes": {
+          "local-refetch-handle": {
+            "count": 1,
+            "title": "Local refetch handle",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The inline form remains unchanged:\n",
+    "files": {
+      "docs/_decorators/get.md": {
+        "title": "@get",
+        "hashes": {
+          "local-refetch-handle": {
+            "count": 1,
+            "title": "Local refetch handle",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "For a refetch triggered from another component, keep using triggerKey and invalidate().\n",
+    "files": {
+      "docs/_decorators/get.md": {
+        "title": "@get",
+        "hashes": {
+          "local-refetch-handle": {
+            "count": 1,
+            "title": "Local refetch handle",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Pass as the second argument (scoped config) or third (with a configuration key). Same shape as send decorators where applicable:\n",
     "files": {
@@ -4759,6 +4804,51 @@
       }
     }
   },
+  {
+    "search": "Same pattern as @post: a publisher acts as a signal, independent of the response payload.\n",
+    "files": {
+      "docs/_decorators/get.md": {
+        "title": "@get",
+        "hashes": {
+          "manual-refetch-triggerkey": {
+            "count": 1,
+            "title": "Manual refetch (`triggerKey`)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Prefer triggerKey over mutating the API configuration publisher when you only want to reload the same URL — no need to touch serviceURL, tokens, etc.\n",
+    "files": {
+      "docs/_decorators/get.md": {
+        "title": "@get",
+        "hashes": {
+          "manual-refetch-triggerkey": {
+            "count": 1,
+            "title": "Manual refetch (`triggerKey`)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The docs mock adds an X-Fetched-At response header on /docs-mock-api/geo/communes so live demos can show when the last fetch happened (response.headers.get("X-Fetched-At")).\n",
+    "files": {
+      "docs/_decorators/get.md": {
+        "title": "@get",
+        "hashes": {
+          "manual-refetch-triggerkey": {
+            "count": 1,
+            "title": "Manual refetch (`triggerKey`)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Same demo service as sonic-queue (/docs-mock-api/geo/). Publisher setup lives in decorators-demo-geo.ts and decorators-demo-subscribe-publish-get-demos.ts.\n",
     "files": {
@@ -4775,7 +4865,22 @@
     }
   },
   {
-    "search": "Dynamic config and endpoint path (demo-api-get-configuration-key in doc sources):\n",
+    "search": "@get with triggerKey — refresh button + X-Fetched-At timestamp in the UI:\n",
+    "files": {
+      "docs/_decorators/get.md": {
+        "title": "@get",
+        "hashes": {
+          "live-demos": {
+            "count": 1,
+            "title": "Live demos",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Dynamic config and endpoint path. Manual refetch is triggered from a separate component (same triggerKey publisher):\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
@@ -5884,6 +5989,36 @@
       }
     }
   },
+  {
+    "search": "The decorator returned by post(...) can be kept as a typed handle. Its send(component) action re-runs the POST with the current body publisher:\n",
+    "files": {
+      "docs/_decorators/post.md": {
+        "title": "@post",
+        "hashes": {
+          "local-send-handle": {
+            "count": 1,
+            "title": "Local send handle",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "send() is an explicit write operation. It is intentionally distinct from GET invalidation because replaying a POST, PUT, or PATCH can have side effects.\n",
+    "files": {
+      "docs/_decorators/post.md": {
+        "title": "@post",
+        "hashes": {
+          "local-send-handle": {
+            "count": 1,
+            "title": "Local send handle",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Mock service: POST /docs-mock-api/api/register (same route as sonic-submit demos). Publisher setup lives in decorators-demo-post.ts.\n",
     "files": {
@@ -6874,6 +7009,21 @@
       }
     }
   },
+  {
+    "search": "Everything after <!-- concorde-ai --> is replaced on each ai-init run (idempotent). Do not paste a full copy of the Concorde guide above the marker — put project-specific notes in AGENTS.concorde.md (overlay). If the preamble duplicates package AGENTS.md, ai-init slims or drops it and prints a warning. Legacy filenames AGENTS.overlay.md / AGENTS.starter.md are still accepted with a deprecation warning.\n",
+    "files": {
+      "docs/_getting-started/ai-agents.md": {
+        "title": "AI agents (skills & AGENTS.md)",
+        "hashes": {
+          "agentsmd-policy-non-invasive": {
+            "count": 1,
+            "title": "`AGENTS.md` policy (non-invasive)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Source files in the npm package: node_modules/@supersoniks/concorde/ai/ (see also ai/README.md in the Concorde repository).\n",
     "files": {

package/docs/src/tsconfig.json

@@ -789,6 +789,9 @@
       "./utils/PublisherProxy": [
         "/sites/concorde/src/core/utils/PublisherProxy.ts"
       ],
+      "./utils/SafariScrollGuard": [
+        "/sites/concorde/src/core/utils/SafariScrollGuard.ts"
+      ],
       "./utils/Utils": [
         "/sites/concorde/src/core/utils/Utils.ts"
       ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersoniks/concorde",
-  "version": "4.9.9",
+  "version": "4.9.91",
   "license": "MIT",
   "type": "module",
   "main": "",

package/src/core/decorators/api.post.spec.ts

@@ -5,7 +5,7 @@ import API, {
   type ApiResult,
 } from "@supersoniks/concorde/core/utils/api";
 import { PublisherManager } from "@supersoniks/concorde/core/utils/PublisherProxy";
-import { patch, post, put } from "./api";
+import { patch, post, put, send } from "./api";
 
 async function flushSendFrames() {
   await new Promise<void>((resolve) => {
@@ -68,6 +68,84 @@ describe("post", () => {
     expect(el.payload?.result).toEqual({ ok: true });
   });
 
+  it("expose un send local avec le body courant", async () => {
+    const bodyPubId = "postSpecLocalSend";
+    const pub = PublisherManager.get(bodyPubId);
+    pub.set({ value: "first" });
+    const bodyKey = new DataProviderKey<{ value: string }>(bodyPubId);
+    const syncEp = new Endpoint<{ ok: boolean }>("items/local-send");
+    const localPost = post(syncEp, bodyKey);
+    const tag = "test-api-post-local-send";
+
+    class C extends HTMLElement {
+      @localPost
+      payload: ApiResult<{ ok: boolean }> | null = null;
+    }
+    if (!customElements.get(tag)) {
+      customElements.define(tag, C);
+    }
+
+    const wrap = document.createElement("div");
+    wrap.setAttribute("serviceURL", "https://api.example.test");
+    const el = document.createElement(tag) as InstanceType<typeof C>;
+    wrap.appendChild(el);
+    document.body.appendChild(wrap);
+
+    await flushSendFrames();
+    vi.mocked(API.prototype.postDetailed).mockClear();
+
+    pub.set({ value: "second" });
+    localPost.send(el);
+    await flushSendFrames();
+
+    expect(API.prototype.postDetailed).toHaveBeenCalledTimes(1);
+    expect(API.prototype.postDetailed).toHaveBeenCalledWith(
+      "items/local-send",
+      { value: "second" },
+    );
+  });
+
+  it("peut décorer une méthode avec send après sa résolution", async () => {
+    const bodyPubId = "postSpecMethodSend";
+    const pub = PublisherManager.get(bodyPubId);
+    pub.set({ value: "first" });
+    const bodyKey = new DataProviderKey<{ value: string }>(bodyPubId);
+    const syncEp = new Endpoint<{ ok: boolean }>("items/method-send");
+    const localPost = post(syncEp, bodyKey);
+    const tag = "test-api-post-method-send";
+
+    class C extends HTMLElement {
+      @localPost
+      payload: ApiResult<{ ok: boolean }> | null = null;
+
+      @send(localPost)
+      async save() {
+        await Promise.resolve();
+        pub.set({ value: "after" });
+      }
+    }
+    if (!customElements.get(tag)) {
+      customElements.define(tag, C);
+    }
+
+    const wrap = document.createElement("div");
+    wrap.setAttribute("serviceURL", "https://api.example.test");
+    const el = document.createElement(tag) as InstanceType<typeof C>;
+    wrap.appendChild(el);
+    document.body.appendChild(wrap);
+
+    await flushSendFrames();
+    vi.mocked(API.prototype.postDetailed).mockClear();
+
+    await el.save();
+    await flushSendFrames();
+
+    expect(API.prototype.postDetailed).toHaveBeenCalledWith(
+      "items/method-send",
+      { value: "after" },
+    );
+  });
+
   it("endpoint dynamique et relance quand le body publisher mute", async () => {
     const bodyPubId = "postSpecBody2";
     const pub = PublisherManager.get(bodyPubId);

package/src/core/decorators/api.spec.ts

@@ -6,7 +6,7 @@ import API, {
   type ApiResult,
 } from "@supersoniks/concorde/core/utils/api";
 import { PublisherManager } from "@supersoniks/concorde/core/utils/PublisherProxy";
-import { get } from "./api";
+import { get, refetch } from "./api";
 
 const staticConfig: APIConfiguration = {
   serviceURL: "https://api.example.test",
@@ -190,6 +190,105 @@ describe("get", () => {
     expect(el.payload?.result).toEqual({ id: "loaded" });
   });
 
+  it("expose un refetch local avant et après le premier payload", async () => {
+    const pubId = "getSpecLocalRefetch";
+    PublisherManager.get(pubId).set(staticConfig);
+    const confKey = new DataProviderKey<APIConfiguration>(pubId);
+    const itemEp = new Endpoint<{ id: string }>("items/local");
+    const localGet = get(itemEp, confKey);
+    const tag = "test-api-get-local-refetch";
+
+    class C extends HTMLElement {
+      @localGet
+      payload: ApiResult<{ id: string }> | null = null;
+    }
+    if (!customElements.get(tag)) {
+      customElements.define(tag, C);
+    }
+
+    const el = document.createElement(tag) as InstanceType<typeof C>;
+    document.body.appendChild(el);
+
+    localGet.refetch(el);
+    await flushGetFrames();
+    expect(API.prototype.getDetailed).toHaveBeenCalledTimes(1);
+
+    vi.mocked(API.prototype.getDetailed).mockClear();
+    el.payload = mockPayload({ id: "manual" });
+    localGet.refetch(el);
+    await flushGetFrames();
+
+    expect(API.prototype.getDetailed).toHaveBeenCalledTimes(1);
+    expect(el.payload?.result).toEqual({ id: "loaded" });
+  });
+
+  it("ne refait plus de GET avec un handle local après déconnexion", async () => {
+    const pubId = "getSpecLocalRefetchDisconnect";
+    PublisherManager.get(pubId).set(staticConfig);
+    const confKey = new DataProviderKey<APIConfiguration>(pubId);
+    const localGet = get(
+      new Endpoint<{ id: string }>("items/local-disconnect"),
+      confKey,
+    );
+    const tag = "test-api-get-local-refetch-disconnect";
+
+    class C extends HTMLElement {
+      @localGet
+      payload: ApiResult<{ id: string }> | null = null;
+    }
+    if (!customElements.get(tag)) {
+      customElements.define(tag, C);
+    }
+
+    const el = document.createElement(tag) as InstanceType<typeof C>;
+    document.body.appendChild(el);
+    await flushGetFrames();
+    vi.mocked(API.prototype.getDetailed).mockClear();
+
+    el.remove();
+    localGet.refetch(el);
+    await flushGetFrames();
+
+    expect(API.prototype.getDetailed).not.toHaveBeenCalled();
+  });
+
+  it("peut décorer une méthode et refetcher après sa résolution", async () => {
+    const pubId = "getSpecMethodRefetch";
+    PublisherManager.get(pubId).set(staticConfig);
+    const confKey = new DataProviderKey<APIConfiguration>(pubId);
+    const rowEp = new Endpoint<{ id: string }, { rowId: string }>(
+      "rows/${rowId}",
+    );
+    const localGet = get(rowEp, confKey);
+    const tag = "test-api-get-method-refetch";
+
+    class C extends HTMLElement {
+      rowId = "42";
+
+      @localGet
+      payload: ApiResult<{ id: string }> | null = null;
+
+      @refetch(localGet)
+      async reload() {
+        await Promise.resolve();
+        this.rowId = "84";
+      }
+    }
+    if (!customElements.get(tag)) {
+      customElements.define(tag, C);
+    }
+
+    const el = document.createElement(tag) as InstanceType<typeof C>;
+    document.body.appendChild(el);
+    await flushGetFrames();
+    vi.mocked(API.prototype.getDetailed).mockClear();
+
+    await el.reload();
+    await flushGetFrames();
+
+    expect(API.prototype.getDetailed).toHaveBeenCalledWith("rows/84");
+  });
+
   it("refetch automatique avec refetchEveryMs", async () => {
     vi.useFakeTimers();
     const itemEp = new Endpoint<{ id: string }>("items/1");