aimeat 2.0.0 → 2.1.0

package/dist/static/sdk-libs/tunnel/index.js

@@ -0,0 +1,428 @@
+/**
+ * @file tunnel/index.js
+ * @description The aimeat-tunnel library (SDK-libs migration Phase 2). Exposes AIMEAT.tunnel — an
+ *   auto-reconnecting WebSocket tunnel between a personal node and the operator: heartbeat with
+ *   dead-connection detection, request/response handling, mailbox sync + ack, exponential-backoff
+ *   reconnect with jitter, and status callbacks. Over the AIMEAT.auth session (jwt in the ws URL).
+ *   Componentized ESM source esbuild bundles to the IIFE served, unchanged, at /v1/libs/aimeat-tunnel.js.
+ *   Ported verbatim from lib-tunnel.ts; NODE_URL + the default heartbeat interval come from _core/config.
+ * @structure imports NODE_URL/HEARTBEAT_MS (config) + getSession (session) + attach (namespace);
+ *   uuid(); the TunnelClient prototype class; the `tunnel` public API; attach('tunnel', …).
+ * @usage <script src="/v1/libs/aimeat-auth.js"></script><script src="/v1/libs/aimeat-tunnel.js"></script>
+ *   const tunnel = AIMEAT.tunnel.connect({ onRequest, onMailbox });
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — Migrated from src/routes/lib-tunnel.ts (SDK-libs migration Phase 2).
+ */
+import { NODE_URL, HEARTBEAT_MS } from '../_core/config.js';
+import { makeSession } from '../_core/session.js';
+const { getSession } = makeSession('aimeat-tunnel.js');
+import { attach } from '../_core/namespace.js';
+
+function uuid() {
+  return crypto.randomUUID ? crypto.randomUUID() :
+    'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+      var r = Math.random() * 16 | 0;
+      return (c === 'x' ? r : (r & 0x3 | 0x8)).toString(16);
+    });
+}
+
+// ── TunnelClient class ──
+
+function TunnelClient(opts) {
+  this._opts = Object.assign({
+    heartbeatIntervalMs: HEARTBEAT_MS,
+    reconnect: true,
+    reconnectBaseMs: 1000,
+    reconnectMaxMs: 60000,
+    reconnectJitter: true,
+    maxReconnectAttempts: Infinity,
+    requestTimeoutMs: 30000,
+    onRequest: null,         // async (msg) => response_payload
+    onMailbox: null,         // (items) => void
+    onDeliveryReceipt: null, // (receipt) => void
+    onStatusChange: null,    // (status: 'connecting'|'online'|'degraded'|'offline') => void
+    onError: null,           // (error) => void
+  }, opts || {});
+
+  this._ws = null;
+  this._status = 'offline';
+  this._heartbeatTimer = null;
+  this._reconnectTimer = null;
+  this._reconnectAttempts = 0;
+  this._pendingResponses = new Map();
+  this._closed = false;
+  this._lastHeartbeatAck = 0;
+  this._serverConfig = null;  // Populated by welcome message
+}
+
+TunnelClient.prototype._setStatus = function (status) {
+  if (this._status !== status) {
+    this._status = status;
+    if (this._opts.onStatusChange) {
+      try { this._opts.onStatusChange(status); } catch (e) { console.error('[aimeat-tunnel] onStatusChange error:', e); }
+    }
+  }
+};
+
+TunnelClient.prototype.connect = function () {
+  if (this._closed) return;
+
+  this._setStatus('connecting');
+
+  var session = getSession();
+  var wsUrl = NODE_URL.replace(/^http/, 'ws') + '/v1/personal/tunnel?token=' + encodeURIComponent(session.jwt);
+  var self = this;
+
+  try {
+    this._ws = new WebSocket(wsUrl);
+  } catch (e) {
+    this._setStatus('offline');
+    if (this._opts.onError) this._opts.onError(e);
+    this._scheduleReconnect();
+    return;
+  }
+
+  this._ws.onopen = function () {
+    self._reconnectAttempts = 0;
+    self._lastHeartbeatAck = Date.now();
+    self._setStatus('online');
+    self._startHeartbeat();
+  };
+
+  this._ws.onmessage = function (event) {
+    try {
+      var msg = JSON.parse(event.data);
+      self._handleMessage(msg);
+    } catch (e) {
+      console.error('[aimeat-tunnel] Invalid message:', e);
+    }
+  };
+
+  this._ws.onclose = function () {
+    self._cleanup();
+    self._setStatus('offline');
+    if (!self._closed) {
+      self._scheduleReconnect();
+    }
+  };
+
+  this._ws.onerror = function (err) {
+    if (self._opts.onError) self._opts.onError(err);
+  };
+};
+
+TunnelClient.prototype._handleMessage = function (msg) {
+  switch (msg.type) {
+    case 'welcome':
+      this._handleWelcome(msg);
+      break;
+
+    case 'request':
+      this._handleRequest(msg);
+      break;
+
+    case 'heartbeat_ack':
+      this._lastHeartbeatAck = Date.now();
+      break;
+
+    case 'mailbox_sync':
+      this._handleMailboxSync(msg);
+      break;
+
+    case 'delivery_receipt':
+      if (this._opts.onDeliveryReceipt && msg.payload) {
+        try { this._opts.onDeliveryReceipt(JSON.parse(msg.payload)); } catch { /* ignore */ }
+      }
+      break;
+
+    case 'response': {
+      // Response to a request we sent (if acting as requester)
+      var pending = this._pendingResponses.get(msg.id);
+      if (pending) {
+        clearTimeout(pending.timer);
+        this._pendingResponses.delete(msg.id);
+        pending.resolve(msg);
+      }
+      break;
+    }
+
+    default:
+      console.warn('[aimeat-tunnel] Unknown message type:', msg.type);
+  }
+};
+
+TunnelClient.prototype._handleWelcome = function (msg) {
+  if (!msg.payload) return;
+  try {
+    this._serverConfig = JSON.parse(msg.payload);
+
+    // Auto-tune heartbeat interval from server hint
+    if (this._serverConfig.heartbeat_interval_ms) {
+      this._opts.heartbeatIntervalMs = this._serverConfig.heartbeat_interval_ms;
+      // Restart heartbeat with server-recommended interval
+      if (this._heartbeatTimer) this._startHeartbeat();
+    }
+
+    // Apply reconnect hints from server
+    if (this._serverConfig.reconnect_hint) {
+      var hint = this._serverConfig.reconnect_hint;
+      if (hint.base_ms) this._opts.reconnectBaseMs = hint.base_ms;
+      if (hint.max_ms) this._opts.reconnectMaxMs = hint.max_ms;
+      if (hint.jitter !== undefined) this._opts.reconnectJitter = hint.jitter;
+    }
+  } catch (e) {
+    console.error('[aimeat-tunnel] Welcome parse error:', e);
+  }
+};
+
+TunnelClient.prototype._handleRequest = async function (msg) {
+  if (!this._opts.onRequest) {
+    // No handler — send empty ack
+    this._sendResponse(msg.id, null);
+    return;
+  }
+
+  try {
+    var result = await this._opts.onRequest({
+      id: msg.id,
+      from: msg.from,
+      to: msg.to,
+      payload: msg.payload ? JSON.parse(msg.payload) : null,
+      timestamp: msg.timestamp,
+    });
+
+    this._sendResponse(msg.id, result);
+  } catch (e) {
+    console.error('[aimeat-tunnel] onRequest handler error:', e);
+    this._sendResponse(msg.id, { error: e.message || 'Handler error' });
+  }
+};
+
+TunnelClient.prototype._sendResponse = function (requestId, payload) {
+  if (!this._ws || this._ws.readyState !== WebSocket.OPEN) return;
+
+  this._ws.send(JSON.stringify({
+    type: 'response',
+    id: requestId,
+    payload: payload != null ? JSON.stringify(payload) : null,
+    timestamp: new Date().toISOString(),
+  }));
+};
+
+TunnelClient.prototype._handleMailboxSync = function (msg) {
+  if (!msg.payload) return;
+
+  try {
+    var data = JSON.parse(msg.payload);
+    var items = data.mailbox_items || [];
+
+    // Deliver to callback
+    if (this._opts.onMailbox && items.length > 0) {
+      this._opts.onMailbox(items.map(function (item) {
+        return {
+          id: item.id,
+          type: item.type,
+          from: item.from,
+          to: item.to,
+          payload: item.payload ? JSON.parse(item.payload) : null,
+          created_at: item.created_at,
+        };
+      }));
+    }
+
+    // Acknowledge receipt so operator can delete from mailbox
+    if (items.length > 0) {
+      var itemIds = items.map(function (i) { return i.id; });
+      this._send({
+        type: 'mailbox_ack',
+        id: uuid(),
+        payload: JSON.stringify(itemIds),
+        timestamp: new Date().toISOString(),
+      });
+    }
+  } catch (e) {
+    console.error('[aimeat-tunnel] Mailbox sync error:', e);
+  }
+};
+
+// ── Heartbeat ──
+
+TunnelClient.prototype._startHeartbeat = function () {
+  this._stopHeartbeat();
+  var self = this;
+  var interval = this._opts.heartbeatIntervalMs;
+
+  this._heartbeatTimer = setInterval(function () {
+    if (!self._ws || self._ws.readyState !== WebSocket.OPEN) return;
+
+    // Check if last ack was received (detect dead connection)
+    var sinceLast = Date.now() - self._lastHeartbeatAck;
+    if (sinceLast > interval * 3) {
+      console.warn('[aimeat-tunnel] Heartbeat ack timeout (' + sinceLast + 'ms), reconnecting...');
+      self._ws.close(4000, 'heartbeat_timeout');
+      return;
+    }
+
+    self._send({
+      type: 'heartbeat',
+      id: uuid(),
+      timestamp: new Date().toISOString(),
+    });
+  }, interval);
+};
+
+TunnelClient.prototype._stopHeartbeat = function () {
+  if (this._heartbeatTimer) {
+    clearInterval(this._heartbeatTimer);
+    this._heartbeatTimer = null;
+  }
+};
+
+// ── Reconnect with exponential backoff + jitter ──
+
+TunnelClient.prototype._scheduleReconnect = function () {
+  if (this._closed || !this._opts.reconnect) return;
+  if (this._reconnectAttempts >= this._opts.maxReconnectAttempts) {
+    console.error('[aimeat-tunnel] Max reconnect attempts reached (' + this._opts.maxReconnectAttempts + ')');
+    if (this._opts.onError) this._opts.onError(new Error('Max reconnect attempts reached'));
+    return;
+  }
+
+  var base = this._opts.reconnectBaseMs;
+  var max = this._opts.reconnectMaxMs;
+  var attempt = this._reconnectAttempts;
+
+  // Exponential backoff: 1s, 2s, 4s, 8s, 16s, 32s, 60s cap
+  var delay = Math.min(base * Math.pow(2, attempt), max);
+
+  // Add random jitter (±25%) to prevent thundering herd
+  if (this._opts.reconnectJitter) {
+    var jitter = delay * 0.25 * (Math.random() * 2 - 1);
+    delay = Math.max(base, delay + jitter);
+  }
+
+  var self = this;
+  this._reconnectAttempts++;
+
+  console.log('[aimeat-tunnel] Reconnecting in ' + Math.round(delay) + 'ms (attempt ' + this._reconnectAttempts + ')');
+
+  this._reconnectTimer = setTimeout(function () {
+    self._reconnectTimer = null;
+    self.connect();
+  }, delay);
+};
+
+// ── Send helper ──
+
+TunnelClient.prototype._send = function (msg) {
+  if (this._ws && this._ws.readyState === WebSocket.OPEN) {
+    this._ws.send(JSON.stringify(msg));
+  }
+};
+
+// ── Send a request to the operator and await response ──
+
+TunnelClient.prototype.sendRequest = function (payload, timeoutMs) {
+  var self = this;
+  var timeout = timeoutMs || this._opts.requestTimeoutMs;
+  var id = uuid();
+
+  return new Promise(function (resolve, reject) {
+    if (!self._ws || self._ws.readyState !== WebSocket.OPEN) {
+      return reject(new Error('Tunnel not connected'));
+    }
+
+    var timer = setTimeout(function () {
+      self._pendingResponses.delete(id);
+      reject(new Error('Request timeout (' + timeout + 'ms)'));
+    }, timeout);
+
+    self._pendingResponses.set(id, { resolve: resolve, timer: timer });
+
+    self._send({
+      type: 'request',
+      id: id,
+      payload: JSON.stringify(payload),
+      timestamp: new Date().toISOString(),
+    });
+  });
+};
+
+// ── Cleanup ──
+
+TunnelClient.prototype._cleanup = function () {
+  this._stopHeartbeat();
+
+  // Reject all pending responses
+  for (var entry of this._pendingResponses.values()) {
+    clearTimeout(entry.timer);
+    entry.resolve(null);
+  }
+  this._pendingResponses.clear();
+};
+
+// ── Close (permanent) ──
+
+TunnelClient.prototype.close = function () {
+  this._closed = true;
+  this._cleanup();
+
+  if (this._reconnectTimer) {
+    clearTimeout(this._reconnectTimer);
+    this._reconnectTimer = null;
+  }
+
+  if (this._ws) {
+    // Send graceful disconnect before closing
+    this._send({
+      type: 'disconnect',
+      id: uuid(),
+      timestamp: new Date().toISOString(),
+    });
+
+    try { this._ws.close(1000, 'client_close'); } catch { /* ignore */ }
+    this._ws = null;
+  }
+
+  this._setStatus('offline');
+};
+
+// ── Status getters ──
+
+TunnelClient.prototype.isOnline = function () {
+  return this._status === 'online';
+};
+
+TunnelClient.prototype.getStatus = function () {
+  return this._status;
+};
+
+TunnelClient.prototype.getReconnectAttempts = function () {
+  return this._reconnectAttempts;
+};
+
+TunnelClient.prototype.getServerConfig = function () {
+  return this._serverConfig;
+};
+
+// ── Public API ──
+
+var tunnel = {
+  // Create and connect a tunnel client
+  connect: function (opts) {
+    var client = new TunnelClient(opts);
+    client.connect();
+    return client;
+  },
+
+  // Create without auto-connecting
+  create: function (opts) {
+    return new TunnelClient(opts);
+  },
+
+  // Version
+  version: '1.0.0',
+};
+
+// Mount on AIMEAT namespace
+attach('tunnel', tunnel);

package/dist/static/sdk-libs/wallet/index.js

@@ -0,0 +1,115 @@
+/**
+ * @file wallet/index.js
+ * @description The aimeat-wallet library (SDK-libs migration Phase 1). Exposes AIMEAT.wallet —
+ *   morsel balance + transaction-history helpers that call /v1/wallet via the AIMEAT.auth session,
+ *   plus a self-contained mountBadge() UI component. Componentized ESM source esbuild bundles to the
+ *   IIFE served, unchanged, at /v1/libs/aimeat-wallet.js. Ported verbatim from lib-wallet.ts; the
+ *   only structural change is the shared _core session/namespace glue in place of inline copies.
+ * @structure imports authFetch (session) + attach (namespace); wallet.balance/transactions/history/
+ *   request/mountBadge; attach('wallet', …).
+ * @usage <script src="/v1/libs/aimeat-auth.js"></script><script src="/v1/libs/aimeat-wallet.js"></script>
+ *   const bal = await AIMEAT.wallet.balance();
+ * @version-history
+ *   v1.0.0 — 2026-07-19 — Migrated from src/routes/lib-wallet.ts (SDK-libs migration Phase 1).
+ */
+import { makeSession } from '../_core/session.js';
+const { authFetch } = makeSession('aimeat-wallet.js');
+import { attach } from '../_core/namespace.js';
+
+const wallet = {
+  // Get current balance
+  async balance() {
+    const res = await authFetch('/v1/wallet');
+    if (!res.ok) throw new Error(res.error?.message || 'Failed to get balance');
+    return res.data;
+  },
+
+  // Get transaction history
+  async transactions(opts) {
+    const params = new URLSearchParams();
+    if (opts?.type) params.set('type', opts.type);
+    if (opts?.page) params.set('page', String(opts.page));
+    if (opts?.per_page) params.set('per_page', String(opts.per_page));
+    if (opts?.limit) params.set('limit', String(opts.limit));
+    const qs = params.toString();
+    const res = await authFetch('/v1/wallet/transactions' + (qs ? '?' + qs : ''));
+    if (!res.ok) throw new Error(res.error?.message || 'Failed to get transactions');
+    return res.data;
+  },
+
+  // Legacy: get transaction history
+  async history(opts) {
+    const params = new URLSearchParams();
+    if (opts?.limit) params.set('limit', String(opts.limit));
+    const qs = params.toString();
+    const res = await authFetch('/v1/wallet/history' + (qs ? '?' + qs : ''));
+    if (!res.ok) throw new Error(res.error?.message || 'Failed to get history');
+    return res.data;
+  },
+
+  // Request morsels (e.g. daily allowance)
+  async request(amount, reason) {
+    const res = await authFetch('/v1/wallet/request', {
+      method: 'POST',
+      body: JSON.stringify({ amount, reason }),
+    });
+    if (!res.ok) throw new Error(res.error?.message || 'Failed to request morsels');
+    return res.data;
+  },
+
+  // ── UI Component: Balance Badge ──
+  mountBadge(selector, opts) {
+    const el = typeof selector === 'string' ? document.querySelector(selector) : selector;
+    if (!el) throw new Error('Badge element not found: ' + selector);
+
+    const badge = document.createElement('div');
+    badge.style.cssText = 'display:inline-flex;align-items:center;gap:6px;padding:4px 12px;background:#1e293b;border:1px solid #475569;border-radius:20px;color:#e2e8f0;font-family:system-ui;font-size:13px;cursor:pointer';
+    badge.innerHTML = '<span style="font-size:16px">\u{1F36A}</span><span class="aimeat-balance">...</span>';
+    el.appendChild(badge);
+
+    async function refresh() {
+      try {
+        const data = await wallet.balance();
+        badge.querySelector('.aimeat-balance').textContent = (data.available ?? data.balance ?? 0) + ' morsels';
+      } catch {
+        badge.querySelector('.aimeat-balance').textContent = '--';
+      }
+    }
+
+    refresh();
+
+    // Auto-refresh
+    const interval = setInterval(refresh, (opts?.refreshInterval || 30) * 1000);
+
+    // Click to show transaction history
+    badge.addEventListener('click', async () => {
+      try {
+        const txData = await wallet.transactions({ limit: 10 });
+        const txList = (txData.transactions || []).map(tx =>
+          '<div style="padding:4px 0;border-bottom:1px solid #334155;font-size:12px">'
+          + '<span style="color:' + (tx.amount >= 0 ? '#4ade80' : '#f87171') + '">'
+          + (tx.amount >= 0 ? '+' : '') + tx.amount + '</span> '
+          + (tx.type || '') + ' '
+          + '<span style="color:#94a3b8">' + new Date(tx.timestamp).toLocaleString() + '</span>'
+          + '</div>',
+        ).join('');
+
+        const popup = document.createElement('div');
+        popup.style.cssText = 'position:fixed;inset:0;background:rgba(0,0,0,.5);display:flex;align-items:center;justify-content:center;z-index:99999';
+        popup.innerHTML = '<div style="background:#1e293b;border:1px solid #475569;border-radius:12px;padding:16px;max-width:320px;width:90%;color:#e2e8f0;font-family:system-ui;max-height:60vh;overflow-y:auto">'
+          + '<h4 style="margin:0 0 12px">\u{1F36A} Wallet Transactions</h4>'
+          + (txList || '<p style="color:#94a3b8;font-size:13px">No transactions yet.</p>')
+          + '<button style="margin-top:12px;padding:6px 16px;background:#334155;color:#e2e8f0;border:none;border-radius:8px;cursor:pointer;font-size:13px">Close</button>'
+          + '</div>';
+        popup.querySelector('button').addEventListener('click', () => popup.remove());
+        popup.addEventListener('click', (e) => { if (e.target === popup) popup.remove(); });
+        document.body.appendChild(popup);
+      } catch (e) { console.error('AIMEAT wallet:', e); }
+    });
+
+    return { refresh, destroy: () => { clearInterval(interval); badge.remove(); } };
+  },
+};
+
+// ── Expose globally ──
+attach('wallet', wallet);