@livenetworks/ashlar 1.6.1 → 2.0.0

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

@@ -0,0 +1,447 @@
+import { registerComponent, dispatch, getHeaders, parseHeaders, defineAttrs, attrSpec, attrStr } from '../../ln-core';
+import { buildQueryParams, buildQueryUrl, joinUrl, unwrapEnvelope } from './connector-core';
+
+(function () {
+	const DOM_SELECTOR = 'data-ln-api-connector';
+	const DOM_ATTRIBUTE = 'lnApiConnector';
+	const DOM_ALIAS = 'lnConnector';
+	if (window[DOM_ATTRIBUTE] !== undefined) return;
+
+	// ─── Attribute Contract (SSOT) ──────────────────────────
+	function _syncAttribute(el) {
+		const instance = el[DOM_ATTRIBUTE];
+		if (!instance) return;
+		instance.refreshConfig();
+	}
+
+	const ATTRIBUTES = {
+		'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: attrStr, type: 'string', fallback: '', effect: _syncAttribute, description: 'Base URL endpoint for API requests' },
+		'data-ln-api-path':                     { prop: 'path',       read: attrStr, type: 'string', fallback: '', effect: _syncAttribute, description: 'Resource path appended to base URL' },
+		'data-ln-api-headers':                  { prop: 'rawHeaders', read: attrStr, type: 'json', fallback: null, effect: _syncAttribute, description: 'Custom HTTP headers in JSON format or semicolon-separated pairs' },
+		'data-ln-api-param-offset':             { effect: _syncAttribute, type: 'string', fallback: 'offset', description: 'Query parameter name for pagination offset' },
+		'data-ln-api-param-limit':              { effect: _syncAttribute, type: 'string', fallback: 'limit', description: 'Query parameter name for pagination page size' },
+		'data-ln-api-param-search':             { effect: _syncAttribute, type: 'string', fallback: 'search', description: 'Query parameter name for text search filter' },
+		'data-ln-api-param-sort-field':         { effect: _syncAttribute, type: 'string', fallback: 'sort_by', description: 'Query parameter name for sort field' },
+		'data-ln-api-param-sort-dir':           { effect: _syncAttribute, type: 'string', fallback: 'sort_dir', description: 'Query parameter name for sort direction' },
+		'data-ln-api-connector-query-debounce': { effect: _syncAttribute, type: 'integer', fallback: 200, min: 0, description: 'Debounce delay in milliseconds before dispatching query requests' }
+	};
+	const ATTR_SPEC = attrSpec(ATTRIBUTES);
+
+	// ─── Response Resolver ──────────────────────────────────
+
+	function _resolve(res) {
+		if (res.ok) return res.status === 204 ? null : res.json();
+		return res.json().catch(() => null).then(body => {
+			const err = new Error('HTTP ' + res.status + ': ' + res.statusText);
+			err.status = res.status;
+			err.data = body;
+			throw err;
+		});
+	}
+
+	// ─── Component Constructor ─────────────────────────────
+
+	function _component(dom) {
+		this.dom = dom;
+		defineAttrs(this, dom, ATTR_SPEC);
+		dom[DOM_ATTRIBUTE] = this;
+		dom[DOM_ALIAS] = this; // Set alias for compatibility
+
+		this._inflight = new Map();
+		this._queryTimers = new Map(); // per-key: { timer, pendingDetail, pendingParams, pendingTarget }
+		this.refreshConfig();
+		this._handlers = null;
+		_bindEvents(this);
+
+		return this;
+	}
+
+	// ─── Refresh Config from DOM Attributes ─────────────────
+
+	_component.prototype.refreshConfig = function () {
+		const dom = this.dom;
+
+		this.credentials = 'same-origin';
+		this.headers = parseHeaders(this.rawHeaders);
+
+		const paramKeys = {};
+		const offset = dom.getAttribute('data-ln-api-param-offset');
+		if (offset) paramKeys.offset = offset;
+		const limit = dom.getAttribute('data-ln-api-param-limit');
+		if (limit) paramKeys.limit = limit;
+		const search = dom.getAttribute('data-ln-api-param-search');
+		if (search) paramKeys.search = search;
+		const sortField = dom.getAttribute('data-ln-api-param-sort-field');
+		if (sortField) paramKeys.sortField = sortField;
+		const sortDir = dom.getAttribute('data-ln-api-param-sort-dir');
+		if (sortDir) paramKeys.sortDir = sortDir;
+		this.paramKeys = paramKeys;
+
+		const qd = dom.getAttribute('data-ln-api-connector-query-debounce');
+		this.queryDebounce = qd !== null ? +qd : 300;
+
+		dispatch(this.dom, 'ln-api-connector:config-changed', {
+			baseUrl: this.baseUrl,
+			path: this.path,
+			headers: this.headers,
+			paramKeys: this.paramKeys
+		});
+	};
+
+	// ─── Request Headers (forces X-LN-Response) ─────────────
+
+	_component.prototype._reqHeaders = function (idempotencyKey) {
+		const headers = Object.assign({}, this.headers);
+		if (!headers['Accept'] && !headers['accept']) {
+			headers['Accept'] = 'application/json';
+		}
+		if (!headers['Content-Type'] && !headers['content-type']) {
+			headers['Content-Type'] = 'application/json';
+		}
+		if (idempotencyKey) {
+			headers['X-Idempotency-Key'] = idempotencyKey;
+		}
+		return headers;
+	};
+
+	// ─── Cancellation API ────────────────────────────────────
+
+	_component.prototype.cancel = function (key) {
+		if (!key) return false;
+		if (this._inflight.has(key)) {
+			this._inflight.get(key).abort();
+			this._inflight.delete(key);
+			return true;
+		}
+		return false;
+	};
+
+	// ─── JS API Methods (Promises) ──────────────────────────
+
+	_component.prototype.fetchDelta = function (since, targetEl) {
+		const self = this;
+		let url = joinUrl(self.baseUrl, self.path);
+
+		if (since !== undefined && since !== null && since !== '') {
+			url += (url.indexOf('?') !== -1 ? '&' : '?') + 'since=' + encodeURIComponent(since);
+		}
+
+		const key = targetEl || 'sync';
+		if (self._inflight.has(key)) {
+			self._inflight.get(key).abort();
+		}
+		const controller = new AbortController();
+		self._inflight.set(key, controller);
+
+		return window.fetch(url, {
+			method: 'GET',
+			headers: self._reqHeaders(),
+			credentials: self.credentials,
+			signal: controller.signal
+		})
+		.then(_resolve)
+		.finally(function () {
+			if (self._inflight.get(key) === controller) {
+				self._inflight.delete(key);
+			}
+		});
+	};
+
+	_component.prototype.query = function (queryParams, targetEl) {
+		const self = this;
+		const qs = buildQueryParams(queryParams, self.paramKeys);
+		const url = buildQueryUrl(self.baseUrl, self.path, qs);
+
+		const key = targetEl || 'query';
+		if (self._inflight.has(key)) {
+			self._inflight.get(key).abort();
+		}
+		const controller = new AbortController();
+		self._inflight.set(key, controller);
+
+		return window.fetch(url, {
+			method: 'GET',
+			headers: self._reqHeaders(),
+			credentials: self.credentials,
+			signal: controller.signal
+		})
+		.then(_resolve)
+		.finally(function () {
+			if (self._inflight.get(key) === controller) {
+				self._inflight.delete(key);
+			}
+		});
+	};
+
+	_component.prototype.create = function (payload, url, idempotencyKey) {
+		const self = this;
+		return window.fetch(joinUrl(self.baseUrl, url || self.path), {
+			method: 'POST',
+			headers: self._reqHeaders(idempotencyKey),
+			credentials: self.credentials,
+			body: JSON.stringify(payload)
+		})
+		.then(_resolve);
+	};
+
+	_component.prototype.update = function (id, payload, expectedVersion, url, idempotencyKey) {
+		const self = this;
+		if (expectedVersion !== undefined && expectedVersion !== null) {
+			payload = Object.assign({}, payload, { expected_version: expectedVersion });
+		}
+		// An explicit `url` is the COMPLETE resource URL — it already carries the
+		// id (e.g. the form's resolved action `/documents/42`). Do NOT re-append
+		// id, symmetric with create(). Only the path fallback needs id appended.
+		const target = url ? joinUrl(self.baseUrl, url) : joinUrl(self.baseUrl, self.path, id);
+		return window.fetch(target, {
+			method: 'PUT',
+			headers: self._reqHeaders(idempotencyKey),
+			credentials: self.credentials,
+			body: JSON.stringify(payload)
+		})
+		.then(_resolve);
+	};
+
+	_component.prototype.delete = function (id, url, idempotencyKey) {
+		const self = this;
+		return window.fetch(joinUrl(self.baseUrl, url || self.path, id), {
+			method: 'DELETE',
+			headers: self._reqHeaders(idempotencyKey),
+			credentials: self.credentials
+		})
+		.then(_resolve);
+	};
+
+	_component.prototype.bulkDelete = function (ids, url, idempotencyKey) {
+		const self = this;
+		return window.fetch(joinUrl(self.baseUrl, url || self.path, 'bulk-delete'), {
+			method: 'DELETE',
+			headers: self._reqHeaders(idempotencyKey),
+			credentials: self.credentials,
+			body: JSON.stringify({ ids: ids })
+		})
+		.then(_resolve);
+	};
+
+	// ─── DOM Event Routing ────────────────────────────────────
+
+	function _bindEvents(self) {
+		self._handlers = {
+			sync: function (e) {
+				const detail = e.detail || {};
+				const targetEl = (detail.meta && detail.meta.targetEl) ? detail.meta.targetEl : null;
+				self.fetchDelta(detail.since, targetEl)
+					.then(function (data) {
+						dispatch(self.dom, 'ln-api-connector:fetched', { data: data, since: detail.since, meta: detail.meta || null });
+					})
+					.catch(function (err) {
+						if (err && err.name === 'AbortError') return;
+						dispatch(self.dom, 'ln-api-connector:error', {
+							action: 'sync',
+							error: err.message,
+							status: err.status || 0,
+							data: err.data || null,
+							since: detail.since,
+							meta: detail.meta || null
+						});
+					});
+			},
+			query: function (e) {
+				const detail = e.detail || {};
+				const queryParams = detail.query || detail;
+				const targetEl = (detail.meta && detail.meta.targetEl) ? detail.meta.targetEl : null;
+				const key = targetEl || 'query';
+				const delay = self.queryDebounce;
+
+				function _doQuery(d, qp, tel) {
+					self.query(qp, tel)
+						.then(function (res) {
+							const payload = res || {};
+							dispatch(self.dom, 'ln-api-connector:fetched', {
+								data: payload.data || (Array.isArray(payload) ? payload : []),
+								total: payload.total,
+								filtered: payload.filtered,
+								offset: qp.offset,
+								queryGen: qp.queryGen,
+								meta: d.meta || null
+							});
+						})
+						.catch(function (err) {
+							if (err && err.name === 'AbortError') return;
+							dispatch(self.dom, 'ln-api-connector:error', {
+								action: 'query',
+								error: err.message,
+								status: err.status || 0,
+								data: err.data || null,
+								meta: d.meta || null
+							});
+						});
+				}
+
+				if (delay === 0) {
+					_doQuery(detail, queryParams, targetEl);
+					return;
+				}
+
+				if (self._queryTimers.has(key)) {
+					clearTimeout(self._queryTimers.get(key));
+				}
+
+				const timer = setTimeout(function () {
+					self._queryTimers.delete(key);
+					_doQuery(detail, queryParams, targetEl);
+				}, delay);
+
+				self._queryTimers.set(key, timer);
+			},
+			cancel: function (e) {
+				const detail = e.detail || {};
+				const targetKey = (detail.meta && detail.meta.targetEl) ? detail.meta.targetEl : (detail.targetEl || detail.key);
+				if (targetKey) self.cancel(targetKey);
+			},
+			create: function (e) {
+				const detail = e.detail || {};
+				self.create(detail.data, detail.url, detail.idempotencyKey)
+					.then(function (body) {
+						const unwrapped = unwrapEnvelope(body);
+						dispatch(self.dom, 'ln-api-connector:created', {
+							record: unwrapped.record,
+							tempId: detail.tempId,
+							message: unwrapped.message,
+							meta: detail.meta || null
+						});
+					})
+					.catch(function (err) {
+						if (err && err.name === 'AbortError') return;
+						dispatch(self.dom, 'ln-api-connector:error', {
+							action: 'create',
+							error: err.message,
+							status: err.status || 0,
+							data: err.data || null,
+							tempId: detail.tempId,
+							meta: detail.meta || null
+						});
+					});
+			},
+			update: function (e) {
+				const detail = e.detail || {};
+				self.update(detail.id, detail.data, detail.expected_version, detail.url, detail.idempotencyKey)
+					.then(function (body) {
+						const unwrapped = unwrapEnvelope(body);
+						dispatch(self.dom, 'ln-api-connector:updated', {
+							record: unwrapped.record,
+							id: detail.id,
+							message: unwrapped.message,
+							meta: detail.meta || null
+						});
+					})
+					.catch(function (err) {
+						if (err && err.name === 'AbortError') return;
+						dispatch(self.dom, 'ln-api-connector:error', {
+							action: 'update',
+							error: err.message,
+							status: err.status || 0,
+							data: err.data || null,
+							id: detail.id,
+							conflictData: err.status === 409 ? err.data : null,
+							meta: detail.meta || null
+						});
+					});
+			},
+			delete: function (e) {
+				const detail = e.detail || {};
+				self.delete(detail.id, detail.url, detail.idempotencyKey)
+					.then(function (body) {
+						const message = (body && body.message) ? body.message : null;
+						dispatch(self.dom, 'ln-api-connector:deleted', {
+							response: body,
+							id: detail.id,
+							message: message,
+							meta: detail.meta || null
+						});
+					})
+					.catch(function (err) {
+						if (err && err.name === 'AbortError') return;
+						dispatch(self.dom, 'ln-api-connector:error', {
+							action: 'delete',
+							error: err.message,
+							status: err.status || 0,
+							data: err.data || null,
+							id: detail.id,
+							meta: detail.meta || null
+						});
+					});
+			},
+			bulkDelete: function (e) {
+				const detail = e.detail || {};
+				self.bulkDelete(detail.ids, detail.url, detail.idempotencyKey)
+					.then(function (body) {
+						const message = (body && body.message) ? body.message : null;
+						dispatch(self.dom, 'ln-api-connector:bulk-deleted', {
+							response: body,
+							ids: detail.ids,
+							message: message,
+							meta: detail.meta || null
+						});
+					})
+					.catch(function (err) {
+						if (err && err.name === 'AbortError') return;
+						dispatch(self.dom, 'ln-api-connector:error', {
+							action: 'bulk-delete',
+							error: err.message,
+							status: err.status || 0,
+							data: err.data || null,
+							ids: detail.ids,
+							meta: detail.meta || null
+						});
+					});
+			}
+		};
+
+		self.dom.addEventListener('ln-api-connector:request-sync', self._handlers.sync);
+		self.dom.addEventListener('ln-api-connector:request-query', self._handlers.query);
+		self.dom.addEventListener('ln-api-connector:request-cancel', self._handlers.cancel);
+		self.dom.addEventListener('ln-api-connector:request-create', self._handlers.create);
+		self.dom.addEventListener('ln-api-connector:request-update', self._handlers.update);
+		self.dom.addEventListener('ln-api-connector:request-delete', self._handlers.delete);
+		self.dom.addEventListener('ln-api-connector:request-bulk-delete', self._handlers.bulkDelete);
+	}
+
+	_component.prototype.destroy = function () {
+		if (!this.dom[DOM_ATTRIBUTE]) return;
+
+		const self = this;
+		if (self._inflight) {
+			self._inflight.forEach(function (controller) {
+				controller.abort();
+			});
+			self._inflight.clear();
+		}
+
+		if (this._queryTimers) {
+			this._queryTimers.forEach(function (timer) {
+				if (timer) clearTimeout(timer);
+			});
+			this._queryTimers.clear();
+		}
+
+		if (this._handlers) {
+			self.dom.removeEventListener('ln-api-connector:request-sync', self._handlers.sync);
+			self.dom.removeEventListener('ln-api-connector:request-query', self._handlers.query);
+			self.dom.removeEventListener('ln-api-connector:request-cancel', self._handlers.cancel);
+			self.dom.removeEventListener('ln-api-connector:request-create', self._handlers.create);
+			self.dom.removeEventListener('ln-api-connector:request-update', self._handlers.update);
+			self.dom.removeEventListener('ln-api-connector:request-delete', self._handlers.delete);
+			self.dom.removeEventListener('ln-api-connector:request-bulk-delete', self._handlers.bulkDelete);
+			self._handlers = null;
+		}
+
+		delete this.dom[DOM_ATTRIBUTE];
+		delete this.dom[DOM_ALIAS];
+	};
+
+	registerComponent(DOM_SELECTOR, DOM_ATTRIBUTE, _component, 'ln-api-connector', {
+		attributes: ATTRIBUTES
+	});
+})();

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

@@ -1,5 +1,7 @@
 # `data-ln-api-queue`
 
+> Applied to an outbox element (`<li data-ln-api-queue>`) nested inside `data-ln-data-coordinator`. It listens for `ln-api-queue:request-enqueue` from the coordinator, persists mutations to an internal `IndexedDB` outbox (`ln_api_queue`) with monotonic per-scope sequence counters, and emits `ln-api-queue:send` CustomEvents for FIFO dispatch. It never initiates network requests directly, updating retry attempts with exponential backoff until acknowledged via `ack`/`nack`.
+
 A zero-dependency, Local-First **offline write outbox** component that implements the persistent-queue tier of `ln-ashlar`'s 3-tier data layer.
 
 This component persists pending mutations to its own `IndexedDB` database and replays them, FIFO per chain, once the coordinator can execute transport for them. It is **connector-blind and id-blind** — it never calls the network itself, never knows about REST paths, and never interprets `entryId`/`targetId`/`chainKey` beyond bookkeeping. The parent `ln-data-coordinator` executes the actual transport call on the queue's `ln-api-queue:send` command and reports the outcome back via `ack` / `nack`.
@@ -11,9 +13,9 @@ This component persists pending mutations to its own `IndexedDB` database and re
 Place the queue inside your parent coordinator element alongside your store and connector — it is an **optional** third child:
 
 ```html
-<ul data-ln-data-coordinator="documents" hidden>
+<ul id="documents-module" data-ln-data-coordinator hidden>
     <!-- Storage Layer Cache (Blind to networking) -->
-    <li data-ln-data-store
+    <li id="documents" data-ln-data-store
         data-ln-data-store-indexes="status,updated_at">
     </li>
 
@@ -24,7 +26,7 @@ Place the queue inside your parent coordinator element alongside your store and
     </li>
 
     <!-- Offline Outbox (optional Child 3) -->
-    <li data-ln-api-queue></li>
+    <li id="documents-queue" data-ln-api-queue></li>
 </ul>
 ```
 
@@ -36,8 +38,9 @@ When this child is absent, the coordinator's write handlers call the connector d
 
 | Attribute | Category | Description |
 |-----------|----------|-------------|
-| `data-ln-api-queue` | Selector | Creates the component instance. Optional value serves as a scope/name (defaults to the coordinator's scope). |
-| `data-ln-api-queue-online` | Status (read-only, reflected) | Set by the component itself — `"true"` when the scope is draining/idle normally, `"false"` while paused (e.g. auth pause). Useful for CSS hooks on a connectivity indicator; not meant to be written by consumers. |
+| `id="name"` | Identity | Unique identifier of the queue (the scope name). Defaults to the coordinator's `id` if nested, else `'default'`. |
+| `data-ln-api-queue` | Selector | Marker attribute to declare the component. |
+| `data-ln-api-queue-online` | Connectivity Override | Consumer override attribute (e.g. `"false"` to simulate offline state during testing/manual debugging). Checked via `_isOnline()`. |
 
 ---
 
@@ -48,7 +51,7 @@ The queue owns its **own** IndexedDB database, `ln_api_queue` — entirely separ
 | Object store | Key path | Indexes | Purpose |
 |---|---|---|---|
 | `outbox` | `entryId` | `by_scope_chain` (`[scope, chainKey]`), `by_scope_seq` (`[scope, seq]`) | One row per pending mutation. `seq` is a monotonically increasing per-scope counter used to preserve global FIFO ordering within a scope; `by_scope_chain` is used to find the head entry per chain. |
-| `_queue_meta` | `key` | — | Holds `seq:<scope>` counters and `paused:<scope>` auth-pause state. |
+| `_queue_meta` | `key` | — | Holds `seq:<scope>` counters and `paused:<scope>` state (`'auth'`, `'manual'`, or `false`). |
 
 Each `outbox` entry carries: `entryId`, `scope`, `chainKey`, `seq`, `op`, `targetId`, `payload`, `expectedVersion`, `meta`, `attempts`, `status` (`pending` / `inflight` / `failed`), `leaseOwner`, `leaseUntil`, and timestamps. The queue never inspects `payload` — it passes it through untouched to whatever the coordinator sends on `ln-api-queue:send`.
 
@@ -86,6 +89,7 @@ const queue = queueEl.lnApiQueue;
 | `ln-api-queue:request-remap` | `{ oldKey, newId }` | For pending entries whose chain is `oldKey`: any entry with `targetId === oldKey` gets `targetId = newId`; the chain itself is re-keyed from `oldKey` to `newId`; if `meta.action` contains `oldKey` as a substring, it is string-replaced with `newId` too (keeps a persisted per-record URL in sync after a create resolves). |
 | `ln-api-queue:resolve-create` | `{ entryId, oldKey, newId }` | Atomically deletes the acknowledged create and remaps every queued sibling from the temp key to the authoritative id in one transaction, then advances the chain. |
 | `ln-api-queue:request-resume` | `{}` | Clears the pause on this scope and resumes draining. |
+| `ln-api-queue:request-pause` | `{}` | Manually pauses draining for this scope. |
 | `ln-api-queue:request-drain` | `{}` | Manually triggers a drain attempt (e.g. to retry `failed` entries). |
 | `ln-api-queue:request-clear` | `{}` | Deletes all entries for this scope (e.g. on logout). |
 
@@ -97,12 +101,11 @@ const queue = queueEl.lnApiQueue;
 | `ln-api-queue:enqueued` | `{ entryId, chainKey, count }` | An entry was persisted. |
 | `ln-api-queue:pending-count` | `{ count, scope }` | Live outbox depth for the scope — the primary UI-facing signal (badge, banner). |
 | `ln-api-queue:auth-required` | `{ entryId, chainKey }` | The scope paused after a `401`/`419` nack. The consumer drives re-authentication, then dispatches `request-resume`. |
-| `ln-api-queue:paused` | `{ reason }` | Draining paused for this scope. |
+| `ln-api-queue:paused` | `{ reason: "auth" \| "manual", restored?: Boolean }` | Draining paused for this scope. `restored: true` when re-emitted upon component boot from persisted state. |
 | `ln-api-queue:resumed` | `{}` | Draining resumed for this scope. |
 | `ln-api-queue:failed` | `{ entryId, chainKey, attempts }` | Retries exhausted (see backoff below); the entry is retained (not deleted) for a manual `request-drain`. |
 | `ln-api-queue:drained` | `{ scope }` | The outbox for this scope is empty. |
 | `ln-api-queue:error` | `{ operation, entryId?, error }` | IndexedDB or queue orchestration failed without silently discarding the entry. |
-| `ln-api-queue:destroyed` | `{ scope }` | The instance was torn down. |
 
 ---
 
@@ -174,7 +177,7 @@ The queue never imports or references a connector, never constructs a URL, and n
 
 ```javascript
 (function () {
-    const parent = document.querySelector('[data-ln-data-coordinator="documents"]');
+    const parent = document.getElementById('documents-module');
     const queueEl = parent.querySelector('[data-ln-api-queue]');
     const connectorEl = parent.querySelector('[data-ln-api-connector]');
 

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

@@ -0,0 +1 @@
+(function(){"use strict";function R(){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 k(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 o=null;for(let u=1;u<t.length;u++)if(t[u]&&t[u].nodeType===1){o=t[u];break}if(!k(o))return}e.apply(console,t)}}function w(e,t,r){const o=r||{};window.lnCore._debugSink&&window.lnCore._debugSink("event",t,e,o),e.dispatchEvent(new CustomEvent(t,{bubbles:!0,detail:o}))}function A(e,t){if(!document.body){document.addEventListener("DOMContentLoaded",function(){A(e,t)}),console.warn("["+t+'] Script loaded before <body> — add "defer" to your <script> tag');return}e()}const P={};function z(e,t){P[e]=t}function X(e){return P[e]||{ingress:t=>t,egress:t=>t}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerDataMapper=z,window.lnCore.getDataMapper=X);function G(){typeof window>"u"||(window.lnCore=window.lnCore||{},!window.lnCore._localeObserverBound&&(window.lnCore._localeObserverBound=!0,A(function(){new MutationObserver(function(){w(document,"ln-core:locale-change",{})}).observe(document.documentElement,{attributes:!0,attributeFilter:["lang"],subtree:!0})},"ln-core")))}const Q={};function J(e,t){if(!e||typeof t!="object")return;const r=e.toLowerCase().split("-")[0];Q[r]=t}function Y(e){if(!e)return null;const t=e.toLowerCase().split("-")[0];return Q[t]||null}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.registerLocaleFallback=J,window.lnCore.getLocaleFallback=Y,window.lnCore.ensureLocaleObserver=G);const E={};function Z(e,t){E[e]||(E[e]=document.querySelector('[data-ln-template="'+e+'"]'));const r=E[e];return r?r.content.cloneNode(!0):(console.warn("["+(t||"ln-core")+'] Template "'+e+'" not found'),null)}function B(e,t){if(!e||!t)return e;const r=e.querySelectorAll("[data-ln-field]");for(let i=0;i<r.length;i++){const l=r[i],c=l.getAttribute("data-ln-field");t[c]!=null&&(l.textContent=t[c])}const o=e.querySelectorAll("[data-ln-attr]");for(let i=0;i<o.length;i++){const l=o[i],c=l.getAttribute("data-ln-attr").split(",");for(let d=0;d<c.length;d++){const n=c[d].trim().split(":");if(n.length!==2)continue;const s=n[0].trim(),f=n[1].trim();t[f]!=null&&l.setAttribute(s,t[f])}}const u=e.querySelectorAll("[data-ln-show]");for(let i=0;i<u.length;i++){const l=u[i],c=l.getAttribute("data-ln-show");c in t&&l.classList.toggle("hidden",!t[c])}const a=e.querySelectorAll("[data-ln-class]");for(let i=0;i<a.length;i++){const l=a[i],c=l.getAttribute("data-ln-class").split(",");for(let d=0;d<c.length;d++){const n=c[d].trim().split(":");if(n.length!==2)continue;const s=n[0].trim(),f=n[1].trim();f in t&&l.classList.toggle(s,!!t[f])}}return e}function ee(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 r=e.querySelectorAll("[data-ln-form], [data-ln-fillable]");for(let o=0;o<r.length;o++)window.lnCore._debugSink&&window.lnCore._debugSink("event","ln-fill",r[o],t??null),r[o].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)B(e.target,e.detail);else{const t=e.target.querySelectorAll("[data-ln-field]");for(let r=0;r<t.length;r++)t[r].textContent=""}})));function M(e,t){if(!e||!t)return e;const r=document.createTreeWalker(e,NodeFilter.SHOW_TEXT);for(;r.nextNode();){const a=r.currentNode;a.textContent.indexOf("{{")!==-1&&(a.textContent=a.textContent.replace(/\{\{\s*(\w+)\s*\}\}/g,function(i,l){return t[l]!==void 0?t[l]:""}))}const o=function(a,i){return t[i]!==void 0?t[i]:""},u=Array.from(e.querySelectorAll("*"));e.nodeType===1&&u.push(e);for(let a=0;a<u.length;a++){const i=u[a],l=i.attributes;for(let c=0;c<l.length;c++){const d=l[c];d.value.indexOf("{{")!==-1&&i.setAttribute(d.name,d.value.replace(/\{\{\s*(\w+)\s*\}\}/g,o))}}return e}function te(e,t,r,o,u,a){const i={};for(let c=0;c<e.children.length;c++){const d=e.children[c],n=d.getAttribute("data-ln-render-key");n&&(i[n]=d)}const l=document.createDocumentFragment();for(let c=0;c<t.length;c++){const d=t[c],n=String(o(d));let s=i[n];if(s)u(s,d,c);else{const f=Z(r,a);if(!f||(M(f,d),s=f.firstElementChild,!s))continue;s.setAttribute("data-ln-render-key",n),u(s,d,c)}l.appendChild(s)}e.textContent="",e.appendChild(l)}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.fillTemplate=M,window.lnCore.fill=B,window.lnCore.lnFill=ee,window.lnCore.renderList=te);function $(e,t,r,o,u){if(!e||t===null)return!0;const a=o||"ln-component",i=e.type;if(i==="trigger"||i==="marker"||i==="string"||i==="list"||!i||t===""&&e.fallback!==void 0)return!0;const l=c=>{u?console.warn(c,u):console.warn(c)};if(i==="boolean"){const c=t.trim().toLowerCase();return c!==""&&c!=="true"&&c!=="false"&&c!=="1"&&c!=="0"?(l(`[${a}] Invalid value "${t}" for boolean attribute "${r}". Allowed: "true", "false", or presence-only.`),!1):!0}if(i==="enum"){const c=e.values||[];return c.includes(t)?!0:(l(`[${a}] Invalid value "${t}" for attribute "${r}". Allowed: ${c.join(", ")}. Fallback: "${e.fallback}".`),!1)}if(i==="integer"){if(!/^-?\d+$/.test(t))return l(`[${a}] Invalid integer "${t}" for attribute "${r}". Fallback: ${e.fallback}.`),!1;const c=parseInt(t,10);return e.min!==void 0&&c<e.min?(l(`[${a}] Value ${c} for attribute "${r}" is less than min (${e.min}).`),!1):e.max!==void 0&&c>e.max?(l(`[${a}] Value ${c} for attribute "${r}" is greater than max (${e.max}).`),!1):!0}if(i==="float")return isNaN(Number(t))?(l(`[${a}] Invalid float "${t}" for attribute "${r}". Fallback: ${e.fallback}.`),!1):!0;if(i==="json")try{return JSON.parse(t),!0}catch(c){return l(`[${a}] Invalid JSON for attribute "${r}": ${c.message}. Fallback: ${e.fallback}.`),!1}return!0}function ne(e){const t={};for(const r in e){const o=e[r];o&&o.effect&&(t[r]=o.effect)}return Object.keys(t).length?t:null}function re(e){if(e.onAttrChange&&!e.declared)return null;const t=new Set;if(e.effects)for(const r in e.effects)t.add(r);if(e.onAttrChange&&e.declared)for(const r of e.declared)t.add(r);return t}function S(e,t,r,o){if(e.nodeType!==1)return;const a=t.indexOf("[")!==-1||t.indexOf(".")!==-1||t.indexOf("#")!==-1?t:"["+t+"]",i=Array.from(e.querySelectorAll(a));e.matches&&e.matches(a)&&i.push(e);for(const l of i)if(!l[r]){window.lnCore._persistSink&&l.hasAttribute("data-ln-persist")&&window.lnCore._persistSink(l,t);try{l[r]=new o(l)}catch(c){console.error("["+r+"] init failed",l,c)}}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore._bootHolds=window.lnCore._bootHolds||0,window.lnCore._bootQueue=window.lnCore._bootQueue||[]);function oe(){return typeof window<"u"&&window.lnCore&&window.lnCore._bootHolds||0}function ie(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 N(){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 se(e){const t=N(),r=e.observed||[];for(let o=0;o<r.length;o++){const u=r[o];t.byAttr.has(u)||t.byAttr.set(u,[]),t.byAttr.get(u).push(e)}if(t.byDeclaredAttr=t.byDeclaredAttr||new Map,e.attributes)for(const o in e.attributes){t.byDeclaredAttr.has(o)||t.byDeclaredAttr.set(o,[]);const u=t.byDeclaredAttr.get(o);u.some(a=>a.componentTag===e.componentTag)||u.push({spec:e.attributes[o],componentTag:e.componentTag})}if(e.onAttrChange||e.effects){t.reactive.push(e);const o=re(e);if(o===null)t.reactiveWildcard.push(e);else for(const u of o)t.byReactive.has(u)||t.byReactive.set(u,[]),t.byReactive.get(u).push(e)}e.persist&&t.persist.push(e)}function F(e,t,r,o){for(let u=0;u<e.length;u++){const a=e[u];if(!t[a.attribute])continue;const i=a.effects&&a.effects[r];i?i(t,r,o):a.onAttrChange&&(!a.declared||a.declared.has(r))&&a.onAttrChange(t,r,o)}}function ae(e){const t=e.target,r=e.attributeName;if(e.oldValue===t.getAttribute(r))return;const o=N(),u=o.byAttr.get(r);if(R()&&o.byDeclaredAttr&&o.byDeclaredAttr.has(r)&&k(t)){const a=o.byDeclaredAttr.get(r),i=t.getAttribute(r);for(let l=0;l<a.length;l++)$(a[l].spec,i,r,a[l].componentTag,t)}if(window.lnCore._debugSink&&(r.indexOf("data-ln-")===0||u)&&window.lnCore._debugSink("attr",r,t,{oldValue:e.oldValue,newValue:t.getAttribute(r)}),r.indexOf("data-ln-")===0){const a=o.byReactive.get(r);a&&F(a,t,r,e.oldValue),o.reactiveWildcard.length&&F(o.reactiveWildcard,t,r,e.oldValue)}if(u)for(let a=0;a<u.length;a++){const i=u[a];if(i.handler){i.handler(t,r,e.oldValue);continue}i.onAttributeChange&&t[i.attribute]?i.onAttributeChange(t,r):(S(t,i.selector,i.attribute,i.ComponentFn),i.onInit&&i.onInit(t))}}function ue(){window.lnCore=window.lnCore||{},!window.lnCore._attrObserverBound&&(window.lnCore._attrObserverBound=!0,A(function(){new MutationObserver(function(t){for(let r=0;r<t.length;r++)try{ae(t[r])}catch(o){console.error("[ln-core] mutation handler failed",t[r].target,o)}}).observe(document.body,{attributes:!0,subtree:!0,attributeOldValue:!0})},"ln-core"))}function K(){return window.lnCore=window.lnCore||{},window.lnCore._lifecycleRegistry=window.lnCore._lifecycleRegistry||[]}function le(e){const t=K();if(t.length){if(e.target)for(let r=0;r<t.length;r++){const o=t[r];if(o.onSubtreeChange){const u=o.query,a=e.target.nodeType===1?e.target.matches(u)?e.target:e.target.closest(u):e.target.parentElement?e.target.parentElement.closest(u):null;a&&o.onSubtreeChange(a,e)}}for(let r=0;r<e.addedNodes.length;r++){const o=e.addedNodes[r];if(o.nodeType===1)for(let u=0;u<t.length;u++){const a=t[u];S(o,a.selector,a.attribute,a.ComponentFn),a.onInit&&a.onInit(o)}}for(let r=0;r<e.removedNodes.length;r++){const o=e.removedNodes[r];if(o.nodeType===1)for(let u=0;u<t.length;u++){const a=t[u],i=a.query,l=Array.from(o.querySelectorAll(i));o.matches&&o.matches(i)&&l.push(o);for(let c=0;c<l.length;c++){const d=l[c];if(!document.contains(d)){const n=d[a.attribute];if(n&&typeof n.destroy=="function")try{n.destroy()}catch(s){console.error("["+a.attribute+"] destroy failed",d,s)}delete d[a.attribute]}}}}}}function ce(){window.lnCore=window.lnCore||{},!window.lnCore._lifecycleObserverBound&&(window.lnCore._lifecycleObserverBound=!0,A(function(){new MutationObserver(function(t){for(let r=0;r<t.length;r++){const o=t[r];if(o.type==="childList")try{le(o)}catch(u){console.error("[ln-core] lifecycle handler failed",o.target,u)}}}).observe(document.body,{childList:!0,subtree:!0})},"ln-core"))}function de(e,t,r,o,u={}){const a=u.extraAttributes||[],i=u.onAttributeChange||null,l=u.onSubtreeChange||null,c=u.onInit||null,d=u.onAttrChange||null,n=u.effects||null,s=u.attributes||null,f=s?ne(s):n,p=s?new Set(Object.keys(s)):null,m=u.persist||null;function h(D){const _=D||document.body;if(S(_,e,t,r),s&&R())for(const x in s){const Ee=s[x],L=Array.from(_.querySelectorAll("["+x+"]"));_.matches&&_.matches("["+x+"]")&&L.push(_);for(let O=0;O<L.length;O++){const T=L[O];k(T)&&$(Ee,T.getAttribute(x),x,o,T)}}c&&c(_)}const C=[];if(e.indexOf("[")!==-1){const D=/\[([\w-]+)/g;let _;for(;(_=D.exec(e))!==null;)C.push(_[1])}else C.push(e);se({selector:e,attribute:t,componentTag:o,attributes:s,ComponentFn:r,onInit:c,observed:C.concat(a),onAttributeChange:i,onAttrChange:d,effects:f,declared:p,persist:m}),ue();const ke=e.indexOf("[")!==-1||e.indexOf(".")!==-1||e.indexOf("#")!==-1?e:"["+e+"]";K().push({selector:e,attribute:t,ComponentFn:r,onInit:c,onSubtreeChange:l,query:ke}),ce(),window[t]=h;function H(){oe()>0?ie(function(){h(document.body)}):h(document.body)}return document.readyState==="loading"?document.addEventListener("DOMContentLoaded",H):H(),h}function U(e){return(e||"").replace(/^#/,"")}function I(e){const t=e===void 0?location.hash:e,r={},o=U(t);if(!o)return r;const u=o.split("&");for(let a=0;a<u.length;a++){const i=u[a];if(!i)continue;const l=i.indexOf(":"),c=l>-1?i.slice(0,l):i,d=l>-1?i.slice(l+1):"";if(c)try{r[c]=decodeURIComponent(d)}catch{r[c]=d}}return r}function fe(e){if(!e)return null;const t=I();return e in t?t[e]:null}function pe(e,t){if(!e)return;const r=I();t==null?delete r[e]:r[e]=String(t);const u=Object.keys(r).map(function(a){const i=r[a];return i===""?a:a+":"+encodeURIComponent(i)}).join("&");U(location.hash)!==u&&(location.hash=u)}function he(e){return e.button===1||e.ctrlKey||e.metaKey||e.shiftKey?!1:(e.preventDefault(),!0)}function we(e,t){if(!e||!e.hasAttribute("data-ln-hash"))return null;const r=e.getAttribute("data-ln-hash");if(r&&r.trim()!=="")return r.trim();const o=e.getAttribute("data-ln-sort")||e.getAttribute("data-ln-search-for")||e.getAttribute("data-ln-search")||e.getAttribute("data-ln-filter")||e.id;return o?t?o+"-"+t:o:t||null}function me(e,t){return!t||t==="none"||e===null||e===void 0?null:String(e)+"."+t}function be(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 ye(e,t){return!e||!Array.isArray(t)||t.length===0?null:e+":"+t.map(encodeURIComponent).join(",")}function ge(e){if(!e||typeof e!="string")return null;const t=e.indexOf(":");if(t===-1)return null;const r=e.slice(0,t),o=e.slice(t+1),u=o?o.split(",").map(function(a){try{return decodeURIComponent(a)}catch{return a}}).filter(Boolean):[];return{key:r,values:u}}typeof window<"u"&&(window.lnCore=window.lnCore||{},window.lnCore.hashParse=I,window.lnCore.hashGet=fe,window.lnCore.hashSet=pe,window.lnCore.hashLinkClick=he,window.lnCore.resolveHashNamespace=we,window.lnCore.hashSortEncode=me,window.lnCore.hashSortDecode=be,window.lnCore.hashFilterEncode=ye,window.lnCore.hashFilterDecode=ge);const _e="ln_api_queue",Ce=2,b="outbox",y="_queue_meta";function g(e,t){return e.error||new Error(t)}function q(e,t){return e.bound([t,-1/0],[t,1/0])}function V(e){return"seq:"+e}function v(e){return"paused:"+e}function j(e){e.leaseOwner=null,e.leaseUntil=0}function qe(e,t,r){return typeof e!="string"||e.indexOf(t)===-1?e:e.split(t).join(r)}function xe(e,t,r,o){const u=new Map,a=[],i=[];for(const l of e||[])u.has(l.chainKey)||u.set(l.chainKey,[]),u.get(l.chainKey).push(l);return u.forEach((l,c)=>{l.sort((n,s)=>n.seq-s.seq);const d=l[0];if(!(!d||d.status==="failed")){if(d.status==="inflight"&&(d.leaseUntil||0)>o){i.push({chainKey:c,at:d.leaseUntil});return}if((d.nextAttemptAt||0)>o){i.push({chainKey:c,at:d.nextAttemptAt});return}d.status="inflight",d.leaseOwner=t,d.leaseUntil=o+r,d.updatedAt=o,a.push(d)}}),{entries:a,wakeups:i}}function Ae(e,t,r,o,u){const a=[],i=[];for(const l of e||[]){if(l.entryId===t){i.push(l.entryId);continue}l.chainKey===r&&(l.chainKey=o,l.targetId===r&&(l.targetId=o),l.meta&&l.meta.id===r&&(l.meta.id=o),l.meta&&typeof l.meta.action=="string"&&(l.meta.action=qe(l.meta.action,r,o)),l.updatedAt=u,a.push(l))}return{changed:a,deleted:i}}class ve{constructor(t){t=t||{},this.indexedDB=t.indexedDB||globalThis.indexedDB,this.keyRange=t.IDBKeyRange||globalThis.IDBKeyRange,this.dbName=t.dbName||_e,this.now=t.now||(()=>Date.now()),this.uuid=t.uuid||(()=>crypto.randomUUID()),this._db=null,this._ready=null}open(){return this._ready?this._ready:!this.indexedDB||!this.keyRange?Promise.resolve(null):(this._ready=new Promise((t,r)=>{const o=this.indexedDB.open(this.dbName,Ce);o.onupgradeneeded=u=>{const a=u.target.result;let i;a.objectStoreNames.contains(b)?i=u.target.transaction.objectStore(b):i=a.createObjectStore(b,{keyPath:"entryId"}),i.indexNames.contains("by_scope_chain")||i.createIndex("by_scope_chain",["scope","chainKey"],{unique:!1}),i.indexNames.contains("by_scope_seq")||i.createIndex("by_scope_seq",["scope","seq"],{unique:!1}),a.objectStoreNames.contains(y)||a.createObjectStore(y,{keyPath:"key"})},o.onerror=()=>r(g(o,"Queue database open failed")),o.onsuccess=u=>{this._db=u.target.result,this._db.onversionchange=()=>this.close(),t(this._db)}}),this._ready)}close(){this._db&&this._db.close(),this._db=null,this._ready=null}deleteDatabase(){return this.close(),this.indexedDB?new Promise((t,r)=>{const o=this.indexedDB.deleteDatabase(this.dbName);o.onsuccess=()=>t(),o.onerror=()=>r(g(o,"Queue database delete failed")),o.onblocked=()=>r(new Error("Queue database delete blocked"))}):Promise.resolve()}allForScope(t){return this.open().then(r=>r?new Promise((o,u)=>{const i=r.transaction(b,"readonly").objectStore(b).index("by_scope_seq").getAll(q(this.keyRange,t));i.onsuccess=()=>o(i.result||[]),i.onerror=()=>u(g(i,"Queue scope read failed"))}):[])}enqueue(t,r){return r=r||{},this.open().then(o=>o?new Promise((u,a)=>{const i=o.transaction([y,b],"readwrite"),l=i.objectStore(y),c=i.objectStore(b),d=V(t);let n=null;const s=p=>{const m=p+1;n={entryId:this.uuid(),scope:t,chainKey:r.chainKey,seq:m,op:r.op,targetId:r.targetId!==void 0?r.targetId:null,payload:r.payload,expectedVersion:r.expectedVersion!==void 0?r.expectedVersion:null,meta:r.meta||{},attempts:0,nextAttemptAt:0,status:"pending",leaseOwner:null,leaseUntil:0,createdAt:this.now(),updatedAt:this.now()},l.put({key:d,value:m}),c.put(n)},f=l.get(d);f.onerror=()=>a(g(f,"Queue sequence read failed")),f.onsuccess=()=>{const p=f.result;if(p&&typeof p.value=="number"){s(p.value);return}const m=c.index("by_scope_seq").getAll(q(this.keyRange,t));m.onerror=()=>a(g(m,"Queue sequence migration failed")),m.onsuccess=()=>{const h=(m.result||[]).reduce((C,W)=>Math.max(C,W.seq||0),0);s(h)}},i.oncomplete=()=>u(n),i.onerror=()=>a(i.error||new Error("Queue enqueue transaction failed")),i.onabort=()=>a(i.error||new Error("Queue enqueue transaction aborted"))}):null)}claimReady(t,r,o){return this.open().then(u=>u?new Promise((a,i)=>{const l=u.transaction(b,"readwrite"),c=l.objectStore(b),d=c.index("by_scope_seq").getAll(q(this.keyRange,t)),n=this.now();let s={entries:[],wakeups:[]};d.onerror=()=>i(g(d,"Queue claim read failed")),d.onsuccess=()=>{s=xe(d.result||[],r,o,n);for(const f of s.entries)c.put(f)},l.oncomplete=()=>a(s),l.onerror=()=>i(l.error||new Error("Queue claim transaction failed")),l.onabort=()=>i(l.error||new Error("Queue claim transaction aborted"))}):{entries:[],wakeups:[]})}ack(t,r){return this._updateEntry(t,r,(o,u)=>(u.delete(o.entryId),{status:"acked",entry:o}))}nack(t,r,o,u){u=u||{};const a=u.maxAttempts||8,i=u.backoff||[2e3,5e3,15e3,6e4,3e5];return this.open().then(l=>l?new Promise((c,d)=>{const n=l.transaction([b,y],"readwrite"),s=n.objectStore(b),f=n.objectStore(y),p=s.get(r);let m=null;p.onerror=()=>d(g(p,"Queue nack read failed")),p.onsuccess=()=>{const h=p.result;if(!(!h||h.scope!==t)){if(o==="drop"){s.delete(h.entryId),m={status:"dropped",entry:h};return}if(j(h),h.updatedAt=this.now(),o==="auth"){h.status="pending",s.put(h),f.put({key:v(t),value:"auth"}),m={status:"auth",entry:h};return}if(o==="retry"){if(h.attempts=(h.attempts||0)+1,h.attempts>=a){h.status="failed",h.nextAttemptAt=0,s.put(h),m={status:"failed",entry:h};return}const C=i[Math.min(h.attempts-1,i.length-1)];h.status="pending",h.nextAttemptAt=this.now()+C,s.put(h),m={status:"retry",entry:h,delay:C}}}},n.oncomplete=()=>c(m),n.onerror=()=>d(n.error||new Error("Queue nack transaction failed")),n.onabort=()=>d(n.error||new Error("Queue nack transaction aborted"))}):null)}remap(t,r,o){return this._remapTransaction(t,null,r,o)}resolveCreate(t,r,o,u){return this._remapTransaction(t,r,o,u)}_remapTransaction(t,r,o,u){return this.open().then(a=>a?new Promise((i,l)=>{const c=a.transaction(b,"readwrite"),d=c.objectStore(b),n=d.index("by_scope_seq").getAll(q(this.keyRange,t));let s={changed:[],deleted:[]};n.onerror=()=>l(g(n,"Queue remap read failed")),n.onsuccess=()=>{s=Ae(n.result||[],r,o,u,this.now());for(const f of s.deleted)d.delete(f);for(const f of s.changed)d.put(f)},c.oncomplete=()=>i(s.changed),c.onerror=()=>l(c.error||new Error("Queue remap transaction failed")),c.onabort=()=>l(c.error||new Error("Queue remap transaction aborted"))}):[])}resetFailed(t){return this.open().then(r=>r?new Promise((o,u)=>{const a=r.transaction(b,"readwrite"),i=a.objectStore(b),l=i.index("by_scope_seq").getAll(q(this.keyRange,t));let c=0;l.onerror=()=>u(g(l,"Queue failed-entry read failed")),l.onsuccess=()=>{for(const d of l.result||[])d.status==="failed"&&(d.status="pending",d.attempts=0,d.nextAttemptAt=0,d.updatedAt=this.now(),j(d),i.put(d),c++)},a.oncomplete=()=>o(c),a.onerror=()=>u(a.error||new Error("Queue failed-entry reset failed")),a.onabort=()=>u(a.error||new Error("Queue failed-entry reset aborted"))}):0)}getPaused(t){return this.open().then(r=>r?new Promise((o,u)=>{const i=r.transaction(y,"readonly").objectStore(y).get(v(t));i.onsuccess=()=>{const l=i.result?i.result.value:!1;o(l||!1)},i.onerror=()=>u(g(i,"Queue pause-state read failed"))}):!1)}setPaused(t,r){return this.open().then(o=>{if(o)return new Promise((u,a)=>{const i=o.transaction(y,"readwrite"),l=typeof r=="string"?r:r?"manual":!1;i.objectStore(y).put({key:v(t),value:l}),i.oncomplete=()=>u(),i.onerror=()=>a(i.error||new Error("Queue pause-state write failed")),i.onabort=()=>a(i.error||new Error("Queue pause-state write aborted"))})})}clear(t){return this.open().then(r=>{if(r)return new Promise((o,u)=>{const a=r.transaction([b,y],"readwrite"),l=a.objectStore(b).index("by_scope_seq").openCursor(q(this.keyRange,t));l.onsuccess=c=>{const d=c.target.result;d&&(d.delete(),d.continue())},l.onerror=()=>u(g(l,"Queue clear failed")),a.objectStore(y).delete(V(t)),a.objectStore(y).delete(v(t)),a.oncomplete=()=>o(),a.onerror=()=>u(a.error||new Error("Queue clear transaction failed")),a.onabort=()=>u(a.error||new Error("Queue clear transaction aborted"))})})}_updateEntry(t,r,o){return this.open().then(u=>u?new Promise((a,i)=>{const l=u.transaction(b,"readwrite"),c=l.objectStore(b),d=c.get(r);let n=null;d.onerror=()=>i(g(d,"Queue entry read failed")),d.onsuccess=()=>{const s=d.result;!s||s.scope!==t||(n=o(s,c))},l.oncomplete=()=>a(n),l.onerror=()=>i(l.error||new Error("Queue entry transaction failed")),l.onabort=()=>i(l.error||new Error("Queue entry transaction aborted"))}):null)}}(function(){const e="data-ln-api-queue",t="lnApiQueue",r=[2e3,5e3,15e3,6e4,3e5],o=8,u=6e4;if(window[t]!==void 0)return;function a(n){const s=n[t];s&&s._drain()}const i={"data-ln-api-queue":{type:"marker",description:"Mounts offline API synchronization queue backed by IndexedDB"},"data-ln-api-queue-online":{effect:a,type:"enum",values:["true","false"],fallback:"auto",description:"Network connectivity override (true/false, or auto-detect from navigator.onLine)"}};function l(){try{return crypto.randomUUID()}catch{return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,s=>{const f=Math.random()*16|0;return(s==="x"?f:f&3|8).toString(16)})}}const c=new ve({indexedDB:window.indexedDB,IDBKeyRange:window.IDBKeyRange,uuid:l});function d(n){this.dom=n,n[t]=this;const s=n.closest("[data-ln-data-coordinator]");this.scope=n.id||(s?s.id:null)||"default",this._paused=!1,this._timers=new Map,this._workerId=l(),this._drainPromise=null,this._onlineHandler=()=>this._drain(),this._bindEvents(),window.addEventListener("online",this._onlineHandler);const f=this;return c.open().then(p=>p?c.getPaused(f.scope):(console.warn("[ln-api-queue] IndexedDB not available — queue disabled"),!1)).then(p=>{if(f._paused=!!p,f._paused){const m=typeof p=="string"?p:"auth";w(f.dom,"ln-api-queue:paused",{reason:m,restored:!0})}return f._emitPendingCount()}).then(()=>f._drain()).catch(p=>{console.error("[ln-api-queue] Initialization failed:",p),w(f.dom,"ln-api-queue:error",{operation:"initialize",error:p})}),this}d.prototype._isOnline=function(){const n=this.dom.getAttribute("data-ln-api-queue-online");return n==="true"?!0:n==="false"?!1:navigator.onLine},d.prototype._emitPendingCount=function(){const n=this;return c.allForScope(n.scope).then(s=>(w(n.dom,"ln-api-queue:pending-count",{count:s.length,scope:n.scope}),s.length===0&&w(n.dom,"ln-api-queue:drained",{scope:n.scope}),s))},d.prototype._clearTimer=function(n){const s=this._timers.get(n);s&&(clearTimeout(s),this._timers.delete(n))},d.prototype._scheduleTimer=function(n,s){const f=Math.max(0,s),p=this._timers.get(n);p&&clearTimeout(p);const m=this,h=setTimeout(()=>{m._timers.delete(n),m._drain()},f);this._timers.set(n,h)},d.prototype._drain=function(){const n=this;return n._paused||!n._isOnline()?Promise.resolve():(n._drainPromise||(n._drainPromise=c.claimReady(n.scope,n._workerId,u).then(s=>{for(const f of s.wakeups)n._scheduleTimer(f.chainKey,f.at-Date.now());for(const f of s.entries)n._clearTimer(f.chainKey),w(n.dom,"ln-api-queue:send",{entryId:f.entryId,chainKey:f.chainKey,op:f.op,targetId:f.targetId,payload:f.payload,expectedVersion:f.expectedVersion,idempotencyKey:f.entryId,meta:f.meta})}).catch(s=>{console.error("[ln-api-queue] Drain failed:",s),w(n.dom,"ln-api-queue:error",{operation:"drain",error:s})}).finally(()=>{n._drainPromise=null})),n._drainPromise)},d.prototype._onEnqueue=function(n){const s=this;return c.enqueue(s.scope,n.detail||{}).then(f=>{if(f)return s._emitPendingCount().then(p=>(w(s.dom,"ln-api-queue:enqueued",{entryId:f.entryId,chainKey:f.chainKey,count:p.length}),s._drain()))}).catch(f=>{w(s.dom,"ln-api-queue:error",{operation:"enqueue",error:f})})},d.prototype._onAck=function(n){const s=this,f=n.detail||{};return c.ack(s.scope,f.entryId).then(()=>s._emitPendingCount()).then(()=>s._drain()).catch(p=>{w(s.dom,"ln-api-queue:error",{operation:"ack",entryId:f.entryId,error:p})})},d.prototype._onNack=function(n){const s=this,f=n.detail||{};return c.nack(s.scope,f.entryId,f.reason,{maxAttempts:o,backoff:r}).then(p=>{if(p)return p.status==="failed"?w(s.dom,"ln-api-queue:failed",{entryId:p.entry.entryId,chainKey:p.entry.chainKey,attempts:p.entry.attempts}):p.status==="retry"?s._scheduleTimer(p.entry.chainKey,p.delay):p.status==="auth"&&(s._paused=!0,w(s.dom,"ln-api-queue:paused",{reason:"auth"}),w(s.dom,"ln-api-queue:auth-required",{entryId:p.entry.entryId,chainKey:p.entry.chainKey})),s._emitPendingCount().then(()=>{if(p.status==="dropped")return s._drain()})}).catch(p=>{w(s.dom,"ln-api-queue:error",{operation:"nack",entryId:f.entryId,error:p})})},d.prototype._onRemap=function(n){const s=this,f=n.detail||{};return c.remap(s.scope,f.oldKey,f.newId).catch(p=>{w(s.dom,"ln-api-queue:error",{operation:"remap",error:p})})},d.prototype._onResolveCreate=function(n){const s=this,f=n.detail||{};return c.resolveCreate(s.scope,f.entryId,f.oldKey,f.newId).then(()=>s._emitPendingCount()).then(()=>s._drain()).catch(p=>{w(s.dom,"ln-api-queue:error",{operation:"resolve-create",entryId:f.entryId,error:p})})},d.prototype._onResume=function(){const n=this;return c.setPaused(n.scope,!1).then(()=>(n._paused=!1,w(n.dom,"ln-api-queue:resumed",{}),n._drain())).catch(s=>{w(n.dom,"ln-api-queue:error",{operation:"resume",error:s})})},d.prototype._onPause=function(){const n=this;return c.setPaused(n.scope,"manual").then(()=>{n._paused=!0,w(n.dom,"ln-api-queue:paused",{reason:"manual"})}).catch(s=>{w(n.dom,"ln-api-queue:error",{operation:"pause",error:s})})},d.prototype._onDrain=function(){const n=this;return c.resetFailed(n.scope).then(()=>{const s=n._drainPromise;return s?s.then(()=>n._drain()):n._drain()}).catch(s=>{w(n.dom,"ln-api-queue:error",{operation:"manual-drain",error:s})})},d.prototype._onClear=function(){const n=this;return n._timers.forEach(s=>clearTimeout(s)),n._timers.clear(),c.clear(n.scope).then(()=>{n._paused=!1,w(n.dom,"ln-api-queue:pending-count",{count:0,scope:n.scope}),w(n.dom,"ln-api-queue:drained",{scope:n.scope})}).catch(s=>{w(n.dom,"ln-api-queue:error",{operation:"clear",error:s})})},d.prototype._bindEvents=function(){const n=this;n._handlers={enqueue:s=>n._onEnqueue(s),ack:s=>n._onAck(s),nack:s=>n._onNack(s),remap:s=>n._onRemap(s),resolveCreate:s=>n._onResolveCreate(s),resume:()=>n._onResume(),pause:()=>n._onPause(),drain:()=>n._onDrain(),clear:()=>n._onClear()},n.dom.addEventListener("ln-api-queue:request-enqueue",n._handlers.enqueue),n.dom.addEventListener("ln-api-queue:ack",n._handlers.ack),n.dom.addEventListener("ln-api-queue:nack",n._handlers.nack),n.dom.addEventListener("ln-api-queue:request-remap",n._handlers.remap),n.dom.addEventListener("ln-api-queue:resolve-create",n._handlers.resolveCreate),n.dom.addEventListener("ln-api-queue:request-resume",n._handlers.resume),n.dom.addEventListener("ln-api-queue:request-pause",n._handlers.pause),n.dom.addEventListener("ln-api-queue:request-drain",n._handlers.drain),n.dom.addEventListener("ln-api-queue:request-clear",n._handlers.clear)},d.prototype.destroy=function(){if(!this.dom[t])return;const n=this;n.dom.removeEventListener("ln-api-queue:request-enqueue",n._handlers.enqueue),n.dom.removeEventListener("ln-api-queue:ack",n._handlers.ack),n.dom.removeEventListener("ln-api-queue:nack",n._handlers.nack),n.dom.removeEventListener("ln-api-queue:request-remap",n._handlers.remap),n.dom.removeEventListener("ln-api-queue:resolve-create",n._handlers.resolveCreate),n.dom.removeEventListener("ln-api-queue:request-resume",n._handlers.resume),n.dom.removeEventListener("ln-api-queue:request-pause",n._handlers.pause),n.dom.removeEventListener("ln-api-queue:request-drain",n._handlers.drain),n.dom.removeEventListener("ln-api-queue:request-clear",n._handlers.clear),window.removeEventListener("online",n._onlineHandler),n._timers.forEach(s=>clearTimeout(s)),n._timers.clear(),delete n.dom[t]},de(e,t,d,"ln-api-queue",{attributes:i})})()})();

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

@@ -0,0 +1,34 @@
+{
+	"$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-queue",
+	"generator": "scripts/sync-ln-schemas.mjs",
+	"attributes": {
+		"data-ln-api-queue": {
+			"direction": null,
+			"sources": [
+				"src/ln-api-queue.js"
+			],
+			"type": "marker",
+			"description": "Mounts offline API synchronization queue backed by IndexedDB"
+		},
+		"data-ln-api-queue-online": {
+			"direction": "author",
+			"sources": [
+				"src/ln-api-queue.js"
+			],
+			"type": "enum",
+			"values": [
+				"true",
+				"false"
+			],
+			"fallback": "auto",
+			"description": "Network connectivity override (true/false, or auto-detect from navigator.onLine)"
+		},
+		"data-ln-data-coordinator": {
+			"direction": "author",
+			"sources": [
+				"src/ln-api-queue.js"
+			]
+		}
+	}
+}