@sylwellsoftware/glue 0.8.0 → 0.9.0

package/dist/index.js

@@ -1,7 +1,7 @@
-var H = Object.defineProperty;
-var F = (t, r, e) => r in t ? H(t, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : t[r] = e;
-var n = (t, r, e) => F(t, typeof r != "symbol" ? r + "" : r, e);
-let x = 1;
+var U = Object.defineProperty;
+var H = (t, r, e) => r in t ? U(t, r, { enumerable: !0, configurable: !0, writable: !0, value: e }) : t[r] = e;
+var n = (t, r, e) => H(t, typeof r != "symbol" ? r + "" : r, e);
+let F = 1;
 class b {
   constructor(r = {}) {
     n(this, "id");
@@ -18,9 +18,9 @@ class b {
     var s;
     if (r == null || typeof r != "object" || Array.isArray(r))
       throw new TypeError("EventBubble options must be an object");
-    this.id = `event-${x++}`, this.timestamp = r.timestamp ?? Date.now(), this.purpose = r.purpose ?? "unspecified", this.cause = r.cause ?? null, this.value = r.value, this.parent = r.parent ?? null, this.parentBubble = this.parent;
+    this.id = `event-${F++}`, this.timestamp = r.timestamp ?? Date.now(), this.purpose = r.purpose ?? "unspecified", this.cause = r.cause ?? null, this.value = r.value, this.parent = r.parent ?? null, this.parentBubble = this.parent;
     const e = r.owner;
-    this.ownerType = e == null ? null : $(e) ?? typeof e, B(e) && typeof WeakRef == "function" ? (this.ownerRef = new WeakRef(e), this.strongOwner = void 0) : (this.ownerRef = null, this.strongOwner = e), (s = this.parent) == null || s.registerChild(this);
+    this.ownerType = e == null ? null : _(e) ?? typeof e, B(e) && typeof WeakRef == "function" ? (this.ownerRef = new WeakRef(e), this.strongOwner = void 0) : (this.ownerRef = null, this.strongOwner = e), (s = this.parent) == null || s.registerChild(this);
   }
   get owner() {
     var r;
@@ -35,7 +35,7 @@ class b {
 function B(t) {
   return typeof t == "object" && t !== null || typeof t == "function";
 }
-function $(t) {
+function _(t) {
   const r = Reflect.get(t, "constructor");
   if (r == null || typeof r != "object" && typeof r != "function")
     return;
@@ -70,23 +70,23 @@ const w = Object.freeze({
   get subscriberCount() {
     return m.size;
   }
-}), h = Object.freeze({
+}), a = Object.freeze({
   Error: "error",
   Loading: "loading",
   Initial: "initial",
   Ready: "ready"
 }), S = /* @__PURE__ */ new Map([
-  [h.Ready, 1],
-  [h.Initial, 2],
-  [h.Loading, 3],
-  [h.Error, 4]
+  [a.Ready, 1],
+  [a.Initial, 2],
+  [a.Loading, 3],
+  [a.Error, 4]
 ]);
-function j(t) {
-  let r = h.Ready;
+function T(t) {
+  let r = a.Ready;
   for (const e of t) {
     if (!S.has(e))
       throw new TypeError(`Unknown fetch state: ${String(e)}`);
-    if ((S.get(e) ?? 0) > (S.get(r) ?? 0) && (r = e), r === h.Error) break;
+    if ((S.get(e) ?? 0) > (S.get(r) ?? 0) && (r = e), r === a.Error) break;
   }
   return r;
 }
@@ -103,7 +103,7 @@ class g {
     n(this, "trace");
     if (e == null || typeof e != "object" || Array.isArray(e))
       throw new TypeError("Emitter options must be an object");
-    if (this.value = r, this.fetchState = e.fetchState ?? h.Ready, this.error = e.error ?? null, this.equals = e.equals ?? Object.is, this.owner = e.owner, this.purpose = e.purpose ?? this.constructor.name, this.trace = e.trace ?? !1, typeof this.equals != "function")
+    if (this.value = r, this.fetchState = e.fetchState ?? a.Ready, this.error = e.error ?? null, this.equals = e.equals ?? Object.is, this.owner = e.owner, this.purpose = e.purpose ?? this.constructor.name, this.trace = e.trace ?? !1, typeof this.equals != "function")
       throw new TypeError("Emitter equals option must be a function");
     R(this.fetchState);
   }
@@ -113,14 +113,14 @@ class g {
       throw new TypeError("subscribe requires a function");
     if (e == null || typeof e != "object" || Array.isArray(e))
       throw new TypeError("subscribe options must be an object");
-    const { emitCurrent: s = !0, parentEvent: i = null } = e;
+    const { emitCurrent: s = !0, parentEvent: o = null } = e;
     if (this.subscribers.add(r), s) {
-      const u = this.createEvent("subscribed", i, this.value);
-      r(this.notification(u));
+      const c = this.createEvent("subscribed", o, this.value);
+      r(this.notification(c));
     }
-    let o = !0;
+    let i = !0;
     return () => {
-      o && (o = !1, this.subscribers.delete(r));
+      i && (i = !1, this.subscribers.delete(r));
     };
   }
   subscribeFutureValues(r) {
@@ -143,7 +143,7 @@ class g {
   }
   map(r, e = {}) {
     if (typeof r != "function") throw new TypeError("map requires a function");
-    return new D(
+    return new x(
       [this],
       ([s]) => r(s),
       {
@@ -156,11 +156,11 @@ class g {
   }
   mapEach(r, e = {}) {
     if (typeof r != "function") throw new TypeError("mapEach requires a function");
-    return new D([this], ([s]) => {
+    return new x([this], ([s]) => {
       if (s == null) return s;
       if (!Array.isArray(s))
         throw new TypeError("mapEach source value must be an array");
-      return s.map((o, u) => o == null ? o : r(o, u));
+      return s.map((i, c) => i == null ? i : r(i, c));
     }, {
       ...e,
       purpose: e.purpose ?? `${this.purpose}:mapEach`
@@ -184,47 +184,47 @@ class g {
   }
   setSnapshot(r = {}) {
     if (this.isDisposed) return !1;
-    const e = Object.hasOwn(r, "value") ? r.value : this.value, s = r.fetchState ?? this.fetchState, i = Object.hasOwn(r, "error") ? r.error : this.error, o = r.cause ?? "state changed", u = r.parentEvent ?? null;
-    if (R(s), !(!this.equals(this.value, e) || this.fetchState !== s || !Object.is(this.error, i))) return !1;
-    this.value = e, this.fetchState = s, this.error = i;
-    const c = this.createEvent(o, u, e);
-    return this.notify(c), !0;
+    const e = Object.hasOwn(r, "value") ? r.value : this.value, s = r.fetchState ?? this.fetchState, o = Object.hasOwn(r, "error") ? r.error : this.error, i = r.cause ?? "state changed", c = r.parentEvent ?? null;
+    if (R(s), !(!this.equals(this.value, e) || this.fetchState !== s || !Object.is(this.error, o))) return !1;
+    this.value = e, this.fetchState = s, this.error = o;
+    const u = this.createEvent(i, c, e);
+    return this.notify(u), !0;
   }
   createEvent(r, e = null, s = this.value) {
     if (!this.trace && !e && !w.hasSubscribers) return null;
-    const i = new b({
+    const o = new b({
       owner: this.owner ?? this,
       purpose: this.purpose,
       value: s,
       cause: r,
       parent: e
     });
-    return e || w.emit(i), i;
+    return e || w.emit(o), o;
   }
 }
-class D extends g {
-  constructor(e, s, i = {}) {
-    const { computeFetchState: o = j, ...u } = i;
+class x extends g {
+  constructor(e, s, o = {}) {
+    const { computeFetchState: i = T, ...c } = o;
     super(void 0, {
-      ...u,
-      fetchState: h.Initial,
+      ...c,
+      fetchState: a.Initial,
       error: null
     });
     n(this, "sources");
     n(this, "sourceUnsubscribers", []);
     n(this, "compute");
     n(this, "computeFetchState");
-    this.sources = [], this.compute = s, this.computeFetchState = o, this.setSourcesAndCompute(e, s, { notify: !1 });
+    this.sources = [], this.compute = s, this.computeFetchState = i, this.setSourcesAndCompute(e, s, { notify: !1 });
   }
-  setSourcesAndCompute(e, s = this.compute, i = {}) {
+  setSourcesAndCompute(e, s = this.compute, o = {}) {
     if (this.isDisposed) throw new Error("Cannot update a disposed derived emitter");
-    if (!Array.isArray(e) || e.some((o) => !k(o)))
+    if (!Array.isArray(e) || e.some((i) => !k(i)))
       throw new TypeError("DerivedEmitter sources must be an array of emitters");
     if (typeof s != "function")
       throw new TypeError("DerivedEmitter compute must be a function");
     return this.releaseSources(), this.sources = [...e], this.compute = s, this.sourceUnsubscribers = this.sources.map(
-      (o) => o.subscribe(({ event: u }) => this.recompute(u), { emitCurrent: !1 })
-    ), this.recompute(i.parentEvent ?? null, i.notify ?? !0), this;
+      (i) => i.subscribe(({ event: c }) => this.recompute(c), { emitCurrent: !1 })
+    ), this.recompute(o.parentEvent ?? null, o.notify ?? !0), this;
   }
   dispose() {
     this.isDisposed || (this.releaseSources(), super.dispose());
@@ -234,21 +234,21 @@ class D extends g {
     this.sourceUnsubscribers = [];
   }
   recompute(e = null, s = !0) {
-    const i = this.sources.map((d) => d.get()), o = this.sources.map((d) => d.getFetchState()), u = this.sources.map((d, v) => ({ sourceIndex: v, error: d.getError() })).filter((d) => d.error != null);
-    let a, c = null;
+    const o = this.sources.map((d) => d.get()), i = this.sources.map((d) => d.getFetchState()), c = this.sources.map((d, v) => ({ sourceIndex: v, error: d.getError() })).filter((d) => d.error != null);
+    let f, u = null;
     try {
-      a = this.compute(i);
+      f = this.compute(o);
     } catch (d) {
-      c = d, a = void 0;
+      u = d, f = void 0;
     }
-    const f = c == null ? u : [...u, { sourceIndex: null, error: c }], p = _(this.error, f);
-    let l = this.computeFetchState(o);
-    if (R(l), (c != null || u.length > 0) && (l = h.Error), !s) {
-      this.value = a, this.fetchState = l, this.error = p;
+    const h = u == null ? c : [...c, { sourceIndex: null, error: u }], p = $(this.error, h);
+    let l = this.computeFetchState(i);
+    if (R(l), (u != null || c.length > 0) && (l = a.Error), !s) {
+      this.value = f, this.fetchState = l, this.error = p;
       return;
     }
     this.setSnapshot({
-      value: a,
+      value: f,
       fetchState: l,
       error: p,
       cause: "derived source changed",
@@ -256,28 +256,28 @@ class D extends g {
     });
   }
 }
-function _(t, r) {
+function $(t, r) {
   return r.length === 0 ? null : t != null && t.length === r.length && t.every((e, s) => {
-    var i, o;
-    return e.sourceIndex === ((i = r[s]) == null ? void 0 : i.sourceIndex) && Object.is(e.error, (o = r[s]) == null ? void 0 : o.error);
+    var o, i;
+    return e.sourceIndex === ((o = r[s]) == null ? void 0 : o.sourceIndex) && Object.is(e.error, (i = r[s]) == null ? void 0 : i.error);
   }) ? t : Object.freeze(r.map((e) => Object.freeze(e)));
 }
 function k(t) {
   return (typeof t != "object" || t === null) && typeof t != "function" ? !1 : typeof Reflect.get(t, "get") == "function" && typeof Reflect.get(t, "getFetchState") == "function" && typeof Reflect.get(t, "getError") == "function" && typeof Reflect.get(t, "subscribe") == "function";
 }
 function R(t) {
-  j([t]);
+  T([t]);
 }
-class U extends g {
+class z extends g {
   constructor(r, e = {}) {
     super(r, e);
   }
-  setWithState(r, e = h.Ready, s = null, i = null) {
-    const o = i instanceof b ? i : null, u = o ? "set called" : i ?? "set called";
-    return this.setSnapshot({ value: r, fetchState: e, error: s, cause: u, parentEvent: o });
+  setWithState(r, e = a.Ready, s = null, o = null) {
+    const i = o instanceof b ? o : null, c = i ? "set called" : o ?? "set called";
+    return this.setSnapshot({ value: r, fetchState: e, error: s, cause: c, parentEvent: i });
   }
   set(r, e = null) {
-    return this.setWithState(r, h.Ready, null, e);
+    return this.setWithState(r, a.Ready, null, e);
   }
 }
 class M extends Error {
@@ -285,25 +285,25 @@ class M extends Error {
     super("AsyncCommand is already running"), this.name = "AsyncCommandConcurrencyError";
   }
 }
-class fe extends g {
+class pe extends g {
   constructor(e) {
     N(e);
     const {
       execute: s,
-      concurrency: i = "ignore",
-      mapError: o = (f) => f,
-      owner: u,
-      purpose: a = "async command",
-      trace: c
+      concurrency: o = "ignore",
+      mapError: i = (h) => h,
+      owner: c,
+      purpose: f = "async command",
+      trace: u
     } = e;
-    if (W(i), typeof o != "function")
+    if (W(o), typeof i != "function")
       throw new TypeError("AsyncCommand mapError must be a function");
     super(void 0, {
-      fetchState: h.Initial,
+      fetchState: a.Initial,
       error: null,
-      owner: u,
-      purpose: a,
-      ...c === void 0 ? {} : { trace: c }
+      owner: c,
+      purpose: f,
+      ...u === void 0 ? {} : { trace: u }
     });
     n(this, "execute");
     n(this, "concurrency");
@@ -316,10 +316,10 @@ class fe extends g {
     n(this, "hasSuccessfulValue", !1);
     /** Exposed for deterministic tests; consumers should use run()/abort(). */
     n(this, "_activeRequest", null);
-    this.execute = s, this.concurrency = i, this.mapError = o, this.runningEmitter = new U(!1, {
-      owner: u ?? this,
-      purpose: `${a}:running`,
-      ...c === void 0 ? {} : { trace: c }
+    this.execute = s, this.concurrency = o, this.mapError = i, this.runningEmitter = new z(!1, {
+      owner: c ?? this,
+      purpose: `${f}:running`,
+      ...u === void 0 ? {} : { trace: u }
     }), this.isRunning = this.runningEmitter;
   }
   run(e, s = "command run") {
@@ -331,51 +331,51 @@ class fe extends g {
         return Promise.reject(new M());
       (p = this.abortController) == null || p.abort();
     }
-    const i = ++this.requestId, o = G();
-    this.abortController = o;
-    const u = s instanceof b ? s : null, a = u ? "parent command requested" : s;
+    const o = ++this.requestId, i = G();
+    this.abortController = i;
+    const c = s instanceof b ? s : null, f = c ? "parent command requested" : s;
     this.setSnapshot({
       value: this.lastSuccessfulValue,
-      fetchState: h.Loading,
+      fetchState: a.Loading,
       error: null,
-      cause: a,
-      parentEvent: u
+      cause: f,
+      parentEvent: c
     });
-    const c = this.createEvent("command execute", u, e);
-    this.runningEmitter.set(!0, c ?? a);
-    const f = Promise.resolve().then(() => this.execute(e, {
-      signal: o.signal,
-      event: c
+    const u = this.createEvent("command execute", c, e);
+    this.runningEmitter.set(!0, u ?? f);
+    const h = Promise.resolve().then(() => this.execute(e, {
+      signal: i.signal,
+      event: u
     })).then((l) => {
-      if (this.isCurrentRequest(i, o))
+      if (this.isCurrentRequest(o, i))
         return this.lastSuccessfulValue = l, this.hasSuccessfulValue = !0, this.setSnapshot({
           value: l,
-          fetchState: h.Ready,
+          fetchState: a.Ready,
           error: null,
           cause: "command succeeded",
-          parentEvent: c
+          parentEvent: u
         }), l;
     }).catch((l) => {
-      this.isCurrentRequest(i, o) && this.setSnapshot({
+      this.isCurrentRequest(o, i) && this.setSnapshot({
         value: this.lastSuccessfulValue,
-        fetchState: h.Error,
+        fetchState: a.Error,
         error: this.mapCommandError(l),
         cause: "command failed",
-        parentEvent: c
+        parentEvent: u
       });
     }).finally(() => {
-      this.isCurrentRequest(i, o) && (this.abortController = null, this._activeRequest = null, this.runningEmitter.set(!1, c ?? "command settled"));
+      this.isCurrentRequest(o, i) && (this.abortController = null, this._activeRequest = null, this.runningEmitter.set(!1, u ?? "command settled"));
     });
-    return this._activeRequest = f, f;
+    return this._activeRequest = h, h;
   }
   abort(e = "command aborted") {
     if (this.isDisposed || this.abortController == null) return !1;
-    const s = e instanceof b ? e : null, i = s ? "parent command aborted" : e;
-    return this.requestId += 1, this.abortController.abort(), this.abortController = null, this._activeRequest = null, this.runningEmitter.set(!1, s ?? i), this.setSnapshot({
+    const s = e instanceof b ? e : null, o = s ? "parent command aborted" : e;
+    return this.requestId += 1, this.abortController.abort(), this.abortController = null, this._activeRequest = null, this.runningEmitter.set(!1, s ?? o), this.setSnapshot({
       value: this.lastSuccessfulValue,
-      fetchState: this.hasSuccessfulValue ? h.Ready : h.Initial,
+      fetchState: this.hasSuccessfulValue ? a.Ready : a.Initial,
       error: null,
-      cause: i,
+      cause: o,
       parentEvent: s
     }), !0;
   }
@@ -385,7 +385,7 @@ class fe extends g {
     const s = e instanceof b ? e : null;
     this.setSnapshot({
       value: void 0,
-      fetchState: h.Initial,
+      fetchState: a.Initial,
       error: null,
       cause: s ? "parent command reset" : e,
       parentEvent: s
@@ -422,36 +422,40 @@ function G() {
     throw new Error("AsyncCommand requires AbortController in this runtime");
   return new t();
 }
-class I extends g {
+class D extends g {
   constructor(e) {
     if (e == null || typeof e != "object" || Array.isArray(e))
       throw new TypeError("LiveQuery options must be an object");
     const {
       handler: s,
-      args: i = {},
-      autoFetch: o = !0,
-      keepPreviousValue: u = !0,
-      polling: a,
-      owner: c,
-      purpose: f = "live query",
-      trace: p
+      args: o = {},
+      execution: i,
+      autoFetch: c = !0,
+      keepPreviousValue: f = !0,
+      polling: u,
+      owner: h,
+      purpose: p = "live query",
+      trace: l
     } = e;
     if (s == null || typeof s.fetch != "function")
       throw new TypeError("LiveQuery handler must implement fetch()");
-    X(i), a != null && K(a);
+    Y(o), u != null && K(u), X(i, e.autoFetch, u);
     super(void 0, {
-      fetchState: h.Initial,
+      fetchState: a.Initial,
       error: null,
-      owner: c,
-      purpose: f,
-      ...p === void 0 ? {} : { trace: p }
+      owner: h,
+      purpose: p,
+      ...l === void 0 ? {} : { trace: l }
     });
     n(this, "handler");
     n(this, "args");
     n(this, "keepPreviousValue");
+    n(this, "execution");
     n(this, "lastSuccessfulValue");
     n(this, "hasSuccessfulValue", !1);
-    n(this, "argumentUnsubscribers");
+    n(this, "automaticTriggersInitialized", !1);
+    n(this, "activated");
+    n(this, "argumentUnsubscribers", []);
     n(this, "pollingUnsubscribers", []);
     n(this, "polling");
     n(this, "pollingScheduler");
@@ -460,56 +464,68 @@ class I extends g {
     n(this, "abortController", null);
     /** Exposed for deterministic tests; consumers should use refresh()/retry(). */
     n(this, "_activeRequest", null);
-    this.handler = s, this.args = { ...i }, this.keepPreviousValue = u, this.polling = a, this.pollingScheduler = (a == null ? void 0 : a.scheduler) ?? J, this.lastSuccessfulValue = void 0, this.argumentUnsubscribers = Object.values(this.args).map(
-      (l) => l.subscribe(({ event: d }) => {
-        this.refresh(d);
-      }, { emitCurrent: !1 })
-    ), a != null && this.initializePolling(a), o && (this._activeRequest = this.refresh("initial fetch")), this.scheduleNextPoll();
+    this.handler = s, this.args = { ...o }, this.keepPreviousValue = f, this.execution = i ?? null, this.activated = i !== "deferred", this.polling = u, this.pollingScheduler = (u == null ? void 0 : u.scheduler) ?? J, this.lastSuccessfulValue = void 0, i !== "deferred" && i !== "explicit" && this.initializeAutomaticTriggers(), (i === "immediate" || i == null && c) && (this._activeRequest = this.executeRequest("initial fetch")), this.scheduleNextPoll();
   }
   get argumentValues() {
     return Object.fromEntries(
       Object.entries(this.args).map(([e, s]) => [e, s.get()])
     );
   }
+  /**
+   * Activates a deferred query exactly once. Concurrent callers share the
+   * first request; later calls return the current value without reloading.
+   */
+  activate(e = "query activated") {
+    if (this.isDisposed) return Promise.resolve(void 0);
+    if (this.execution === "explicit")
+      return Promise.reject(new Error("Explicit LiveQuery execution cannot be activated"));
+    if (this.activated)
+      return this._activeRequest ?? Promise.resolve(this.get());
+    this.activated = !0, this.initializeAutomaticTriggers();
+    const s = this.executeRequest(e);
+    return this.scheduleNextPoll(), s;
+  }
   refresh(e = "refresh") {
+    return this.isDisposed ? Promise.resolve(void 0) : this.activated ? this.executeRequest(e) : this.activate(e);
+  }
+  executeRequest(e) {
     var p;
-    if (this.isDisposed) return Promise.resolve(void 0);
     const s = ++this.requestId;
     (p = this.abortController) == null || p.abort();
-    const i = Y();
-    this.abortController = i;
-    const o = e instanceof b ? e : null, u = o ? "query arguments changed" : e, a = this.keepPreviousValue ? this.lastSuccessfulValue : void 0;
+    const o = Z();
+    this.abortController = o;
+    const i = e instanceof b ? e : null, c = i ? "query arguments changed" : e, f = this.keepPreviousValue ? this.lastSuccessfulValue : void 0;
     this.setSnapshot({
-      value: a,
-      fetchState: h.Loading,
+      value: f,
+      fetchState: a.Loading,
       error: null,
-      cause: u,
-      parentEvent: o
+      cause: c,
+      parentEvent: i
     });
-    const c = this.createEvent("query fetch", o, this.argumentValues), f = Promise.resolve().then(() => this.handler.fetch(this.argumentValues, {
-      signal: i.signal,
-      event: c
+    const u = this.createEvent("query fetch", i, this.argumentValues), h = Promise.resolve().then(() => this.handler.fetch(this.argumentValues, {
+      signal: o.signal,
+      event: u
     })).then((l) => {
-      if (this.isCurrentRequest(s, i))
+      if (this.isCurrentRequest(s, o))
         return this.lastSuccessfulValue = l, this.hasSuccessfulValue = !0, this.setSnapshot({
           value: l,
-          fetchState: h.Ready,
+          fetchState: a.Ready,
           error: null,
           cause: "query succeeded",
-          parentEvent: c
+          parentEvent: u
         }), l;
     }).catch((l) => {
-      !this.isCurrentRequest(s, i) || Z(l) || this.setSnapshot({
+      !this.isCurrentRequest(s, o) || ee(l) || this.setSnapshot({
         value: this.keepPreviousValue ? this.lastSuccessfulValue : void 0,
-        fetchState: h.Error,
+        fetchState: a.Error,
         error: l,
         cause: "query failed",
-        parentEvent: c
+        parentEvent: u
       });
     }).finally(() => {
-      this.isCurrentRequest(s, i) && (this.abortController = null, this._activeRequest = null);
+      this.isCurrentRequest(s, o) && (this.abortController = null, this._activeRequest = null);
     });
-    return this._activeRequest = f, f;
+    return this._activeRequest = h, h;
   }
   retry(e = "retry") {
     return this.refresh(e);
@@ -520,7 +536,7 @@ class I extends g {
     const s = e instanceof b ? e : null;
     this.setSnapshot({
       value: this.hasSuccessfulValue ? this.lastSuccessfulValue : void 0,
-      fetchState: this.hasSuccessfulValue ? h.Ready : h.Initial,
+      fetchState: this.hasSuccessfulValue ? a.Ready : a.Initial,
       error: null,
       cause: s == null ? e : "query aborted",
       parentEvent: s
@@ -536,14 +552,21 @@ class I extends g {
       this.pollingUnsubscribers = [], super.dispose();
     }
   }
+  initializeAutomaticTriggers() {
+    this.automaticTriggersInitialized || this.execution === "explicit" || (this.automaticTriggersInitialized = !0, this.argumentUnsubscribers = Object.values(this.args).map(
+      (e) => e.subscribe(({ event: s }) => {
+        this.refresh(s);
+      }, { emitCurrent: !1 })
+    ), this.polling != null && this.initializePolling(this.polling));
+  }
   initializePolling(e) {
     for (const s of [e.intervalMs, e.enabled])
-      T(s) && this.pollingUnsubscribers.push(s.subscribe(() => {
+      j(s) && this.pollingUnsubscribers.push(s.subscribe(() => {
         q(y(e.intervalMs)), Q(y(e.enabled, !0)), this.cancelScheduledPoll(), this.scheduleNextPoll();
       }, { emitCurrent: !1 }));
   }
   scheduleNextPoll() {
-    if (this.isDisposed || this.polling == null || this.pollingHandle != null || !y(this.polling.enabled, !0)) return;
+    if (this.isDisposed || !this.automaticTriggersInitialized || this.polling == null || this.pollingHandle != null || !y(this.polling.enabled, !0)) return;
     const e = y(this.polling.intervalMs);
     q(e), this.pollingHandle = this.pollingScheduler.schedule(() => {
       this.pollingHandle = null, this.scheduleNextPoll(), this._activeRequest == null && this.refresh("poll");
@@ -568,21 +591,29 @@ const J = {
     typeof r == "function" && Reflect.apply(r, globalThis, [t]);
   }
 };
-function T(t) {
+function j(t) {
   return t != null && (typeof t == "object" || typeof t == "function") && typeof Reflect.get(t, "get") == "function" && typeof Reflect.get(t, "subscribe") == "function";
 }
-function O(t, r) {
-  if (typeof t != "number" && typeof t != "boolean" && !T(t))
+function I(t, r) {
+  if (typeof t != "number" && typeof t != "boolean" && !j(t))
     throw new TypeError(`LiveQuery polling ${r} must be a value or emitter`);
 }
 function K(t) {
   if (t == null || typeof t != "object" || Array.isArray(t))
     throw new TypeError("LiveQuery polling options must be an object");
-  if (O(t.intervalMs, "intervalMs"), t.enabled !== void 0 && O(t.enabled, "enabled"), q(y(t.intervalMs)), Q(y(t.enabled, !0)), t.scheduler != null && (typeof t.scheduler.schedule != "function" || typeof t.scheduler.cancel != "function"))
+  if (I(t.intervalMs, "intervalMs"), t.enabled !== void 0 && I(t.enabled, "enabled"), q(y(t.intervalMs)), Q(y(t.enabled, !0)), t.scheduler != null && (typeof t.scheduler.schedule != "function" || typeof t.scheduler.cancel != "function"))
     throw new TypeError("LiveQuery polling scheduler must implement schedule() and cancel()");
 }
+function X(t, r, e) {
+  if (t !== void 0 && t !== "immediate" && t !== "deferred" && t !== "explicit")
+    throw new TypeError("LiveQuery execution must be immediate, deferred, or explicit");
+  if (t !== void 0 && r !== void 0)
+    throw new TypeError("LiveQuery execution and autoFetch are mutually exclusive");
+  if (t === "explicit" && e !== void 0)
+    throw new TypeError("Explicit LiveQuery execution does not support polling");
+}
 function y(t, r) {
-  return t === void 0 ? r : T(t) ? t.get() : t;
+  return t === void 0 ? r : j(t) ? t.get() : t;
 }
 function q(t) {
   if (!Number.isFinite(t) || t <= 0)
@@ -592,42 +623,42 @@ function Q(t) {
   if (typeof t != "boolean")
     throw new TypeError("LiveQuery polling enabled must be a boolean");
 }
-function X(t) {
+function Y(t) {
   if (t == null || typeof t != "object" || Array.isArray(t))
     throw new TypeError("LiveQuery args must be a named record of emitters");
   for (const [r, e] of Object.entries(t))
     if (e == null || typeof Reflect.get(e, "get") != "function" || typeof Reflect.get(e, "subscribe") != "function")
       throw new TypeError(`LiveQuery argument ${r} must be an emitter`);
 }
-function Y() {
+function Z() {
   const t = Reflect.get(globalThis, "AbortController");
   if (typeof t != "function")
     throw new Error("LiveQuery requires AbortController in this runtime");
   return new t();
 }
-function Z(t) {
+function ee(t) {
   return t instanceof Error && t.name === "AbortError";
 }
-class pe extends U {
-  constructor(e, s, i = {}) {
+class de extends z {
+  constructor(e, s, o = {}) {
     if (typeof e != "string" || e.length === 0)
       throw new TypeError("QueryArg name must be a non-empty string");
     if (s == null || typeof s.get != "function" || typeof s.subscribe != "function")
       throw new TypeError("QueryArg source must be an emitter");
     super(s.get(), {
-      ...i,
+      ...o,
       fetchState: s.getFetchState(),
       error: s.getError(),
-      purpose: i.purpose ?? `query argument: ${e}`
+      purpose: o.purpose ?? `query argument: ${e}`
     });
     n(this, "name");
     n(this, "sourceUnsubscribe");
-    this.name = e, this.sourceUnsubscribe = s.subscribe((o) => {
+    this.name = e, this.sourceUnsubscribe = s.subscribe((i) => {
       this.setWithState(
-        o.value,
-        o.fetchState,
-        o.error,
-        o.event
+        i.value,
+        i.fetchState,
+        i.error,
+        i.event
       );
     }, { emitCurrent: !1 });
   }
@@ -636,19 +667,19 @@ class pe extends U {
     this.isDisposed || ((e = this.sourceUnsubscribe) == null || e.call(this), this.sourceUnsubscribe = null, super.dispose());
   }
 }
-class ee {
+class te {
   fetch(r, e = {}) {
     throw new Error("fetch() must be implemented");
   }
 }
-class te extends Error {
+class re extends Error {
   constructor(e) {
     super(`HTTP ${e ?? "unknown"}`);
     n(this, "status");
     this.name = "HttpError", this.status = e;
   }
 }
-class re extends ee {
+class se extends te {
   constructor(e) {
     super();
     n(this, "url");
@@ -662,7 +693,7 @@ class re extends ee {
       throw new TypeError("RestQueryHandler requires a URL or options object");
     if (typeof s.url != "string" || s.url.length === 0)
       throw new TypeError("RestQueryHandler url must be a non-empty string");
-    if (this.url = s.url, this.baseUrl = s.baseUrl ?? ie(), this.fetchImplementation = s.fetch ?? oe(), this.serialize = s.serialize ?? se, this.parseResult = s.parseResult, this.trace = s.trace ?? !1, typeof this.fetchImplementation != "function")
+    if (this.url = s.url, this.baseUrl = s.baseUrl ?? oe(), this.fetchImplementation = s.fetch ?? ue(), this.serialize = s.serialize ?? ne, this.parseResult = s.parseResult, this.trace = s.trace ?? !1, typeof this.fetchImplementation != "function")
       throw new TypeError("RestQueryHandler requires an injected fetch implementation");
     if (typeof this.serialize != "function")
       throw new TypeError("RestQueryHandler serialize must be a function");
@@ -672,27 +703,27 @@ class re extends ee {
   async fetch(e, s = {}) {
     if (e == null || typeof e != "object" || Array.isArray(e))
       throw new TypeError("REST query args must be a named record");
-    const i = ne(this.url, this.baseUrl), o = this.serialize(i, e) ?? i, u = P();
-    if (!(o instanceof u))
+    const o = ie(this.url, this.baseUrl), i = this.serialize(o, e) ?? o, c = O();
+    if (!(i instanceof c))
       throw new TypeError("REST serializer must mutate or return a URL");
-    const a = s.event ?? null;
-    if (this.trace || a || w.hasSubscribers) {
+    const f = s.event ?? null;
+    if (this.trace || f || w.hasSubscribers) {
       const l = new b({
         owner: this,
         purpose: "REST fetch",
-        value: o.toString(),
+        value: i.toString(),
         cause: "fetch called",
-        parent: a
+        parent: f
       });
-      a || w.emit(l);
+      f || w.emit(l);
     }
-    const c = s.signal === void 0 ? {} : { signal: s.signal }, f = await this.fetchImplementation(o.toString(), c);
-    if (!(f != null && f.ok)) throw new te(f == null ? void 0 : f.status);
-    const p = await f.json();
+    const u = s.signal === void 0 ? {} : { signal: s.signal }, h = await this.fetchImplementation(i.toString(), u);
+    if (!(h != null && h.ok)) throw new re(h == null ? void 0 : h.status);
+    const p = await h.json();
     return this.parseResult == null ? p : this.parseResult(p);
   }
 }
-function se(t, r) {
+function ne(t, r) {
   for (const [e, s] of Object.entries(r))
     L(t.searchParams, e, s);
   return t;
@@ -714,8 +745,8 @@ function L(t, r, e) {
     t.append(r, String(e));
   }
 }
-function ne(t, r) {
-  const e = P();
+function ie(t, r) {
+  const e = O();
   try {
     return new e(t);
   } catch (s) {
@@ -724,23 +755,23 @@ function ne(t, r) {
     return new e(t, r);
   }
 }
-function P() {
+function O() {
   const t = Reflect.get(globalThis, "URL");
   if (typeof t != "function")
     throw new Error("RestQueryHandler requires URL in this runtime");
   return t;
 }
-function ie() {
+function oe() {
   const t = Reflect.get(globalThis, "location");
   if (t == null || typeof t != "object" && typeof t != "function")
     return;
   const r = Reflect.get(t, "href");
   return typeof r == "string" ? r : void 0;
 }
-function oe() {
+function ue() {
   return Reflect.get(globalThis, "fetch");
 }
-class ue {
+class ce {
   constructor(r) {
     n(this, "handler");
     n(this, "queryOptions");
@@ -752,7 +783,7 @@ class ue {
     E(e), this.handler = r.handler, this.queryOptions = Object.freeze({ ...e }), Object.freeze(this);
   }
   open(r, e = {}) {
-    return A(r), E(e), new I({
+    return A(r), E(e), new D({
       handler: this.handler,
       args: r,
       ...this.queryOptions,
@@ -760,20 +791,20 @@ class ue {
     });
   }
 }
-function de(t) {
-  return new ue(t);
+function be(t) {
+  return new ce(t);
 }
-class ce {
+class le {
   constructor(r) {
     n(this, "handler");
     n(this, "queryOptions");
     if (r == null || typeof r != "object" || Array.isArray(r))
       throw new TypeError("RestEndpoint options must be an object");
     const { query: e = {}, ...s } = r;
-    E(e, "RestEndpoint query options"), this.handler = new re(s), this.queryOptions = Object.freeze({ ...e }), Object.freeze(this);
+    E(e, "RestEndpoint query options"), this.handler = new se(s), this.queryOptions = Object.freeze({ ...e }), Object.freeze(this);
   }
   open(r, e = {}) {
-    return A(r), E(e), new I({
+    return A(r), E(e), new D({
       handler: this.handler,
       args: r,
       ...this.queryOptions,
@@ -781,10 +812,10 @@ class ce {
     });
   }
 }
-function be(t) {
-  return new ce(t);
+function ye(t) {
+  return new le(t);
 }
-class le {
+class ae {
   constructor(r) {
     n(this, "apply");
     n(this, "purpose");
@@ -795,26 +826,26 @@ class le {
     this.apply = r.apply, this.purpose = r.purpose ?? "derived endpoint", Object.freeze(this);
   }
   open(r) {
-    return new ae({
+    return new he({
       ...r,
       apply: this.apply,
       purpose: r.purpose ?? this.purpose
     });
   }
 }
-function ye(t) {
-  return new le(t);
+function me(t) {
+  return new ae(t);
 }
-class ae extends g {
+class he extends g {
   constructor(e) {
     if (e == null || typeof e != "object" || Array.isArray(e))
       throw new TypeError("DerivedLiveResult options must be an object");
-    if (A(e.args), !z(e.source))
+    if (A(e.args), !P(e.source))
       throw new TypeError("DerivedLiveResult source must be an emitter");
     if (typeof e.apply != "function")
       throw new TypeError("DerivedLiveResult apply must be a function");
     super(void 0, {
-      fetchState: h.Initial,
+      fetchState: a.Initial,
       error: null,
       owner: e.owner,
       ...e.purpose === void 0 ? {} : { purpose: e.purpose },
@@ -830,8 +861,8 @@ class ae extends g {
       this.source,
       ...Object.values(this.args)
     ];
-    this.unsubscribers = s.map((i) => i.subscribe(({ event: o }) => {
-      this.recompute(o);
+    this.unsubscribers = s.map((o) => o.subscribe(({ event: i }) => {
+      this.recompute(i);
     }, { emitCurrent: !1 })), this.recompute(null, !1);
   }
   dispose() {
@@ -842,31 +873,31 @@ class ae extends g {
   }
   recompute(e, s = !0) {
     var p;
-    const i = [
+    const o = [
       this.source,
       ...Object.values(this.args)
-    ], o = ((p = i.find((l) => l.getError() != null)) == null ? void 0 : p.getError()) ?? null;
-    let u = j(
-      i.map((l) => l.getFetchState())
+    ], i = ((p = o.find((l) => l.getError() != null)) == null ? void 0 : p.getError()) ?? null;
+    let c = T(
+      o.map((l) => l.getFetchState())
     );
-    const a = this.source.get();
-    let c = this.lastSuccessfulValue, f = o;
+    const f = this.source.get();
+    let u = this.lastSuccessfulValue, h = i;
     try {
       const l = Object.fromEntries(
         Object.entries(this.args).map(([d, v]) => [d, v.get()])
       );
-      c = this.apply(a, l), this.lastSuccessfulValue = c;
+      u = this.apply(f, l), this.lastSuccessfulValue = u;
     } catch (l) {
-      f = l, u = h.Error;
+      h = l, c = a.Error;
     }
-    if (o != null && (f = o, u = h.Error), !s) {
-      this.value = c, this.fetchState = u, this.error = f;
+    if (i != null && (h = i, c = a.Error), !s) {
+      this.value = u, this.fetchState = c, this.error = h;
       return;
     }
     this.setSnapshot({
-      value: c,
-      fetchState: u,
-      error: f,
+      value: u,
+      fetchState: c,
+      error: h,
       cause: "derived endpoint source changed",
       parentEvent: e
     });
@@ -880,33 +911,33 @@ function A(t) {
   if (t == null || typeof t != "object" || Array.isArray(t))
     throw new TypeError("Endpoint args must be a named record of emitters");
   for (const [r, e] of Object.entries(t))
-    if (!z(e))
+    if (!P(e))
       throw new TypeError(`Endpoint argument ${r} must be an emitter`);
 }
-function z(t) {
+function P(t) {
   return t != null && (typeof t == "object" || typeof t == "function") && typeof Reflect.get(t, "get") == "function" && typeof Reflect.get(t, "getFetchState") == "function" && typeof Reflect.get(t, "getError") == "function" && typeof Reflect.get(t, "subscribe") == "function";
 }
 export {
-  fe as AsyncCommand,
+  pe as AsyncCommand,
   M as AsyncCommandConcurrencyError,
   g as BaseEmitter,
-  D as DerivedEmitter,
-  le as DerivedEndpoint,
-  ae as DerivedLiveResult,
-  U as Emitter,
+  x as DerivedEmitter,
+  ae as DerivedEndpoint,
+  he as DerivedLiveResult,
+  z as Emitter,
   b as EventBubble,
   w as EventBus,
-  h as FetchState,
+  a as FetchState,
   S as FetchStateValues,
-  I as LiveQuery,
-  pe as QueryArg,
-  ue as QueryEndpoint,
-  ee as QueryHandler,
-  ce as RestEndpoint,
-  re as RestQueryHandler,
-  j as combineFetchStates,
-  ye as derivedEndpoint,
-  de as queryEndpoint,
-  be as restEndpoint
+  D as LiveQuery,
+  de as QueryArg,
+  ce as QueryEndpoint,
+  te as QueryHandler,
+  le as RestEndpoint,
+  se as RestQueryHandler,
+  T as combineFetchStates,
+  me as derivedEndpoint,
+  be as queryEndpoint,
+  ye as restEndpoint
 };
 //# sourceMappingURL=index.js.map