npm - aimeat - Versions diffs - 1.40.1 → 2.1.0 - Mend

aimeat 1.40.1 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1816) hide show

package/dist/static/sdk-libs/header/index.js ADDED Viewed

@@ -0,0 +1,249 @@
+/**
+ * @file header/index.js
+ * @description The aimeat-header library (SDK-libs migration Phase 1). A drop-in script that renders
+ *   the canonical AIMEAT site header (brand + morsel count, nav links, language switcher, and the
+ *   live golden login pill with its theme toggle) inside any standalone page such as a custom portal
+ *   template. It reuses the real auth library (aimeat-auth.js → mountLoginButton) so login is
+ *   identical to the SPA, links /css/theme.css so styling matches, and reads the same localStorage
+ *   keys so theme/language stay in sync with the SPA. Componentized ESM source esbuild bundles to the
+ *   IIFE served, unchanged, at /v1/libs/aimeat-header.js. Ported verbatim from lib-header.ts; this is
+ *   a self-running shim (mounts into #aimeat-header or prepends to <body>) — it does not attach to
+ *   window.AIMEAT, so it imports nothing from _core.
+ * @structure readLang/readTheme/applyTheme/flatten/ensureThemeCss/loadScript/loadTranslations/
+ *   modalI18n/buildMarkup/wire/refreshSession/init — runs init() on DOM ready.
+ * @usage <div id="aimeat-header"></div><script src="/v1/libs/aimeat-header.js"></script>
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — Migrated from src/routes/lib-header.ts (SDK-libs migration Phase 1).
+ */
+if (!window.__AIMEAT_HEADER_MOUNTED__) {
+  window.__AIMEAT_HEADER_MOUNTED__ = true;
+  main();
+}
+function main() {
+  var THEME_KEY = 'aimeat-theme';
+  var LANG_KEY = 'aimeat-lang';
+  var NAV_FALLBACK = {
+    'nav.try': 'Try it', 'nav.devView': 'For Developers', 'nav.help': 'Help',
+    'nav.apps': 'Apps', 'nav.profile': 'Profile', 'nav.admin': 'Admin',
+    'nav.themeToDark': 'Switch to dark mode', 'nav.themeToLight': 'Switch to light mode',
+  };
+  function readLang() {
+    try {
+      var u = new URLSearchParams(location.search).get('lang');
+      if (u === 'en' || u === 'fi') return u;
+      var s = localStorage.getItem(LANG_KEY);
+      if (s === 'en' || s === 'fi') return s;
+    } catch { /* storage blocked */ }
+    return (navigator.language || 'en').slice(0, 2).toLowerCase() === 'fi' ? 'fi' : 'en';
+  }
+  function readTheme() {
+    try {
+      var s = localStorage.getItem(THEME_KEY);
+      if (s === 'light' || s === 'dark') return s;
+    } catch { /* storage blocked */ }
+    return (window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) ? 'dark' : 'light';
+  }
+  function applyTheme(t) {
+    document.documentElement.dataset.theme = t;
+    try { localStorage.setItem(THEME_KEY, t); } catch { /* storage blocked */ }
+  }
+  function flatten(obj, prefix, out) {
+    out = out || {}; prefix = prefix || '';
+    for (var k in obj) {
+      if (!Object.prototype.hasOwnProperty.call(obj, k)) continue;
+      var key = prefix ? prefix + '.' + k : k;
+      var v = obj[k];
+      if (v && typeof v === 'object' && !Array.isArray(v)) flatten(v, key, out);
+      else out[key] = v;
+    }
+    return out;
+  }
+  function ensureThemeCss() {
+    var present = Array.prototype.some.call(document.querySelectorAll('link[rel=stylesheet]'), function (l) {
+      return (l.getAttribute('href') || '').indexOf('/css/theme.css') !== -1;
+    });
+    if (present) return;
+    var link = document.createElement('link');
+    link.rel = 'stylesheet';
+    link.href = '/css/theme.css';
+    link.setAttribute('data-aimeat-theme-css', '');
+    // Insert first so the page's own <style> still wins on shared selectors (body, etc.).
+    document.head.insertBefore(link, document.head.firstChild);
+  }
+  function loadScript(src) {
+    return new Promise(function (resolve) {
+      var existing = document.querySelector('script[src="' + src + '"]');
+      if (existing) { resolve(undefined); return; }
+      var s = document.createElement('script');
+      s.src = src; s.onload = resolve; s.onerror = resolve;
+      document.head.appendChild(s);
+    });
+  }
+  async function loadTranslations(lang) {
+    var v = Date.now();
+    var t = {};
+    try {
+      var enRes = await fetch('/locales/en.json?v=' + v);
+      if (enRes.ok) t = flatten(await enRes.json());
+    } catch { /* offline / missing locales — fall through to fallbacks */ }
+    if (lang !== 'en') {
+      try {
+        var locRes = await fetch('/locales/' + lang + '.json?v=' + v);
+        if (locRes.ok) {
+          var loc = flatten(await locRes.json());
+          for (var k in loc) if (Object.prototype.hasOwnProperty.call(loc, k)) t[k] = loc[k];
+        }
+      } catch { /* locale missing — English fallback stands */ }
+    }
+    return t;
+  }
+  function modalI18n(t) {
+    var keys = ['descNew', 'descReturning', 'usernameLabel', 'usernamePlaceholder', 'passwordLabel',
+      'passwordPlaceholder', 'displayNameLabel', 'displayNameHint', 'displayNamePlaceholder', 'signInBtn',
+      'cancelBtn', 'working', 'errUserShort', 'errPassShort', 'errWrongPass', 'loggedIn', 'logoutBtn',
+      'forgotPassword', 'forgotUsername', 'resetPasswordTitle', 'resetPasswordDesc', 'sendResetCode',
+      'backToLogin', 'resetCodeSent', 'enterNewPasswordTitle', 'codeLabel', 'newPasswordLabel',
+      'newPasswordPlaceholder', 'errPassWeak', 'resetPassword', 'resetSuccess', 'recoverUsernameTitle',
+      'recoverUsernameDesc', 'emailLabel', 'sendUsername', 'usernameSent', 'whyTitle', 'whyGhii',
+      'whyPrivacy', 'whyAgents', 'whyMorsels'];
+    var obj = {};
+    for (var i = 0; i < keys.length; i++) {
+      var val = t['modal.' + keys[i]];
+      if (typeof val === 'string') obj[keys[i]] = val;
+    }
+    return obj;
+  }
+  function buildMarkup(t) {
+    function label(k) { return t[k] || NAV_FALLBACK[k] || k; }
+    var nav = document.createElement('nav');
+    nav.className = 'topnav';
+    nav.innerHTML =
+      '<div style="display:flex;align-items:center;gap:20px">' +
+        '<a href="/v1/portal" class="topnav-brand">AIME<span class="heart">♥</span><span class="brand-at">AT</span></a>' +
+        '<span class="brand-morsels" data-morsels style="display:none"></span>' +
+      '</div>' +
+      '<div class="topnav-right">' +
+        '<button class="topnav-burger" aria-label="Menu" data-burger>☰</button>' +
+        '<div class="topnav-menu" data-menu>' +
+          '<a href="/v1/classic">' + label('nav.try') + '</a>' +
+          '<a href="/v1/portal?view=dev">' + label('nav.devView') + '</a>' +
+          '<a href="/v1/help">' + label('nav.help') + '</a>' +
+          '<a href="/app-catalog.html" target="_blank" data-auth-only style="display:none">' + label('nav.apps') + '</a>' +
+          '<a href="/v1/profile" class="profile-link visible" data-auth-only style="display:none">' + label('nav.profile') + '</a>' +
+          '<a href="/v1/admin" data-operator-only style="display:none">' + label('nav.admin') + '</a>' +
+          '<div class="topnav-center">' +
+            // Theme toggle now lives inside the login pill (mountLoginButton) — see init().
+            '<button class="lang-btn" data-lang="en">EN</button>' +
+            '<button class="lang-btn" data-lang="fi">FI</button>' +
+          '</div>' +
+        '</div>' +
+        '<span class="header-auth-slot" id="headerAuth"></span>' +
+      '</div>';
+    return nav;
+  }
+  function wire(nav, t, lang) {
+    // Burger
+    var burger = nav.querySelector('[data-burger]');
+    var menu = nav.querySelector('[data-menu]');
+    burger.addEventListener('click', function () { menu.classList.toggle('open'); });
+    // (Theme toggle moved into the login pill — see mountLoginButton in init().)
+    // Language buttons
+    nav.querySelectorAll('[data-lang]').forEach(function (b) {
+      if (b.getAttribute('data-lang') === lang) b.classList.add('active');
+      b.addEventListener('click', function () {
+        var next = b.getAttribute('data-lang');
+        try {
+          localStorage.setItem(LANG_KEY, next);
+          document.cookie = 'aimeat-lang=' + next + ';path=/;max-age=31536000;SameSite=Lax';
+        } catch { /* storage blocked — cookie may still be set */ }
+        location.reload();
+      });
+    });
+  }
+  function refreshSession(nav) {
+    var hasSession = !!(window.AIMEAT && window.AIMEAT.auth && window.AIMEAT.auth.hasSession);
+    var session = hasSession && window.AIMEAT.auth.getSession ? window.AIMEAT.auth.getSession() : null;
+    nav.querySelectorAll('[data-auth-only]').forEach(function (el) {
+      /** @type {HTMLElement} */ (el).style.display = session ? '' : 'none';
+    });
+    var isOp = session && session.roles && session.roles.indexOf('operator') !== -1;
+    nav.querySelectorAll('[data-operator-only]').forEach(function (el) {
+      /** @type {HTMLElement} */ (el).style.display = isOp ? '' : 'none';
+    });
+    var morselEl = /** @type {HTMLElement} */ (nav.querySelector('[data-morsels]'));
+    if (session && session.jwt) {
+      fetch('/v1/wallet', { headers: { 'Authorization': 'Bearer ' + session.jwt } })
+        .then(function (r) { return r.json(); })
+        .then(function (d) {
+          if (d && d.ok && d.data && d.data.balance != null) {
+            morselEl.textContent = d.data.balance;
+            morselEl.style.display = 'inline-flex';
+          } else { morselEl.style.display = 'none'; }
+        })
+        .catch(function () { morselEl.style.display = 'none'; });
+    } else {
+      morselEl.style.display = 'none';
+    }
+  }
+  async function init() {
+    applyTheme(readTheme());
+    ensureThemeCss();
+    var lang = readLang();
+    document.documentElement.lang = lang;
+    var t = await loadTranslations(lang);
+    var nav = buildMarkup(t);
+    var mount = document.getElementById('aimeat-header');
+    if (mount) { mount.appendChild(nav); }
+    else { document.body.insertBefore(nav, document.body.firstChild); }
+    wire(nav, t, lang);
+    // Live login pill — the real thing, identical to the SPA.
+    await loadScript('/v1/libs/aimeat-auth.js');
+    if (window.AIMEAT && window.AIMEAT.auth && window.AIMEAT.auth.login) {
+      try { await window.AIMEAT.auth.login(); } catch { /* not signed in — pill renders logged-out */ }
+    }
+    function mountPill() {
+      try {
+        if (window.AIMEAT && window.AIMEAT.auth && window.AIMEAT.auth.mountLoginButton) {
+          var pillI18n = modalI18n(t);
+          // Labels for the theme toggle the pill now renders.
+          pillI18n.themeToDark = t['nav.themeToDark'] || NAV_FALLBACK['nav.themeToDark'];
+          pillI18n.themeToLight = t['nav.themeToLight'] || NAV_FALLBACK['nav.themeToLight'];
+          window.AIMEAT.auth.mountLoginButton('#headerAuth', {
+            onLogin: function () { window.dispatchEvent(new Event('aimeat-auth-change')); },
+            onLogout: function () { window.dispatchEvent(new Event('aimeat-auth-change')); },
+            i18n: pillI18n,
+          });
+        }
+      } catch (e) { console.error('AIMEAT header: auth mount failed', e); }
+    }
+    mountPill();
+    refreshSession(nav);
+    window.addEventListener('aimeat-auth-change', function () { refreshSession(nav); });
+  }
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', function () { init(); });
+  } else {
+    init();
+  }
+}

package/dist/static/sdk-libs/intake/index.js ADDED Viewed

@@ -0,0 +1,75 @@
+/**
+ * @file intake/index.js
+ * @description The aimeat-intake library (SDK-libs migration Phase 1). The browser client for the
+ *   generic Public Intake capability, two audiences in one lib: (1) the PUBLIC form renderer (no
+ *   session) — getForm()/submit() hit the no-auth intake endpoint, working cross-origin because the
+ *   node base URL is resolved from _core/config (APEX_URL) or the auth lib's nodeUrl; (2) the OWNER
+ *   (needs aimeat-auth) — defineForm()/listForms()/deleteForm() manage a workspace's intake forms.
+ *   Componentized ESM source esbuild bundles to the IIFE served, unchanged, at /v1/libs/aimeat-intake.js.
+ *   Ported verbatim from lib-intake.ts; the baked ${config.baseUrl} is now APEX_URL from _core/config.
+ * @structure imports APEX_URL (config) + attach (namespace); base()/enc()/submitPath(); public
+ *   getForm/submit; owner authFetch/defineForm/listForms/deleteForm; attach('intake', …).
+ * @usage <script src="/v1/libs/aimeat-intake.js"></script>
+ *   const form = await AIMEAT.intake.getForm(org, ws, 'contact-us');
+ *   await AIMEAT.intake.submit(org, ws, 'contact-us', { nimi: '…', email: '…' });
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — Migrated from src/routes/lib-intake.ts (SDK-libs migration Phase 1).
+ */
+import { APEX_URL } from '../_core/config.js';
+import { attach } from '../_core/namespace.js';
+function base() {
+  // Prefer the auth lib's node URL (same node), else the baked apex base (from _core/config prelude).
+  if (window.AIMEAT && window.AIMEAT.auth && window.AIMEAT.auth.nodeUrl) return String(window.AIMEAT.auth.nodeUrl).replace(/\/+$/, '');
+  return APEX_URL;
+}
+function enc(s) { return encodeURIComponent(String(s == null ? '' : s)); }
+function submitPath(org, ws, formId) { return '/v1/intake/' + enc(org) + '/' + enc(ws) + '/' + enc(formId); }
+// ── PUBLIC (no session) ──────────────────────────────────────────────────────
+async function getForm(org, ws, formId) {
+  var res = await fetch(base() + submitPath(org, ws, formId), { headers: { 'Accept': 'application/json' } });
+  var body = await res.json().catch(function () { return null; });
+  if (!body || body.ok === false) throw new Error((body && body.error && body.error.message) || 'Form not found');
+  return body.data;
+}
+async function submit(org, ws, formId, values) {
+  var res = await fetch(base() + submitPath(org, ws, formId), {
+    method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(values || {}),
+  });
+  var body = await res.json().catch(function () { return null; });
+  if (!body || body.ok === false) {
+    var e = /** @type {Error & { code?: string, details?: unknown }} */ (new Error((body && body.error && body.error.message) || 'Submit failed'));
+    e.code = body && body.error && body.error.code;
+    e.details = body && body.error && body.error.details;
+    throw e;
+  }
+  return body.data; // { ok, id, mode }
+}
+// ── OWNER (needs aimeat-auth) ─────────────────────────────────────────────────
+async function authFetch(path, opts) {
+  if (!window.AIMEAT || !window.AIMEAT.auth) throw new Error('AIMEAT.auth is required for owner methods (load aimeat-auth.js first)');
+  var s = window.AIMEAT.auth.getSession();
+  if (!s) throw new Error('Not logged in. Call AIMEAT.auth.login() first.');
+  var res = await s.fetch(path, opts);
+  if (res && typeof res.json === 'function') res = await res.json();
+  return res;
+}
+async function defineForm(cfg) {
+  var body = await authFetch('/v1/intake/forms', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(cfg || {}) });
+  if (!body || body.ok === false) throw new Error((body && body.error && body.error.message) || 'defineForm failed');
+  return body.data; // { form_id, submit_url, discoverable, enabled, mode }
+}
+async function listForms(org, ws) {
+  var body = await authFetch('/v1/intake/forms?organism_id=' + enc(org) + '&ws=' + enc(ws));
+  if (!body || body.ok === false) throw new Error((body && body.error && body.error.message) || 'listForms failed');
+  return (body.data && body.data.forms) || [];
+}
+async function deleteForm(org, ws, formId) {
+  var body = await authFetch('/v1/intake/forms?organism_id=' + enc(org) + '&ws=' + enc(ws) + '&form_id=' + enc(formId), { method: 'DELETE' });
+  if (!body || body.ok === false) throw new Error((body && body.error && body.error.message) || 'deleteForm failed');
+  return body.data;
+}
+attach('intake', { getForm: getForm, submit: submit, defineForm: defineForm, listForms: listForms, deleteForm: deleteForm, submitPath: submitPath, nodeUrl: base() });

package/dist/static/sdk-libs/live/index.js ADDED Viewed

@@ -0,0 +1,156 @@
+/**
+ * @file live/index.js
+ * @description The aimeat-live library (SDK-libs migration Phase 1, TARGET-012). Exposes AIMEAT.live
+ *   — the realtime "subscribe to server-pushed domain changes" helper that wraps the node's SSE
+ *   transport (POST /v1/events/ticket → GET /v1/events?ticket=) in ONE shared, multi-tab-elected
+ *   EventSource (Web Locks + BroadcastChannel) with debounce, Page-Visibility gating and
+ *   exponential-backoff reconnect. Subscribers re-fetch only when the server says their domain
+ *   changed. Componentized ESM source esbuild bundles to the IIFE served, unchanged, at
+ *   /v1/libs/aimeat-live.js. Ported verbatim from lib-live.ts.
+ * @structure imports getSession (session) + attach (namespace); the shared EventSource state machine
+ *   (connect/startShared/_open/ingest/flush/dispatch/reconnect/disconnect/subscribe); attach('live', …).
+ * @usage <script src="/v1/libs/aimeat-auth.js"></script><script src="/v1/libs/aimeat-live.js"></script>
+ *   const off = AIMEAT.live.subscribe(['agent-tasks','organisms'], (domains) => reload());
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — Migrated from src/routes/lib-live.ts (SDK-libs migration Phase 1).
+ */
+import { makeSession } from '../_core/session.js';
+const { getSession } = makeSession('aimeat-live.js');
+import { attach } from '../_core/namespace.js';
+var es = null;
+var subscribers = [];              // { domains: Set<string>|null, fn }  (null = all)
+var debounceTimer = null;
+var refCount = 0;
+var reconnectTimer = null;
+var reconnectDelay = 5000;
+var everOpened = false;
+var MAX_RECONNECT_DELAY = 120000;
+var DEBOUNCE_MS = 1000;            // match server COALESCE_MS
+var pendingDomains = new Set();    // null => "everything changed"
+var hadHiddenUpdate = false;
+// Multi-tab sharing
+var started = false;
+var isLeader = false;
+var bc = null;
+var leaderRelease = null;
+var leaderAbort = null;
+function connect() {
+  refCount++;
+  if (started) return;
+  started = true;
+  startShared();
+}
+function startShared() {
+  var canShare = (typeof BroadcastChannel !== 'undefined') && (typeof navigator !== 'undefined') && navigator.locks;
+  if (!canShare) { becomeLeader(); return; }
+  bc = new BroadcastChannel('aimeat-live');
+  bc.onmessage = function (ev) { if (ev.data && ev.data.type === 'domains') ingestDomains(ev.data.domains); };
+  leaderAbort = new AbortController();
+  navigator.locks.request('aimeat-live-leader', { mode: 'exclusive', signal: leaderAbort.signal }, function () {
+    return new Promise(function (release) { leaderRelease = release; becomeLeader(); });
+  }).catch(function () { /* aborted while queued */ });
+}
+function becomeLeader() { if (isLeader) return; isLeader = true; _open(); }
+function relay(domains) { if (bc) { try { bc.postMessage({ type: 'domains', domains: domains }); } catch { /* channel closed */ } } }
+async function _open() {
+  var session;
+  try { session = getSession(); } catch { scheduleReconnect(); return; }
+  try {
+    var r = await session.fetch('/v1/events/ticket', { method: 'POST' });
+    if (!r || !r.ok || !r.data || !r.data.ticket) { scheduleReconnect(); return; }
+    es = new EventSource('/v1/events?ticket=' + encodeURIComponent(r.data.ticket));
+    es.onopen = function () {
+      reconnectDelay = 5000;
+      if (everOpened) { ingestDomains(null); relay(null); }   // reconnect catch-up: reconcile all
+      everOpened = true;
+    };
+    es.onmessage = function (event) {
+      reconnectDelay = 5000;
+      var domains = null;
+      try { var p = JSON.parse(event.data); if (Array.isArray(p.domains)) domains = p.domains; } catch { /* non-JSON keep-alive frame */ }
+      ingestDomains(domains); relay(domains);
+    };
+    es.onerror = function () { if (es) { es.close(); es = null; } scheduleReconnect(); };
+  } catch { scheduleReconnect(); }
+}
+function ingestDomains(domains) {
+  if (domains === null) pendingDomains = null;
+  else if (pendingDomains !== null) domains.forEach(function (d) { pendingDomains.add(d); });
+  clearTimeout(debounceTimer);
+  debounceTimer = setTimeout(flushDomains, DEBOUNCE_MS);
+}
+function flushDomains() {
+  if (typeof document !== 'undefined' && document.hidden) { hadHiddenUpdate = true; return; }
+  var dset = pendingDomains;
+  pendingDomains = new Set();
+  dispatch(dset);
+}
+function dispatch(dset) {
+  // window event first (family convention: apps may listen instead of subscribe)
+  try { window.dispatchEvent(new CustomEvent('aimeat-live-update', { detail: { domains: dset } })); } catch { /* no window */ }
+  var list = subscribers.slice();
+  for (var i = 0; i < list.length; i++) {
+    var s = list[i];
+    if (dset === null || s.domains === null) { try { s.fn(dset); } catch { /* subscriber threw */ } continue; }
+    var it = dset.values ? dset.values() : dset[Symbol.iterator]();
+    var hit = false, n;
+    while (!(n = it.next()).done) { if (s.domains.has(n.value)) { hit = true; break; } }
+    if (hit) { try { s.fn(dset); } catch { /* subscriber threw */ } }
+  }
+}
+function scheduleReconnect() {
+  clearTimeout(reconnectTimer);
+  if (refCount > 0 && isLeader) {
+    reconnectTimer = setTimeout(function () { if (refCount > 0) _open(); }, reconnectDelay);
+    reconnectDelay = Math.min(reconnectDelay * 2, MAX_RECONNECT_DELAY);
+  }
+}
+if (typeof document !== 'undefined') {
+  document.addEventListener('visibilitychange', function () {
+    if (!document.hidden && hadHiddenUpdate) { hadHiddenUpdate = false; pendingDomains = null; flushDomains(); }
+  });
+}
+function disconnect() {
+  refCount = Math.max(0, refCount - 1);
+  if (refCount === 0) {
+    started = false;
+    if (es) { es.close(); es = null; }
+    if (leaderAbort) { try { leaderAbort.abort(); } catch { /* already aborted */ } leaderAbort = null; }
+    if (leaderRelease) { try { leaderRelease(); } catch { /* already released */ } leaderRelease = null; }
+    isLeader = false;
+    if (bc) { try { bc.close(); } catch { /* already closed */ } bc = null; }
+    clearTimeout(debounceTimer); clearTimeout(reconnectTimer);
+    reconnectDelay = 5000; everOpened = false; pendingDomains = new Set(); hadHiddenUpdate = false;
+  }
+}
+// Subscribe to specific domains (or null = all). Auto-connects on first subscribe. Returns unsubscribe.
+function subscribe(domains, fn) {
+  if (typeof domains === 'function') { fn = domains; domains = null; }
+  var entry = { domains: domains ? new Set(domains) : null, fn: fn };
+  subscribers.push(entry);
+  connect();
+  return function () {
+    var i = subscribers.indexOf(entry);
+    if (i >= 0) { subscribers.splice(i, 1); disconnect(); }
+  };
+}
+attach('live', {
+  connect: connect,
+  disconnect: disconnect,
+  subscribe: subscribe,
+  onUpdate: function (fn) { return subscribe(null, fn); },
+});