@livenetworks/ashlar 1.6.1 → 2.0.0

package/{js → components}/ln-api-connector/README.md

@@ -1,5 +1,7 @@
 # `data-ln-api-connector`
 
+> Applied to a gateway element (`<li data-ln-api-connector data-ln-api-connector-path="/api/path">`) inside a coordinator. It listens for request CustomEvents (`ln-api-connector:request-query`, `create`, `update`, `delete`), attaches a forced `X-LN-Response: data` header, and issues RESTful `fetch()` calls. Upon resolution, it parses JSON payloads and emits `ln-api-connector:data` or mutation response events to the parent coordinator.
+
 A zero-dependency, Local-First sync transport component that implements the Transport Gateway pattern of `ln-ashlar`.
 
 This component encapsulates all connection parameters (base URLs, auth tokens, headers, paths) and provides a declarative, event-driven, or programmatic way to talk to any RESTful or JSON API backend. It isolates networking concerns completely, making your cache store (`data-ln-data-store`) and visual presentation layers fully network-agnostic.
@@ -77,9 +79,10 @@ All attributes are dynamically observed. Any runtime changes to these attributes
 | Attribute | Category | Description |
 |-----------|----------|-------------|
 | `data-ln-api-connector` | Selector | Creates the component instance. Optional value serves as name. |
-| `data-ln-api-base-url` | Connection | The base URL of the API gateway (e.g. `https://api.example.com/v1` or `/api`). Fallback: `data-ln-api-connector-base-url`, `data-ln-rest-base-url`. |
-| `data-ln-api-path` | Connection | Resource path endpoint (e.g. `/documents`). Fallback: `data-ln-api-connector-path`, `data-ln-rest-path`. |
-| `data-ln-api-headers` | Credentials | JSON-formatted string of request headers (e.g. `{"Authorization": "Bearer tok_123"}`). Fallback: `data-ln-api-connector-headers`, `data-ln-rest-headers`. |
+| `data-ln-api-base-url` | Connection | The base URL of the API gateway (e.g. `https://api.example.com/v1` or `/api`). |
+| `data-ln-api-path` | Connection | Resource path endpoint (e.g. `/documents`). |
+| `data-ln-api-headers` | Credentials | JSON-formatted string of request headers (e.g. `{"Authorization": "Bearer tok_123"}`). |
+| `data-ln-api-connector-query-debounce="ms"` | Connection | Debounce delay in milliseconds for `request-query` events. Default `300`. Set to `0` to disable. Mutations (create/update/delete) are never debounced. |
 
 ---
 
@@ -110,19 +113,38 @@ connector.delete(42)
 // 5. Bulk Delete records
 connector.bulkDelete([17, 23])
     .then(res => console.log('Bulk deleted:', res));
+
+// 6. Cancel in-flight query / fetch
+connector.cancel('query'); // or connector.cancel(targetEl)
 ```
 
 ---
 
+## Query Debounce
+
+Remote query requests (`ln-api-connector:request-query`) are debounced per key using a **leading-edge-then-coalesce** strategy:
+
+- The **first** query for an idle key fires immediately (no waiting).
+- Rapid follow-up queries for the same key within the debounce window are coalesced: only the latest one fires when the window closes.
+- An isolated query (e.g. initial page load, a single filter change) is always instant.
+
+The delay defaults to **300 ms** and is overridable via `data-ln-api-connector-query-debounce="<ms>"` on the connector element. Set to `0` to disable debouncing entirely.
+
+Mutations (`create`, `update`, `delete`, `bulk-delete`) are never debounced — they fire immediately every time.
+
+---
+
 ## DOM Events
 
 ### Commands (Dispatched TO the connector)
 
-You can trigger mutations and fetches asynchronously by dispatching standard events directly on the connector DOM element. All events are supported in both `ln-api-connector` and legacy `ln-rest-connector` namespaces.
+You can trigger mutations and fetches asynchronously by dispatching standard events directly on the connector DOM element.
 
 | Event | `detail` Payload | Description |
 |-------|------------------|-------------|
 | `ln-api-connector:request-sync` | `{ since, meta }` | Triggers a delta fetch request. |
+| `ln-api-connector:request-query` | `{ query, meta }` | Triggers a structured query/pagination request. |
+| `ln-api-connector:request-cancel` | `{ targetEl?, key?, meta? }` | Aborts active in-flight request for target element or key. |
 | `ln-api-connector:request-create` | `{ data, tempId, url, idempotencyKey?, meta }` | Triggers a creation request. |
 | `ln-api-connector:request-update` | `{ id, data, expected_version, url, idempotencyKey?, meta }` | Triggers a PUT update (supports 409 conflict checks). |
 | `ln-api-connector:request-delete` | `{ id, url, idempotencyKey?, meta }` | Triggers a deletion request. |
@@ -185,7 +207,7 @@ already does for HTML fragment responses (`ln-ajax.js:160` `if (data.content)`):
   the entire user-facing string.
 - **The connector passes `message` opaquely** — it does not read `message.type`/
   `title`/`body` itself. That happens one level up, in whichever consumer
-  turns it into an `ln-toast:enqueue` (see `js/ln-data-coordinator/README.md`
+  turns it into an `ln-toast:enqueue` (see `components/ln-data-coordinator/README.md`
   → Toasts).
 - **204 caveat.** `_resolve` returns `null` for a 204 response (no body to
   parse), so a DELETE answering `204 No Content` has no envelope and no

package/components/ln-api-connector/ln-api-connector.js

@@ -0,0 +1 @@
+(function(){"use strict";function $(){return typeof window>"u"?!1:window.lnDebug===!0||window.lnCore&&window.lnCore._debugSink?!0:typeof document<"u"&&document.body?document.body.hasAttribute("data-ln-debug")||document.body.querySelector("[data-ln-debug]")!==null:!1}function S(e){if(typeof window>"u")return!1;if(window.lnDebug===!0)return!0;if(window.lnCore&&window.lnCore._debugIsContained)return e?window.lnCore._debugIsContained(e):window.lnCore._debugSink!==null;if(e&&e.closest){const t=e.closest("[data-ln-debug]");return!(!t||typeof document<"u"&&t===document.documentElement)}return typeof document<"u"&&document.body?document.body.hasAttribute("data-ln-debug"):!1}if(typeof window<"u"&&(window.lnCore=window.lnCore||{},!window.lnCore._warnBound)){window.lnCore._warnBound=!0;const e=console.warn;console.warn=function(...t){if(typeof t[0]=="string"&&(t[0].startsWith("[ln-")||t[0].startsWith("[lnCore"))){let r=null;for(let a=1;a<t.length;a++)if(t[a]&&t[a].nodeType===1){r=t[a];break}if(!S(r))return}e.apply(console,t)}}function g(e,t,n){const r=n||{};window.lnCore._debugSink&&window.lnCore._debugSink("event",t,e,r),e.dispatchEvent(new CustomEvent(t,{bubbles:!0,detail:r}))}function k(e,t){if(!document.body){document.addEventListener("DOMContentLoaded",function(){k(e,t)}),console.warn("["+t+'] Script loaded before <body> — add "defer" to your <script> tag');return}e()}function K(e,t="ln-core"){try{return e?JSON.parse(e):{}}catch(n){return console.error(`[${t}] Invalid headers JSON:`,n),{}}}const j={};function V(e,t){j[e]=t}function G(e){return j[e]||{ingress:t=>t,egress:t=>t}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerDataMapper=V,window.lnCore.getDataMapper=G);function X(){typeof window>"u"||(window.lnCore=window.lnCore||{},!window.lnCore._localeObserverBound&&(window.lnCore._localeObserverBound=!0,k(function(){new MutationObserver(function(){g(document,"ln-core:locale-change",{})}).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"],subtree:!0})},"ln-core")))}const R={};function z(e,t){if(!e||typeof t!="object")return;const n=e.toLowerCase().split("-")[0];R[n]=t}function Y(e){if(!e)return null;const t=e.toLowerCase().split("-")[0];return R[t]||null}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerLocaleFallback=z,window.lnCore.getLocaleFallback=Y,window.lnCore.ensureLocaleObserver=X);const O={};function Z(e,t){O[e]||(O[e]=document.querySelector('[data-ln-template="'+e+'"]'));const n=O[e];return n?n.content.cloneNode(!0):(console.warn("["+(t||"ln-core")+'] Template "'+e+'" not found'),null)}function N(e,t){if(!e||!t)return e;const n=e.querySelectorAll("[data-ln-field]");for(let c=0;c<n.length;c++){const u=n[c],f=u.getAttribute("data-ln-field");t[f]!=null&&(u.textContent=t[f])}const r=e.querySelectorAll("[data-ln-attr]");for(let c=0;c<r.length;c++){const u=r[c],f=u.getAttribute("data-ln-attr").split(",");for(let o=0;o<f.length;o++){const d=f[o].trim().split(":");if(d.length!==2)continue;const i=d[0].trim(),l=d[1].trim();t[l]!=null&&u.setAttribute(i,t[l])}}const a=e.querySelectorAll("[data-ln-show]");for(let c=0;c<a.length;c++){const u=a[c],f=u.getAttribute("data-ln-show");f in t&&u.classList.toggle("hidden",!t[f])}const s=e.querySelectorAll("[data-ln-class]");for(let c=0;c<s.length;c++){const u=s[c],f=u.getAttribute("data-ln-class").split(",");for(let o=0;o<f.length;o++){const d=f[o].trim().split(":");if(d.length!==2)continue;const i=d[0].trim(),l=d[1].trim();l in t&&u.classList.toggle(i,!!t[l])}}return e}function P(e,t){e.matches&&e.matches("[data-ln-form], [data-ln-fillable]")&&(window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",e,t??null),e.dispatchEvent(new CustomEvent("ln-fill",{detail:t??null,bubbles:!0})));const n=e.querySelectorAll("[data-ln-form], [data-ln-fillable]");for(let r=0;r<n.length;r++)window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",n[r],t??null),n[r].dispatchEvent(new CustomEvent("ln-fill",{detail:t??null,bubbles:!0}));return e}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._fillBound||(window.lnCore._fillBound=!0,document.addEventListener("ln-fill",function(e){if(!(!e.target.matches||!e.target.matches("[data-ln-fillable]")))if(e.detail)N(e.target,e.detail);else{const t=e.target.querySelectorAll("[data-ln-field]");for(let n=0;n<t.length;n++)t[n].textContent=""}})));function F(e,t){if(!e||!t)return e;const n=document.createTreeWalker(e,NodeFilter.SHOW_TEXT);for(;n.nextNode();){const s=n.currentNode;s.textContent.indexOf("{{")!==-1&&(s.textContent=s.textContent.replace(/\{\{\s*(\w+)\s*\}\}/g,function(c,u){return t[u]!==void 0?t[u]:""}))}const r=function(s,c){return t[c]!==void 0?t[c]:""},a=Array.from(e.querySelectorAll("*"));e.nodeType===1&&a.push(e);for(let s=0;s<a.length;s++){const c=a[s],u=c.attributes;for(let f=0;f<u.length;f++){const o=u[f];o.value.indexOf("{{")!==-1&&c.setAttribute(o.name,o.value.replace(/\{\{\s*(\w+)\s*\}\}/g,r))}}return e}function ee(e,t,n,r,a,s){const c={};for(let f=0;f<e.children.length;f++){const o=e.children[f],d=o.getAttribute("data-ln-render-key");d&&(c[d]=o)}const u=document.createDocumentFragment();for(let f=0;f<t.length;f++){const o=t[f],d=String(r(o));let i=c[d];if(i)a(i,o,f);else{const l=Z(n,s);if(!l||(F(l,o),i=l.firstElementChild,!i))continue;i.setAttribute("data-ln-render-key",d),a(i,o,f)}u.appendChild(i)}e.textContent="",e.appendChild(u)}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.fillTemplate=F,window.lnCore.fill=N,window.lnCore.lnFill=P,window.lnCore.renderList=ee);function A(e,t,n){const r=e.getAttribute(t);return r===null?n:r}function te(e,t,n){const r=parseInt(e.getAttribute(t),10);return isNaN(r)?n:r}function ne(e,t,n=!1){const r=e.getAttribute(t);if(r===null)return!!n;const a=r.trim().toLowerCase();return!(a==="false"||a==="0")}function re(e,t){return(e.getAttribute(t)||"").split(",").map(n=>n.trim()).filter(Boolean)}const T=new Map;function oe(e,t){const n=(e?e.join("|"):"")+"::"+t;if(T.has(n))return T.get(n);const r=new Set(e||[]),a=function(s,c){const u=s.getAttribute(c);return u!==null&&r.has(u)?u:t};return T.set(n,a),a}function ie(e,t,n){const r=parseFloat(e.getAttribute(t));return isNaN(r)?n:r}function ae(e,t,n){const r=e.getAttribute(t);if(!r)return n;try{return JSON.parse(r)}catch{return n}}function M(e,t,n,r,a){if(!e||t===null)return!0;const s=r||"ln-component",c=e.type;if(c==="trigger"||c==="marker"||c==="string"||c==="list"||!c||t===""&&e.fallback!==void 0)return!0;const u=f=>{a?console.warn(f,a):console.warn(f)};if(c==="boolean"){const f=t.trim().toLowerCase();return f!==""&&f!=="true"&&f!=="false"&&f!=="1"&&f!=="0"?(u(`[${s}] Invalid value "${t}" for boolean attribute "${n}". Allowed: "true", "false", or presence-only.`),!1):!0}if(c==="enum"){const f=e.values||[];return f.includes(t)?!0:(u(`[${s}] Invalid value "${t}" for attribute "${n}". Allowed: ${f.join(", ")}. Fallback: "${e.fallback}".`),!1)}if(c==="integer"){if(!/^-?\d+$/.test(t))return u(`[${s}] Invalid integer "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1;const f=parseInt(t,10);return e.min!==void 0&&f<e.min?(u(`[${s}] Value ${f} for attribute "${n}" is less than min (${e.min}).`),!1):e.max!==void 0&&f>e.max?(u(`[${s}] Value ${f} for attribute "${n}" is greater than max (${e.max}).`),!1):!0}if(c==="float")return isNaN(Number(t))?(u(`[${s}] Invalid float "${t}" for attribute "${n}". Fallback: ${e.fallback}.`),!1):!0;if(c==="json")try{return JSON.parse(t),!0}catch(f){return u(`[${s}] Invalid JSON for attribute "${n}": ${f.message}. Fallback: ${e.fallback}.`),!1}return!0}function le(e,t,n){for(const r in n){const[a,s,c]=n[r];Object.defineProperty(e,r,{get:function(){return a(t,s,c)},enumerable:!0,configurable:!0})}return e}function se(e){const t={};for(const n in e){const r=e[n];if(!r||!r.prop)continue;let a=r.read;if(!a&&r.type)switch(r.type){case"enum":a=oe(r.values,r.fallback);break;case"integer":a=te;break;case"float":a=ie;break;case"boolean":a=ne;break;case"list":a=re;break;case"json":a=ae;break;case"string":default:a=A;break}a||(a=A),t[r.prop]=[a,n,r.fallback]}return t}function ce(e){const t={};for(const n in e){const r=e[n];r&&r.effect&&(t[n]=r.effect)}return Object.keys(t).length?t:null}function de(e){if(e.onAttrChange&&!e.declared)return null;const t=new Set;if(e.effects)for(const n in e.effects)t.add(n);if(e.onAttrChange&&e.declared)for(const n of e.declared)t.add(n);return t}function q(e,t,n,r){if(e.nodeType!==1)return;const s=t.indexOf("[")!==-1||t.indexOf(".")!==-1||t.indexOf("#")!==-1?t:"["+t+"]",c=Array.from(e.querySelectorAll(s));e.matches&&e.matches(s)&&c.push(e);for(const u of c)if(!u[n]){window.lnCore._persistSink&&u.hasAttribute("data-ln-persist")&&window.lnCore._persistSink(u,t);try{u[n]=new r(u)}catch(f){console.error("["+n+"] init failed",u,f)}}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[]);function ue(){return typeof window<"u"&&window.lnCore&&window.lnCore._bootHolds||0}function fe(e){typeof window<"u"?(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[],window.lnCore._bootHolds>0?window.lnCore._bootQueue.push(e):setTimeout(e,0)):e()}function U(){window.lnCore=window.lnCore||{};const e=window.lnCore._attrRegistry=window.lnCore._attrRegistry||{byAttr:new Map,reactive:[],persist:[]};return e.byReactive=e.byReactive||new Map,e.reactiveWildcard=e.reactiveWildcard||[],e}function he(e){const t=U(),n=e.observed||[];for(let r=0;r<n.length;r++){const a=n[r];t.byAttr.has(a)||t.byAttr.set(a,[]),t.byAttr.get(a).push(e)}if(t.byDeclaredAttr=t.byDeclaredAttr||new Map,e.attributes)for(const r in e.attributes){t.byDeclaredAttr.has(r)||t.byDeclaredAttr.set(r,[]);const a=t.byDeclaredAttr.get(r);a.some(s=>s.componentTag===e.componentTag)||a.push({spec:e.attributes[r],componentTag:e.componentTag})}if(e.onAttrChange||e.effects){t.reactive.push(e);const r=de(e);if(r===null)t.reactiveWildcard.push(e);else for(const a of r)t.byReactive.has(a)||t.byReactive.set(a,[]),t.byReactive.get(a).push(e)}e.persist&&t.persist.push(e)}function H(e,t,n,r){for(let a=0;a<e.length;a++){const s=e[a];if(!t[s.attribute])continue;const c=s.effects&&s.effects[n];c?c(t,n,r):s.onAttrChange&&(!s.declared||s.declared.has(n))&&s.onAttrChange(t,n,r)}}function pe(e){const t=e.target,n=e.attributeName;if(e.oldValue===t.getAttribute(n))return;const r=U(),a=r.byAttr.get(n);if($()&&r.byDeclaredAttr&&r.byDeclaredAttr.has(n)&&S(t)){const s=r.byDeclaredAttr.get(n),c=t.getAttribute(n);for(let u=0;u<s.length;u++)M(s[u].spec,c,n,s[u].componentTag,t)}if(window.lnCore._debugSink&&(n.indexOf("data-ln-")===0||a)&&window.lnCore._debugSink("attr",n,t,{oldValue:e.oldValue,newValue:t.getAttribute(n)}),n.indexOf("data-ln-")===0){const s=r.byReactive.get(n);s&&H(s,t,n,e.oldValue),r.reactiveWildcard.length&&H(r.reactiveWildcard,t,n,e.oldValue)}if(a)for(let s=0;s<a.length;s++){const c=a[s];if(c.handler){c.handler(t,n,e.oldValue);continue}c.onAttributeChange&&t[c.attribute]?c.onAttributeChange(t,n):(q(t,c.selector,c.attribute,c.ComponentFn),c.onInit&&c.onInit(t))}}function we(){window.lnCore=window.lnCore||{},!window.lnCore._attrObserverBound&&(window.lnCore._attrObserverBound=!0,k(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++)try{pe(t[n])}catch(r){console.error("[ln-core] mutation handler failed",t[n].target,r)}}).observe(document.body,{attributes:!0,subtree:!0,attributeOldValue:!0})},"ln-core"))}function B(){return window.lnCore=window.lnCore||{},window.lnCore._lifecycleRegistry=window.lnCore._lifecycleRegistry||[]}function be(e){const t=B();if(t.length){if(e.target)for(let n=0;n<t.length;n++){const r=t[n];if(r.onSubtreeChange){const a=r.query,s=e.target.nodeType===1?e.target.matches(a)?e.target:e.target.closest(a):e.target.parentElement?e.target.parentElement.closest(a):null;s&&r.onSubtreeChange(s,e)}}for(let n=0;n<e.addedNodes.length;n++){const r=e.addedNodes[n];if(r.nodeType===1)for(let a=0;a<t.length;a++){const s=t[a];q(r,s.selector,s.attribute,s.ComponentFn),s.onInit&&s.onInit(r)}}for(let n=0;n<e.removedNodes.length;n++){const r=e.removedNodes[n];if(r.nodeType===1)for(let a=0;a<t.length;a++){const s=t[a],c=s.query,u=Array.from(r.querySelectorAll(c));r.matches&&r.matches(c)&&u.push(r);for(let f=0;f<u.length;f++){const o=u[f];if(!document.contains(o)){const d=o[s.attribute];if(d&&typeof d.destroy=="function")try{d.destroy()}catch(i){console.error("["+s.attribute+"] destroy failed",o,i)}delete o[s.attribute]}}}}}}function ge(){window.lnCore=window.lnCore||{},!window.lnCore._lifecycleObserverBound&&(window.lnCore._lifecycleObserverBound=!0,k(function(){new MutationObserver(function(t){for(let n=0;n<t.length;n++){const r=t[n];if(r.type==="childList")try{be(r)}catch(a){console.error("[ln-core] lifecycle handler failed",r.target,a)}}}).observe(document.body,{childList:!0,subtree:!0})},"ln-core"))}function me(e,t,n,r,a={}){const s=a.extraAttributes||[],c=a.onAttributeChange||null,u=a.onSubtreeChange||null,f=a.onInit||null,o=a.onAttrChange||null,d=a.effects||null,i=a.attributes||null,l=i?ce(i):d,h=i?new Set(Object.keys(i)):null,p=a.persist||null;function b(v){const w=v||document.body;if(q(w,e,t,n),i&&$())for(const m in i){const Le=i[m],D=Array.from(w.querySelectorAll("["+m+"]"));w.matches&&w.matches("["+m+"]")&&D.push(w);for(let x=0;x<D.length;x++){const I=D[x];S(I)&&M(Le,I.getAttribute(m),m,r,I)}}f&&f(w)}const y=[];if(e.indexOf("[")!==-1){const v=/\[([\w-]+)/g;let w;for(;(w=v.exec(e))!==null;)y.push(w[1])}else y.push(e);he({selector:e,attribute:t,componentTag:r,attributes:i,ComponentFn:n,onInit:f,observed:y.concat(s),onAttributeChange:c,onAttrChange:o,effects:l,declared:h,persist:p}),we();const E=e.indexOf("[")!==-1||e.indexOf(".")!==-1||e.indexOf("#")!==-1?e:"["+e+"]";B().push({selector:e,attribute:t,ComponentFn:n,onInit:f,onSubtreeChange:u,query:E}),ge(),window[t]=b;function _(){ue()>0?fe(function(){b(document.body)}):b(document.body)}return document.readyState==="loading"?document.addEventListener("DOMContentLoaded",_):_(),b}function W(e){return(e||"").replace(/^#/,"")}function L(e){const t=e===void 0?location.hash:e,n={},r=W(t);if(!r)return n;const a=r.split("&");for(let s=0;s<a.length;s++){const c=a[s];if(!c)continue;const u=c.indexOf(":"),f=u>-1?c.slice(0,u):c,o=u>-1?c.slice(u+1):"";if(f)try{n[f]=decodeURIComponent(o)}catch{n[f]=o}}return n}function ye(e){if(!e)return null;const t=L();return e in t?t[e]:null}function Ce(e,t){if(!e)return;const n=L();t==null?delete n[e]:n[e]=String(t);const a=Object.keys(n).map(function(s){const c=n[s];return c===""?s:s+":"+encodeURIComponent(c)}).join("&");W(location.hash)!==a&&(location.hash=a)}function _e(e){return e.button===1||e.ctrlKey||e.metaKey||e.shiftKey?!1:(e.preventDefault(),!0)}function Ae(e,t){if(!e||!e.hasAttribute("data-ln-hash"))return null;const n=e.getAttribute("data-ln-hash");if(n&&n.trim()!=="")return n.trim();const r=e.getAttribute("data-ln-sort")||e.getAttribute("data-ln-search-for")||e.getAttribute("data-ln-search")||e.getAttribute("data-ln-filter")||e.id;return r?t?r+"-"+t:r:t||null}function ve(e,t){return!t||t==="none"||e===null||e===void 0?null:String(e)+"."+t}function ke(e){return!e||typeof e!="string"?null:e.endsWith(".asc")?{fieldOrColumn:e.slice(0,-4),direction:"asc"}:e.endsWith(".desc")?{fieldOrColumn:e.slice(0,-5),direction:"desc"}:null}function Ee(e,t){return!e||!Array.isArray(t)||t.length===0?null:e+":"+t.map(encodeURIComponent).join(",")}function Se(e){if(!e||typeof e!="string")return null;const t=e.indexOf(":");if(t===-1)return null;const n=e.slice(0,t),r=e.slice(t+1),a=r?r.split(",").map(function(s){try{return decodeURIComponent(s)}catch{return s}}).filter(Boolean):[];return{key:n,values:a}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.hashParse=L,window.lnCore.hashGet=ye,window.lnCore.hashSet=Ce,window.lnCore.hashLinkClick=_e,window.lnCore.resolveHashNamespace=Ae,window.lnCore.hashSortEncode=ve,window.lnCore.hashSortDecode=ke,window.lnCore.hashFilterEncode=Ee,window.lnCore.hashFilterDecode=Se);const Oe={offset:"offset",limit:"limit",search:"search",sortField:"sort_field",sortDir:"sort_dir"};function C(...e){return e.filter(t=>t!=null&&t!=="").map((t,n)=>{const r=String(t);return n===0?r.replace(/\/+$/,""):r.replace(/^\/+/,"").replace(/\/+$/,"")}).filter(Boolean).join("/")}function Te(e,t){if(!e||typeof e!="object")return"";const n=Object.assign({},Oe);if(t&&typeof t=="object")for(const a in t)t[a]!==void 0&&t[a]!==null&&t[a]!==""&&(n[a]=t[a]);const r=new URLSearchParams;return e.search&&r.append(n.search,e.search),e.offset!=null&&r.append(n.offset,e.offset),e.limit!=null&&r.append(n.limit,e.limit),e.sort&&e.sort.field&&e.sort.direction&&(r.append(n.sortField,e.sort.field),r.append(n.sortDir,e.sort.direction)),e.filters&&typeof e.filters=="object"&&Object.keys(e.filters).forEach(a=>{const s=e.filters[a];Array.isArray(s)&&s.length>0&&r.append(a,s.join(","))}),r.toString()}function qe(e,t,n){let r=C(e,t);return n&&(r+=(r.indexOf("?")!==-1?"&":"?")+n),r}function Q(e){const t=e&&e.content!==void 0?e.content:e,n=e&&e.message?e.message:null;return{record:t,message:n}}(function(){const e="data-ln-api-connector",t="lnApiConnector",n="lnConnector";if(window[t]!==void 0)return;function r(o){const d=o[t];d&&d.refreshConfig()}const a={"data-ln-api-connector":{type:"marker",description:"Mounts API connector bridging REST backend and ln-ashlar data coordinators"},"data-ln-api-base-url":{prop:"baseUrl",read:A,type:"string",fallback:"",effect:r,description:"Base URL endpoint for API requests"},"data-ln-api-path":{prop:"path",read:A,type:"string",fallback:"",effect:r,description:"Resource path appended to base URL"},"data-ln-api-headers":{prop:"rawHeaders",read:A,type:"json",fallback:null,effect:r,description:"Custom HTTP headers in JSON format or semicolon-separated pairs"},"data-ln-api-param-offset":{effect:r,type:"string",fallback:"offset",description:"Query parameter name for pagination offset"},"data-ln-api-param-limit":{effect:r,type:"string",fallback:"limit",description:"Query parameter name for pagination page size"},"data-ln-api-param-search":{effect:r,type:"string",fallback:"search",description:"Query parameter name for text search filter"},"data-ln-api-param-sort-field":{effect:r,type:"string",fallback:"sort_by",description:"Query parameter name for sort field"},"data-ln-api-param-sort-dir":{effect:r,type:"string",fallback:"sort_dir",description:"Query parameter name for sort direction"},"data-ln-api-connector-query-debounce":{effect:r,type:"integer",fallback:200,min:0,description:"Debounce delay in milliseconds before dispatching query requests"}},s=se(a);function c(o){return o.ok?o.status===204?null:o.json():o.json().catch(()=>null).then(d=>{const i=new Error("HTTP "+o.status+": "+o.statusText);throw i.status=o.status,i.data=d,i})}function u(o){return this.dom=o,le(this,o,s),o[t]=this,o[n]=this,this._inflight=new Map,this._queryTimers=new Map,this.refreshConfig(),this._handlers=null,f(this),this}u.prototype.refreshConfig=function(){const o=this.dom;this.credentials="same-origin",this.headers=K(this.rawHeaders);const d={},i=o.getAttribute("data-ln-api-param-offset");i&&(d.offset=i);const l=o.getAttribute("data-ln-api-param-limit");l&&(d.limit=l);const h=o.getAttribute("data-ln-api-param-search");h&&(d.search=h);const p=o.getAttribute("data-ln-api-param-sort-field");p&&(d.sortField=p);const b=o.getAttribute("data-ln-api-param-sort-dir");b&&(d.sortDir=b),this.paramKeys=d;const y=o.getAttribute("data-ln-api-connector-query-debounce");this.queryDebounce=y!==null?+y:300,g(this.dom,"ln-api-connector:config-changed",{baseUrl:this.baseUrl,path:this.path,headers:this.headers,paramKeys:this.paramKeys})},u.prototype._reqHeaders=function(o){const d=Object.assign({},this.headers);return!d.Accept&&!d.accept&&(d.Accept="application/json"),!d["Content-Type"]&&!d["content-type"]&&(d["Content-Type"]="application/json"),o&&(d["X-Idempotency-Key"]=o),d},u.prototype.cancel=function(o){return o&&this._inflight.has(o)?(this._inflight.get(o).abort(),this._inflight.delete(o),!0):!1},u.prototype.fetchDelta=function(o,d){const i=this;let l=C(i.baseUrl,i.path);o!=null&&o!==""&&(l+=(l.indexOf("?")!==-1?"&":"?")+"since="+encodeURIComponent(o));const h=d||"sync";i._inflight.has(h)&&i._inflight.get(h).abort();const p=new AbortController;return i._inflight.set(h,p),window.fetch(l,{method:"GET",headers:i._reqHeaders(),credentials:i.credentials,signal:p.signal}).then(c).finally(function(){i._inflight.get(h)===p&&i._inflight.delete(h)})},u.prototype.query=function(o,d){const i=this,l=Te(o,i.paramKeys),h=qe(i.baseUrl,i.path,l),p=d||"query";i._inflight.has(p)&&i._inflight.get(p).abort();const b=new AbortController;return i._inflight.set(p,b),window.fetch(h,{method:"GET",headers:i._reqHeaders(),credentials:i.credentials,signal:b.signal}).then(c).finally(function(){i._inflight.get(p)===b&&i._inflight.delete(p)})},u.prototype.create=function(o,d,i){const l=this;return window.fetch(C(l.baseUrl,d||l.path),{method:"POST",headers:l._reqHeaders(i),credentials:l.credentials,body:JSON.stringify(o)}).then(c)},u.prototype.update=function(o,d,i,l,h){const p=this;i!=null&&(d=Object.assign({},d,{expected_version:i}));const b=l?C(p.baseUrl,l):C(p.baseUrl,p.path,o);return window.fetch(b,{method:"PUT",headers:p._reqHeaders(h),credentials:p.credentials,body:JSON.stringify(d)}).then(c)},u.prototype.delete=function(o,d,i){const l=this;return window.fetch(C(l.baseUrl,d||l.path,o),{method:"DELETE",headers:l._reqHeaders(i),credentials:l.credentials}).then(c)},u.prototype.bulkDelete=function(o,d,i){const l=this;return window.fetch(C(l.baseUrl,d||l.path,"bulk-delete"),{method:"DELETE",headers:l._reqHeaders(i),credentials:l.credentials,body:JSON.stringify({ids:o})}).then(c)};function f(o){o._handlers={sync:function(d){const i=d.detail||{},l=i.meta&&i.meta.targetEl?i.meta.targetEl:null;o.fetchDelta(i.since,l).then(function(h){g(o.dom,"ln-api-connector:fetched",{data:h,since:i.since,meta:i.meta||null})}).catch(function(h){h&&h.name==="AbortError"||g(o.dom,"ln-api-connector:error",{action:"sync",error:h.message,status:h.status||0,data:h.data||null,since:i.since,meta:i.meta||null})})},query:function(d){const i=d.detail||{},l=i.query||i,h=i.meta&&i.meta.targetEl?i.meta.targetEl:null,p=h||"query",b=o.queryDebounce;function y(E,_,v){o.query(_,v).then(function(w){const m=w||{};g(o.dom,"ln-api-connector:fetched",{data:m.data||(Array.isArray(m)?m:[]),total:m.total,filtered:m.filtered,offset:_.offset,queryGen:_.queryGen,meta:E.meta||null})}).catch(function(w){w&&w.name==="AbortError"||g(o.dom,"ln-api-connector:error",{action:"query",error:w.message,status:w.status||0,data:w.data||null,meta:E.meta||null})})}if(b===0){y(i,l,h);return}o._queryTimers.has(p)&&clearTimeout(o._queryTimers.get(p));const J=setTimeout(function(){o._queryTimers.delete(p),y(i,l,h)},b);o._queryTimers.set(p,J)},cancel:function(d){const i=d.detail||{},l=i.meta&&i.meta.targetEl?i.meta.targetEl:i.targetEl||i.key;l&&o.cancel(l)},create:function(d){const i=d.detail||{};o.create(i.data,i.url,i.idempotencyKey).then(function(l){const h=Q(l);g(o.dom,"ln-api-connector:created",{record:h.record,tempId:i.tempId,message:h.message,meta:i.meta||null})}).catch(function(l){l&&l.name==="AbortError"||g(o.dom,"ln-api-connector:error",{action:"create",error:l.message,status:l.status||0,data:l.data||null,tempId:i.tempId,meta:i.meta||null})})},update:function(d){const i=d.detail||{};o.update(i.id,i.data,i.expected_version,i.url,i.idempotencyKey).then(function(l){const h=Q(l);g(o.dom,"ln-api-connector:updated",{record:h.record,id:i.id,message:h.message,meta:i.meta||null})}).catch(function(l){l&&l.name==="AbortError"||g(o.dom,"ln-api-connector:error",{action:"update",error:l.message,status:l.status||0,data:l.data||null,id:i.id,conflictData:l.status===409?l.data:null,meta:i.meta||null})})},delete:function(d){const i=d.detail||{};o.delete(i.id,i.url,i.idempotencyKey).then(function(l){const h=l&&l.message?l.message:null;g(o.dom,"ln-api-connector:deleted",{response:l,id:i.id,message:h,meta:i.meta||null})}).catch(function(l){l&&l.name==="AbortError"||g(o.dom,"ln-api-connector:error",{action:"delete",error:l.message,status:l.status||0,data:l.data||null,id:i.id,meta:i.meta||null})})},bulkDelete:function(d){const i=d.detail||{};o.bulkDelete(i.ids,i.url,i.idempotencyKey).then(function(l){const h=l&&l.message?l.message:null;g(o.dom,"ln-api-connector:bulk-deleted",{response:l,ids:i.ids,message:h,meta:i.meta||null})}).catch(function(l){l&&l.name==="AbortError"||g(o.dom,"ln-api-connector:error",{action:"bulk-delete",error:l.message,status:l.status||0,data:l.data||null,ids:i.ids,meta:i.meta||null})})}},o.dom.addEventListener("ln-api-connector:request-sync",o._handlers.sync),o.dom.addEventListener("ln-api-connector:request-query",o._handlers.query),o.dom.addEventListener("ln-api-connector:request-cancel",o._handlers.cancel),o.dom.addEventListener("ln-api-connector:request-create",o._handlers.create),o.dom.addEventListener("ln-api-connector:request-update",o._handlers.update),o.dom.addEventListener("ln-api-connector:request-delete",o._handlers.delete),o.dom.addEventListener("ln-api-connector:request-bulk-delete",o._handlers.bulkDelete)}u.prototype.destroy=function(){if(!this.dom[t])return;const o=this;o._inflight&&(o._inflight.forEach(function(d){d.abort()}),o._inflight.clear()),this._queryTimers&&(this._queryTimers.forEach(function(d){d&&clearTimeout(d)}),this._queryTimers.clear()),this._handlers&&(o.dom.removeEventListener("ln-api-connector:request-sync",o._handlers.sync),o.dom.removeEventListener("ln-api-connector:request-query",o._handlers.query),o.dom.removeEventListener("ln-api-connector:request-cancel",o._handlers.cancel),o.dom.removeEventListener("ln-api-connector:request-create",o._handlers.create),o.dom.removeEventListener("ln-api-connector:request-update",o._handlers.update),o.dom.removeEventListener("ln-api-connector:request-delete",o._handlers.delete),o.dom.removeEventListener("ln-api-connector:request-bulk-delete",o._handlers.bulkDelete),o._handlers=null),delete this.dom[t],delete this.dom[n]},me(e,t,u,"ln-api-connector",{attributes:a})})()})();

package/components/ln-api-connector/ln-api-connector.schema.json

@@ -0,0 +1,96 @@
+{
+	"$comment": "This file is partly generated. The $comment, component, generator, and each attribute's direction, sources, type, values, fallback, and description keys are owned by the generator and synchronized from JS source code. All other keys are preserved and safe to hand-author. Regenerate with `npm run sync:ln-schemas`.",
+	"component": "ln-api-connector",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-api-base-url": {
+			"direction": null,
+			"sources": [
+				"src/ln-api-connector.js"
+			],
+			"type": "string",
+			"fallback": "",
+			"description": "Base URL endpoint for API requests"
+		},
+		"data-ln-api-connector": {
+			"direction": null,
+			"sources": [
+				"src/ln-api-connector.js"
+			],
+			"type": "marker",
+			"description": "Mounts API connector bridging REST backend and ln-ashlar data coordinators"
+		},
+		"data-ln-api-connector-query-debounce": {
+			"direction": "author",
+			"sources": [
+				"src/ln-api-connector.js"
+			],
+			"type": "integer",
+			"fallback": 200,
+			"min": 0,
+			"description": "Debounce delay in milliseconds before dispatching query requests"
+		},
+		"data-ln-api-headers": {
+			"direction": null,
+			"sources": [
+				"src/ln-api-connector.js"
+			],
+			"type": "json",
+			"description": "Custom HTTP headers in JSON format or semicolon-separated pairs"
+		},
+		"data-ln-api-param-limit": {
+			"direction": "author",
+			"sources": [
+				"src/ln-api-connector.js"
+			],
+			"type": "string",
+			"fallback": "limit",
+			"description": "Query parameter name for pagination page size"
+		},
+		"data-ln-api-param-offset": {
+			"direction": "author",
+			"sources": [
+				"src/ln-api-connector.js"
+			],
+			"type": "string",
+			"fallback": "offset",
+			"description": "Query parameter name for pagination offset"
+		},
+		"data-ln-api-param-search": {
+			"direction": "author",
+			"sources": [
+				"src/ln-api-connector.js"
+			],
+			"type": "string",
+			"fallback": "search",
+			"description": "Query parameter name for text search filter"
+		},
+		"data-ln-api-param-sort-dir": {
+			"direction": "author",
+			"sources": [
+				"src/ln-api-connector.js"
+			],
+			"type": "string",
+			"fallback": "sort_dir",
+			"description": "Query parameter name for sort direction"
+		},
+		"data-ln-api-param-sort-field": {
+			"direction": "author",
+			"sources": [
+				"src/ln-api-connector.js"
+			],
+			"type": "string",
+			"fallback": "sort_by",
+			"description": "Query parameter name for sort field"
+		},
+		"data-ln-api-path": {
+			"direction": null,
+			"sources": [
+				"src/ln-api-connector.js"
+			],
+			"type": "string",
+			"fallback": "",
+			"description": "Resource path appended to base URL"
+		}
+	}
+}

package/components/ln-api-connector/src/connector-core.js

@@ -0,0 +1,97 @@
+// ═══════════════════════════════════════════════════════════════
+// connector-core.js — Pure helpers for ln-api-connector
+// ═══════════════════════════════════════════════════════════════
+
+export const DEFAULT_PARAM_KEYS = {
+	offset: 'offset',
+	limit: 'limit',
+	search: 'search',
+	sortField: 'sort_field',
+	sortDir: 'sort_dir'
+};
+
+/**
+ * Joins path segments into a single URL without double slashes.
+ * @param {...(string|number|null|undefined)} parts
+ * @returns {string}
+ */
+export function joinUrl(...parts) {
+	return parts
+		.filter(part => part != null && part !== '')
+		.map((part, index) => {
+			const str = String(part);
+			if (index === 0) return str.replace(/\/+$/, '');
+			return str.replace(/^\/+/, '').replace(/\/+$/, '');
+		})
+		.filter(Boolean)
+		.join('/');
+}
+
+/**
+ * Builds standard URLSearchParams query string from structured query parameters.
+ * @param {Object} [queryParams]
+ * @param {Object} [paramKeys]
+ * @returns {string} Query string without leading '?'
+ */
+export function buildQueryParams(queryParams, paramKeys) {
+	if (!queryParams || typeof queryParams !== 'object') return '';
+	const keys = Object.assign({}, DEFAULT_PARAM_KEYS);
+	if (paramKeys && typeof paramKeys === 'object') {
+		for (const k in paramKeys) {
+			if (paramKeys[k] !== undefined && paramKeys[k] !== null && paramKeys[k] !== '') {
+				keys[k] = paramKeys[k];
+			}
+		}
+	}
+	const searchParams = new URLSearchParams();
+
+	if (queryParams.search) {
+		searchParams.append(keys.search, queryParams.search);
+	}
+	if (queryParams.offset != null) {
+		searchParams.append(keys.offset, queryParams.offset);
+	}
+	if (queryParams.limit != null) {
+		searchParams.append(keys.limit, queryParams.limit);
+	}
+	if (queryParams.sort && queryParams.sort.field && queryParams.sort.direction) {
+		searchParams.append(keys.sortField, queryParams.sort.field);
+		searchParams.append(keys.sortDir, queryParams.sort.direction);
+	}
+	if (queryParams.filters && typeof queryParams.filters === 'object') {
+		Object.keys(queryParams.filters).forEach(key => {
+			const vals = queryParams.filters[key];
+			if (Array.isArray(vals) && vals.length > 0) {
+				searchParams.append(key, vals.join(','));
+			}
+		});
+	}
+
+	return searchParams.toString();
+}
+
+/**
+ * Resolves the final target URL with optional query string.
+ * @param {string} baseUrl
+ * @param {string} path
+ * @param {string} [qs]
+ * @returns {string}
+ */
+export function buildQueryUrl(baseUrl, path, qs) {
+	let url = joinUrl(baseUrl, path);
+	if (qs) {
+		url += (url.indexOf('?') !== -1 ? '&' : '?') + qs;
+	}
+	return url;
+}
+
+/**
+ * Unwraps API response envelope { content, message } if present.
+ * @param {*} body
+ * @returns {{ record: *, message: (string|null) }}
+ */
+export function unwrapEnvelope(body) {
+	const record = (body && body.content !== undefined) ? body.content : body;
+	const message = (body && body.message) ? body.message : null;
+	return { record, message };
+}