@supersoniks/concorde 4.2.1 → 4.4.0

package/docs/src/tsconfig.json

@@ -15,8 +15,8 @@
     "module": "esnext",
     "moduleResolution": "bundler",
     "paths": {
-      "./_types/key.spec": [
-        "/usr2/sites/concorde/src/core/_types/key.spec.ts"
+      "./_types/endpoint": [
+        "/usr2/sites/concorde/src/core/_types/endpoint.ts"
       ],
       "./_types/key": [
         "/usr2/sites/concorde/src/core/_types/key.ts"
@@ -774,6 +774,12 @@
       "./decorators/Subscriber": [
         "/usr2/sites/concorde/src/core/decorators/Subscriber.ts"
       ],
+      "./decorators/api.spec": [
+        "/usr2/sites/concorde/src/core/decorators/api.spec.ts"
+      ],
+      "./decorators/api": [
+        "/usr2/sites/concorde/src/core/decorators/api.ts"
+      ],
       "./decorators/lifecycle": [
         "/usr2/sites/concorde/src/core/decorators/lifecycle.ts"
       ],
@@ -792,6 +798,12 @@
       "./decorators/subscriber/common": [
         "/usr2/sites/concorde/src/core/decorators/subscriber/common.ts"
       ],
+      "./decorators/subscriber/dynamicPath": [
+        "/usr2/sites/concorde/src/core/decorators/subscriber/dynamicPath.ts"
+      ],
+      "./decorators/subscriber/dynamicPropertyWatch": [
+        "/usr2/sites/concorde/src/core/decorators/subscriber/dynamicPropertyWatch.ts"
+      ],
       "./decorators/subscriber/onAssign": [
         "/usr2/sites/concorde/src/core/decorators/subscriber/onAssign.ts"
       ],
@@ -801,6 +813,9 @@
       "./decorators/subscriber/publish": [
         "/usr2/sites/concorde/src/core/decorators/subscriber/publish.ts"
       ],
+      "./decorators/subscriber/publisherPath": [
+        "/usr2/sites/concorde/src/core/decorators/subscriber/publisherPath.ts"
+      ],
       "./decorators/subscriber/subscribe.spec": [
         "/usr2/sites/concorde/src/core/decorators/subscriber/subscribe.spec.ts"
       ],
@@ -870,6 +885,18 @@
       "./utils/api": [
         "/usr2/sites/concorde/src/core/utils/api.ts"
       ],
+      "./utils/dataProviderKey.spec": [
+        "/usr2/sites/concorde/src/core/utils/dataProviderKey.spec.ts"
+      ],
+      "./utils/dataProviderKey": [
+        "/usr2/sites/concorde/src/core/utils/dataProviderKey.ts"
+      ],
+      "./utils/endpoint.spec": [
+        "/usr2/sites/concorde/src/core/utils/endpoint.spec.ts"
+      ],
+      "./utils/endpoint": [
+        "/usr2/sites/concorde/src/core/utils/endpoint.ts"
+      ],
       "./utils/route.spec": [
         "/usr2/sites/concorde/src/core/utils/route.spec.ts"
       ],
@@ -885,6 +912,18 @@
       "./docs": [
         "/usr2/sites/concorde/src/docs/docs.ts"
       ],
+      "./example/decorators-demo-bind-demos": [
+        "/usr2/sites/concorde/src/docs/example/decorators-demo-bind-demos.ts"
+      ],
+      "./example/decorators-demo-geo": [
+        "/usr2/sites/concorde/src/docs/example/decorators-demo-geo.ts"
+      ],
+      "./example/decorators-demo-init": [
+        "/usr2/sites/concorde/src/docs/example/decorators-demo-init.ts"
+      ],
+      "./example/decorators-demo-subscribe-publish-get-demos": [
+        "/usr2/sites/concorde/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts"
+      ],
       "./example/decorators-demo": [
         "/usr2/sites/concorde/src/docs/example/decorators-demo.ts"
       ],
@@ -924,8 +963,8 @@
       "./TestUtils": [
         "/usr2/sites/concorde/src/test-utils/TestUtils.ts"
       ],
-      "@supersoniks/concorde/key": [
-        "/usr2/sites/concorde/src/core/_types/key.ts"
+      "@supersoniks/concorde/dataProviderKey": [
+        "/usr2/sites/concorde/src/core/utils/dataProviderKey.ts"
       ],
       "@supersoniks/concorde/*": [
         "./*"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersoniks/concorde",
-  "version": "4.2.1",
+  "version": "4.4.0",
   "license": "MIT",
   "type": "module",
   "main": "",
@@ -17,9 +17,12 @@
   "exports": {
     "./core/components/ui/icon/icons.json": "./src/core/components/ui/icon/icons.json",
     "./core/components/functional/sdui/default-library.json": "./src/core/components/functional/sdui/default-library.json",
+    "./dataProviderKey": "./src/core/utils/dataProviderKey.ts",
     "./*": "./src/*.ts",
     "./vite-config": "./vite/config.js",
     "./rollup-plugin-*": "./rollup/plugin-*.js",
+    "./_types/endpoint": "./src/core/_types/endpoint.ts",
+    "./_types/key": "./src/core/_types/key.ts",
     "./_types/types": "./src/core/_types/types.ts",
     "./date": "./src/core/components/functional/date/date.ts",
     "./functional/date": "./src/core/components/functional/date/date.ts",
@@ -271,13 +274,23 @@
     "./ui/ui": "./src/core/components/ui/ui.ts",
     "./core": "./src/core/core.ts",
     "./decorators/Subscriber": "./src/core/decorators/Subscriber.ts",
+    "./decorators/api.spec": "./src/core/decorators/api.spec.ts",
+    "./decorators/api": "./src/core/decorators/api.ts",
     "./decorators/lifecycle": "./src/core/decorators/lifecycle.ts",
     "./decorators/subscriber/ancestorAttribute": "./src/core/decorators/subscriber/ancestorAttribute.ts",
     "./decorators/subscriber/autoFill": "./src/core/decorators/subscriber/autoFill.ts",
     "./decorators/subscriber/autoSubscribe": "./src/core/decorators/subscriber/autoSubscribe.ts",
     "./decorators/subscriber/bind": "./src/core/decorators/subscriber/bind.ts",
     "./decorators/subscriber/common": "./src/core/decorators/subscriber/common.ts",
+    "./decorators/subscriber/dynamicPath": "./src/core/decorators/subscriber/dynamicPath.ts",
+    "./decorators/subscriber/dynamicPropertyWatch": "./src/core/decorators/subscriber/dynamicPropertyWatch.ts",
     "./decorators/subscriber/onAssign": "./src/core/decorators/subscriber/onAssign.ts",
+    "./decorators/subscriber/publish.spec": "./src/core/decorators/subscriber/publish.spec.ts",
+    "./decorators/subscriber/publish": "./src/core/decorators/subscriber/publish.ts",
+    "./decorators/subscriber/publisherPath": "./src/core/decorators/subscriber/publisherPath.ts",
+    "./decorators/subscriber/subscribe.spec": "./src/core/decorators/subscriber/subscribe.spec.ts",
+    "./decorators/subscriber/subscribe": "./src/core/decorators/subscriber/subscribe.ts",
+    "./decorators/subscriber/subscribe.type-test": "./src/core/decorators/subscriber/subscribe.type-test.ts",
     "./directives/DataProvider": "./src/core/directives/DataProvider.ts",
     "./directives/Wording": "./src/core/directives/Wording.ts",
     "./mixins/Fetcher": "./src/core/mixins/Fetcher.ts",
@@ -298,11 +311,19 @@
     "./utils/Utils": "./src/core/utils/Utils.ts",
     "./utils/aesCrypto": "./src/core/utils/aesCrypto.ts",
     "./utils/api": "./src/core/utils/api.ts",
+    "./utils/dataProviderKey.spec": "./src/core/utils/dataProviderKey.spec.ts",
+    "./utils/dataProviderKey": "./src/core/utils/dataProviderKey.ts",
+    "./utils/endpoint.spec": "./src/core/utils/endpoint.spec.ts",
+    "./utils/endpoint": "./src/core/utils/endpoint.ts",
     "./utils/route.spec": "./src/core/utils/route.spec.ts",
     "./utils/route": "./src/core/utils/route.ts",
     "./utils/url-pattern": "./src/core/utils/url-pattern.ts",
     "./code": "./src/docs/code.ts",
     "./docs": "./src/docs/docs.ts",
+    "./example/decorators-demo-bind-demos": "./src/docs/example/decorators-demo-bind-demos.ts",
+    "./example/decorators-demo-geo": "./src/docs/example/decorators-demo-geo.ts",
+    "./example/decorators-demo-init": "./src/docs/example/decorators-demo-init.ts",
+    "./example/decorators-demo-subscribe-publish-get-demos": "./src/docs/example/decorators-demo-subscribe-publish-get-demos.ts",
     "./example/decorators-demo": "./src/docs/example/decorators-demo.ts",
     "./example/users": "./src/docs/example/users.ts",
     "./header/header": "./src/docs/header/header.ts",
@@ -320,7 +341,7 @@
   "devDependencies": {
     "@tailwindcss/typography": "^0.5.12",
     "@types/node": "^24.5.2",
-    "@vitejs/plugin-basic-ssl": "^2.1.0",
+    "@vitejs/plugin-basic-ssl": "^2.3.0",
     "altcha": "^1.0.7",
     "autoprefixer": "^10.4.19",
     "baseline-browser-mapping": "^2.8.31",
@@ -333,8 +354,8 @@
     "rollup-plugin-postcss-lit": "^2.1.0",
     "tailwindcss": "^3.4.3",
     "typescript": "^5.4.3",
-    "vite": "^7.1.5",
-    "vitest": "^3.2.4"
+    "vite": "^8.0.0",
+    "vitest": "^4.0.0"
   },
   "dependencies": {
     "@lit-labs/motion": "^1.0.7",

package/php/get-challenge.php

@@ -0,0 +1,34 @@
+<?php
+/* *
+ * Call get-challenge on auto-hosted latcha service at  https://altcha.supersoniks.org
+ * */
+
+// Autoriser toutes les origines
+header("Access-Control-Allow-Origin: *");
+
+// Autoriser les méthodes HTTP spécifiques
+header("Access-Control-Allow-Methods: GET, POST, OPTIONS");
+
+// Autoriser certains en-têtes spécifiques
+header("Access-Control-Allow-Headers: Content-Type, Authorization");
+
+// Si la méthode est OPTIONS, terminer la requête ici
+if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
+    http_response_code(200);
+    exit();
+}
+
+function getChallenge($key){
+    $maxNumber=20000;
+    $queryString = $params = [
+        'key' => $key,
+        'maxNumber' => $maxNumber
+    ];
+    // Générer la chaîne de requête
+    $queryString = http_build_query($params);
+    $url = "https://altcha.supersoniks.org/get-challenge?key=".$queryString;
+    $response = file_get_contents($url);
+    return $response;
+}
+
+echo getChallenge($_GET['key']);

package/php/some-service.php

@@ -0,0 +1,42 @@
+<?php
+/* *
+ * Call verify-solution on auto-hosted latcha service at  https://altcha.supersoniks.org
+ * */ 
+
+
+// Autoriser toutes les origines
+header("Access-Control-Allow-Origin: *");
+
+// Autoriser les méthodes HTTP spécifiques
+header("Access-Control-Allow-Methods: GET, POST, OPTIONS");
+
+// Autoriser certains en-têtes spécifiques
+header("Access-Control-Allow-Headers: Content-Type, Authorization, x-altcha-spam-filter");
+
+// Si la méthode est OPTIONS, terminer la requête ici
+if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
+    http_response_code(200);
+    exit();
+}
+
+function verifySolution($key, $solution){
+    $queryString = $params = [
+        'key' => $key,
+        'altcha' => $solution
+    ];
+    // Générer la chaîne de requête
+    $queryString = http_build_query($params);
+    $url = "https://altcha.supersoniks.org/verify-solution?".$queryString;
+    $response = file_get_contents($url);
+    return $response;
+}
+
+/**
+ * Get json posted data
+ */
+
+// Get the posted data
+
+$data = json_decode(file_get_contents("php://input"));
+
+echo verifySolution($data->captchakey, $data->captchatoken);

package/scripts/pre-build.mjs

@@ -99,6 +99,9 @@ jsonString = jsonString;
 
 const tsConfig = JSON.parse(jsonString);
 tsConfig.compilerOptions.paths = { ...shortPathMapping };
+tsConfig.compilerOptions.paths["@supersoniks/concorde/dataProviderKey"] = [
+  path.resolve(__dirname, "../src/core/utils/dataProviderKey.ts"),
+];
 tsConfig.compilerOptions.paths["@supersoniks/concorde/*"] = ["./*"];
 tsConfig.compilerOptions.paths["@concorde/*"] = ["./*"];
 fs.writeFileSync(tsConfigPath, JSON.stringify(tsConfig, null, 2));
@@ -113,6 +116,7 @@ const pExports = {
     "./src/core/components/ui/icon/icons.json",
   "./core/components/functional/sdui/default-library.json":
     "./src/core/components/functional/sdui/default-library.json",
+  "./dataProviderKey": "./src/core/utils/dataProviderKey.ts",
   "./*": "./src/*.ts",
   "./vite-config": "./vite/config.js",
   "./rollup-plugin-*": "./rollup/plugin-*.js",

package/src/core/_types/endpoint.ts

@@ -0,0 +1,4 @@
+/**
+ * Réexport : définition dans [`utils/endpoint`](../utils/endpoint.ts) — `Endpoint<T, U = any>`.
+ */
+export { Endpoint } from "../utils/endpoint";

package/src/core/_types/key.ts

@@ -0,0 +1 @@
+export { DataProviderKey } from "../utils/dataProviderKey";

package/src/core/components/functional/example/example.ts

@@ -1,11 +1,43 @@
-import {html, LitElement} from "lit";
-import {customElement, property} from "lit/decorators.js";
-import Subscriber from "@supersoniks/concorde/core/mixins/Subscriber";
+import { html, LitElement } from "lit";
+import { customElement, property, state } from "lit/decorators.js";
+import { Endpoint } from "@supersoniks/concorde/utils";
+import { DataProviderKey } from "@supersoniks/concorde/core/utils/dataProviderKey";
+import {
+  get,
+  publish,
+  subscribe,
+  ApiGetResult,
+} from "@supersoniks/concorde/decorators";
+
+/** Same API as the queue demo: https://geo.api.gouv.fr/ */
+type City = { nom: string; code: string };
+
+const endpoint = new Endpoint<City[], { limit: number }>(
+  "communes?limit=$limit&fields=nom,code",
+);
+
+/** Même path que l’endpoint ; type = charge utile `@get` pour `@publish`. */
+const dpKey = new DataProviderKey<ApiGetResult<City[]>>(endpoint.path);
+
 const tagName = "sonic-example"; // For Astro.build
 @customElement(tagName)
-export class SonicComponent extends Subscriber(LitElement) {
-  @property() text = "Example";
+export class SonicComponent extends LitElement {
+  @property({ type: Number })
+  limit = 5;
+
+  @get(endpoint)
+  @publish(dpKey)
+  geoCommunesPayload?: ApiGetResult<City[]>;
+
+  @state()
+  @subscribe(dpKey.result)
+  geoCommunesResult?: City[];
+
   render() {
-    return html`<div>${this.text}</div>`;
+    return html` <span part="api-get-demo">
+      · get: ${JSON.stringify(this.geoCommunesPayload?.result ?? null)} · HTTP
+      ${this.geoCommunesPayload?.response?.status ?? "—"} · subscribe:
+      ${JSON.stringify(this.geoCommunesResult ?? null)}</span
+    >`;
   }
 }

package/src/core/decorators/Subscriber.ts

@@ -1,4 +1,6 @@
 export { bind } from "./subscriber/bind";
+export { publish } from "./subscriber/publish";
+export { subscribe } from "./subscriber/subscribe";
 export { onAssign } from "./subscriber/onAssign";
 export { autoSubscribe } from "./subscriber/autoSubscribe";
 export { autoFill } from "./subscriber/autoFill";

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

@@ -0,0 +1,150 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { Endpoint } from "../utils/endpoint";
+import { DataProviderKey } from "../utils/dataProviderKey";
+import API, {
+  APIConfiguration,
+  type ApiGetResult,
+} from "@supersoniks/concorde/core/utils/api";
+import { PublisherManager } from "@supersoniks/concorde/core/utils/PublisherProxy";
+import { get } from "./api";
+
+const staticConfig: APIConfiguration = {
+  serviceURL: "https://api.example.test",
+  token: null,
+  userName: null,
+  password: null,
+  authToken: null,
+  tokenProvider: null,
+};
+
+async function flushGetMicrotasks() {
+  await Promise.resolve();
+  await Promise.resolve();
+}
+
+function mockPayload<T>(result: T) {
+  return {
+    request: new Request("https://api.example.test/items/1"),
+    response: new Response(JSON.stringify(result), {
+      status: 200,
+      headers: { "Content-Type": "application/json" },
+    }),
+    result,
+  };
+}
+
+describe("get", () => {
+  beforeEach(() => {
+    vi.spyOn(API.prototype, "getDetailed").mockResolvedValue(
+      mockPayload({ id: "loaded" }) as never,
+    );
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+    document.body.replaceChildren();
+  });
+
+  it("assigne ApiGetResult avec configurationKey (publisher)", async () => {
+    const pubId = "getSpecPub1";
+    PublisherManager.get(pubId).set(staticConfig);
+    const confKey = new DataProviderKey<APIConfiguration>(pubId);
+
+    const itemEp = new Endpoint<{ id: string }>("items/1");
+    const tag = "test-api-get-config-key";
+    class C extends HTMLElement {
+      @get(itemEp, confKey)
+      payload: ApiGetResult<{ 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 flushGetMicrotasks();
+    expect(el.payload?.result).toEqual({ id: "loaded" });
+    expect(el.payload?.response?.ok).toBe(true);
+    expect(el.payload?.request.url).toContain("api.example.test");
+    expect(API.prototype.getDetailed).toHaveBeenCalledWith("items/1");
+  });
+
+  it("endpoint dynamique avec configurationKey", async () => {
+    const pubId = "getSpecPub2";
+    PublisherManager.get(pubId).set(staticConfig);
+    const confKey = new DataProviderKey<APIConfiguration>(pubId);
+    const rowEp = new Endpoint<{ id: string }>("rows/${rowId}");
+
+    class TestRow extends HTMLElement {
+      rowId = "42";
+
+      @get(rowEp, confKey)
+      payload: ApiGetResult<{ id: string }> | null = null;
+    }
+
+    const tag = "test-api-get-row";
+    if (!customElements.get(tag)) {
+      customElements.define(tag, TestRow);
+    }
+
+    const el = document.createElement(tag) as InstanceType<typeof TestRow>;
+    document.body.appendChild(el);
+    await flushGetMicrotasks();
+
+    expect(API.prototype.getDetailed).toHaveBeenCalledWith("rows/42");
+    expect(el.payload?.result).toEqual({ id: "loaded" });
+  });
+
+  it("mode scoped lit la configuration sur les ancêtres (getApiConfiguration)", async () => {
+    const dataEp = new Endpoint<{ id: string }>("scoped-endpoint");
+
+    class TestScoped extends HTMLElement {
+      @get(dataEp)
+      payload: ApiGetResult<{ id: string }> | null = null;
+    }
+
+    const tag = "test-api-get-scoped";
+    if (!customElements.get(tag)) {
+      customElements.define(tag, TestScoped);
+    }
+
+    const wrap = document.createElement("div");
+    wrap.setAttribute("serviceURL", "https://from-ancestor.test");
+    const el = document.createElement(tag) as InstanceType<typeof TestScoped>;
+    wrap.appendChild(el);
+    document.body.appendChild(wrap);
+
+    await flushGetMicrotasks();
+
+    expect(API.prototype.getDetailed).toHaveBeenCalledWith("scoped-endpoint");
+    expect(el.payload?.result).toEqual({ id: "loaded" });
+  });
+
+  it("relance le GET quand le publisher de config mute (onInternalMutation)", async () => {
+    const pubId = "getSpecPubMut";
+    const pub = PublisherManager.get(pubId);
+    pub.set(staticConfig);
+    const confKey = new DataProviderKey<APIConfiguration>(pubId);
+    const itemEp = new Endpoint<{ id: string }>("items/1");
+    const tag = "test-api-get-mutation";
+
+    class C extends HTMLElement {
+      @get(itemEp, confKey)
+      payload: ApiGetResult<{ 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 flushGetMicrotasks();
+    expect(API.prototype.getDetailed).toHaveBeenCalledTimes(1);
+
+    pub.set({
+      ...staticConfig,
+      serviceURL: "https://api.example.test/v2",
+    });
+    await flushGetMicrotasks();
+    expect(API.prototype.getDetailed).toHaveBeenCalledTimes(2);
+    expect(el.payload?.result).toEqual({ id: "loaded" });
+  });
+});