npm - @zeyos/client - Versions diffs - 0.1.0 - Mend

@zeyos/client 0.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 (110) hide show

package/CHANGELOG.md +31 -0
package/LICENSE +21 -0
package/README.md +458 -0
package/agents/README.md +66 -0
package/agents/shared/business-app-benchmarks.md +111 -0
package/agents/shared/zeyos-entity-map.md +142 -0
package/agents/shared/zeyos-entity-reference.md +570 -0
package/agents/shared/zeyos-query-patterns.md +89 -0
package/agents/zeyos-account-intelligence/SKILL.md +34 -0
package/agents/zeyos-account-intelligence/agents/openai.yaml +4 -0
package/agents/zeyos-account-intelligence/references/workflows.md +84 -0
package/agents/zeyos-billing-insights/SKILL.md +41 -0
package/agents/zeyos-billing-insights/agents/openai.yaml +4 -0
package/agents/zeyos-billing-insights/references/workflows.md +106 -0
package/agents/zeyos-campaign-and-outreach/SKILL.md +44 -0
package/agents/zeyos-campaign-and-outreach/agents/openai.yaml +4 -0
package/agents/zeyos-campaign-and-outreach/references/workflows.md +100 -0
package/agents/zeyos-collaboration-and-activity/SKILL.md +37 -0
package/agents/zeyos-collaboration-and-activity/agents/openai.yaml +4 -0
package/agents/zeyos-collaboration-and-activity/references/workflows.md +104 -0
package/agents/zeyos-collections-and-dunning/SKILL.md +46 -0
package/agents/zeyos-collections-and-dunning/agents/openai.yaml +4 -0
package/agents/zeyos-collections-and-dunning/references/workflows.md +132 -0
package/agents/zeyos-commerce-and-inventory/SKILL.md +38 -0
package/agents/zeyos-commerce-and-inventory/agents/openai.yaml +4 -0
package/agents/zeyos-commerce-and-inventory/references/workflows.md +101 -0
package/agents/zeyos-mail-operations/SKILL.md +35 -0
package/agents/zeyos-mail-operations/agents/openai.yaml +4 -0
package/agents/zeyos-mail-operations/references/workflows.md +110 -0
package/agents/zeyos-notes-and-sops/SKILL.md +31 -0
package/agents/zeyos-notes-and-sops/agents/openai.yaml +4 -0
package/agents/zeyos-notes-and-sops/references/workflows.md +85 -0
package/agents/zeyos-platform-and-schema/SKILL.md +37 -0
package/agents/zeyos-platform-and-schema/agents/openai.yaml +4 -0
package/agents/zeyos-platform-and-schema/references/workflows.md +97 -0
package/agents/zeyos-work-management/SKILL.md +45 -0
package/agents/zeyos-work-management/agents/openai.yaml +4 -0
package/agents/zeyos-work-management/references/workflows.md +148 -0
package/docs/01-api-reference/01-data-retrieval.md +601 -0
package/docs/01-api-reference/02-authentication.md +288 -0
package/docs/01-api-reference/03-resources.md +270 -0
package/docs/01-api-reference/04-schema.md +539 -0
package/docs/01-api-reference/_category_.json +9 -0
package/docs/02-javascript-client/01-getting-started.md +146 -0
package/docs/02-javascript-client/02-authentication.md +287 -0
package/docs/02-javascript-client/03-making-requests.md +572 -0
package/docs/02-javascript-client/04-practical-guide.md +348 -0
package/docs/02-javascript-client/_category_.json +9 -0
package/docs/03-cli/01-getting-started.md +219 -0
package/docs/03-cli/02-commands.md +407 -0
package/docs/03-cli/03-configuration.md +220 -0
package/docs/03-cli/_category_.json +9 -0
package/docs/04-agent-workflows/00-coding-agents.md +35 -0
package/docs/04-agent-workflows/01-agent-quickstart.md +147 -0
package/docs/04-agent-workflows/02-agent-recipes.md +109 -0
package/docs/04-agent-workflows/03-cli-coverage-and-escalation.md +65 -0
package/docs/04-agent-workflows/_category_.json +9 -0
package/docs/04-sample-apps/01-kanban.md +89 -0
package/docs/04-sample-apps/02-crm.md +81 -0
package/docs/04-sample-apps/03-dashboard.md +80 -0
package/docs/04-sample-apps/_category_.json +9 -0
package/docs/05-tutorials/00-application-developers.md +43 -0
package/docs/05-tutorials/01-integration-architecture.md +60 -0
package/docs/05-tutorials/02-build-your-own-zeyos-frontend.md +517 -0
package/docs/05-tutorials/03-server-side-integrations.md +185 -0
package/docs/05-tutorials/_category_.json +9 -0
package/docs/intro.md +197 -0
package/openapi/api.json +24308 -0
package/openapi/auth.json +415 -0
package/openapi/dbref.json +56223 -0
package/openapi/oauth2.json +781 -0
package/openapi/sdk.json +949 -0
package/openapi/views.txt +642 -0
package/package.json +49 -0
package/samples/crm/README.md +28 -0
package/samples/crm/index.html +327 -0
package/samples/crm/js/api.js +208 -0
package/samples/crm/js/auth.js +61 -0
package/samples/crm/js/main.js +545 -0
package/samples/crm/js/state.js +90 -0
package/samples/crm/js/ui.js +51 -0
package/samples/dashboard/README.md +28 -0
package/samples/dashboard/index.html +280 -0
package/samples/dashboard/js/api.js +197 -0
package/samples/dashboard/js/auth.js +59 -0
package/samples/dashboard/js/main.js +382 -0
package/samples/dashboard/js/state.js +81 -0
package/samples/dashboard/js/ui.js +48 -0
package/samples/kanban/README.md +28 -0
package/samples/kanban/index.html +263 -0
package/samples/kanban/js/api.js +152 -0
package/samples/kanban/js/auth.js +59 -0
package/samples/kanban/js/constants.js +40 -0
package/samples/kanban/js/kanban.js +246 -0
package/samples/kanban/js/main.js +362 -0
package/samples/kanban/js/modals.js +474 -0
package/samples/kanban/js/settings.js +82 -0
package/samples/kanban/js/state.js +118 -0
package/samples/kanban/js/ui.js +49 -0
package/scripts/generate-client.mjs +344 -0
package/src/generated/operations.js +9772 -0
package/src/generated/schema.js +8982 -0
package/src/index.js +85 -0
package/src/runtime/client.js +1208 -0
package/src/runtime/error.js +29 -0
package/src/runtime/http.js +174 -0
package/src/runtime/request-shape.js +35 -0
package/src/runtime/schema.js +206 -0
package/src/runtime/suggest.js +74 -0
package/src/runtime/token-store.js +105 -0

package/samples/crm/js/main.js ADDED Viewed

@@ -0,0 +1,545 @@
+/**
+ * CRM Account List -- Application entry point.
+ *
+ * Bootstraps the client, handles auth, wires up all UI events,
+ * and orchestrates data loading / table rendering.
+ *
+ * Authentication: reads config from <body> data attributes + localStorage.
+ *  1. If tokens are available -> token mode
+ *  2. If URL only -> try session detection via /oauth2/v1/userinfo
+ *  3. Otherwise -> connection screen with troubleshooting
+ *
+ * Exposes a global ZeyOS console API for debugging / configuration.
+ */
+import {
+  initTokenClient, initSessionClient,
+  fetchAccounts, getAccount, createAccount, updateAccount, deleteAccount,
+} from './api.js';
+import { trySessionAuth, logout } from './auth.js';
+import { runtime, resolveConfig, saveUrl, saveTokens, clearTokens, clearUrl } from './state.js';
+import { showToast, showLoading, hideLoading } from './ui.js';
+// ── Account Type Labels & Colors ────────────────────────────────────────────
+// 0 = Prospect, 1 = Customer, 2 = Supplier, 3 = Cust. & Suppl., 4 = Competitor, 5 = Employee
+const ACCOUNT_TYPES = {
+  0: { label: 'Prospect',       bg: 'bg-amber-100',   text: 'text-amber-700'   },
+  1: { label: 'Customer',       bg: 'bg-emerald-100', text: 'text-emerald-700' },
+  2: { label: 'Supplier',       bg: 'bg-purple-100',  text: 'text-purple-700'  },
+  3: { label: 'Cust. & Suppl.', bg: 'bg-blue-100',    text: 'text-blue-700'    },
+  4: { label: 'Competitor',     bg: 'bg-red-100',     text: 'text-red-700'     },
+  5: { label: 'Employee',       bg: 'bg-slate-100',   text: 'text-slate-700'   },
+};
+// ── Debounce helper ─────────────────────────────────────────────────────────
+let _searchTimer = null;
+function debounce(fn, ms = 350) {
+  return (...args) => {
+    clearTimeout(_searchTimer);
+    _searchTimer = setTimeout(() => fn(...args), ms);
+  };
+}
+// ── HTML escaping ───────────────────────────────────────────────────────────
+function esc(str) {
+  return String(str ?? '')
+    .replace(/&/g, '&amp;').replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+// ── Format Unix timestamp (seconds) to locale date ──────────────────────────
+function formatDate(ts) {
+  if (!ts) return '\u2014';
+  // ZeyOS timestamps are in SECONDS (not ms)
+  const d = new Date(ts * 1000);
+  return d.toLocaleDateString(undefined, {
+    year: 'numeric', month: 'short', day: 'numeric',
+    hour: '2-digit', minute: '2-digit',
+  });
+}
+// ── Boot ─────────────────────────────────────────────────────────────────────
+document.addEventListener('DOMContentLoaded', async () => {
+  const config = resolveConfig();
+  // 1. No URL configured -> show connection screen immediately
+  if (!config.url) {
+    _showConnectionScreen('No ZeyOS URL configured.');
+    return;
+  }
+  runtime.url = config.url;
+  // 2. Tokens available -> initialize in token mode
+  if (config.accessToken) {
+    saveTokens({
+      accessToken:  config.accessToken,
+      refreshToken: config.refreshToken ?? null,
+    });
+    initTokenClient(config.url);
+    runtime.authMode = 'token';
+    await _bootApp();
+    return;
+  }
+  // 3. No tokens -> try session detection
+  showLoading();
+  const userInfo = await trySessionAuth(config.url);
+  hideLoading();
+  if (userInfo) {
+    initSessionClient(config.url);
+    runtime.authMode = 'session';
+    await _bootApp();
+    return;
+  }
+  // 4. Nothing works -> connection screen
+  _showConnectionScreen('Could not connect. Set a token or log into ZeyOS first.');
+});
+// ── Connection Screen ────────────────────────────────────────────────────────
+function _showConnectionScreen(message) {
+  document.getElementById('connection-screen')?.classList.remove('hidden');
+  document.getElementById('app-shell')?.classList.add('hidden');
+  const msgEl = document.getElementById('connection-message');
+  if (msgEl) msgEl.textContent = message;
+}
+// ── Main App Boot ────────────────────────────────────────────────────────────
+async function _bootApp() {
+  document.getElementById('connection-screen')?.classList.add('hidden');
+  document.getElementById('app-shell')?.classList.remove('hidden');
+  _wireEvents();
+  showLoading();
+  try {
+    await _loadAccounts();
+    _renderTable();
+  } catch (err) {
+    if (err?.status === 401) {
+      showToast('Session expired. Please log in again.', 'error');
+      setTimeout(async () => { await logout(); location.reload(); }, 2000);
+      return;
+    }
+    showToast(`Failed to load data: ${err.message}`, 'error');
+  } finally {
+    hideLoading();
+  }
+}
+// ── Data Loading ─────────────────────────────────────────────────────────────
+async function _loadAccounts() {
+  const offset = (runtime.page - 1) * runtime.pageSize;
+  const records = await fetchAccounts({
+    search:    runtime.search || undefined,
+    sortField: runtime.sort.field,
+    sortDir:   runtime.sort.dir,
+    limit:     runtime.pageSize + 1,
+    offset,
+  });
+  runtime.hasNextPage = records.length > runtime.pageSize;
+  runtime.accounts = records.slice(0, runtime.pageSize);
+}
+async function _refresh() {
+  showLoading();
+  try {
+    await _loadAccounts();
+    _renderTable();
+  } catch (err) {
+    showToast(`Refresh failed: ${err.message}`, 'error');
+  } finally {
+    hideLoading();
+  }
+}
+// ── Table Rendering ──────────────────────────────────────────────────────────
+function _renderTable() {
+  const tbody     = document.getElementById('accounts-tbody');
+  const empty     = document.getElementById('empty-state');
+  const pagBar    = document.getElementById('pagination-bar');
+  const accounts  = runtime.accounts;
+  if (!tbody) return;
+  if (accounts.length === 0) {
+    tbody.innerHTML = '';
+    empty?.classList.remove('hidden');
+  } else {
+    empty?.classList.add('hidden');
+    tbody.innerHTML = accounts.map(a => _accountRow(a)).join('');
+  }
+  _updateSortIndicators();
+  _updatePagination();
+}
+function _accountRow(a) {
+  const typeInfo = ACCOUNT_TYPES[a.Type] ?? { label: 'Unknown', bg: 'bg-slate-100', text: 'text-slate-600' };
+  const name     = [a.FirstName, a.Name].filter(Boolean).join(' ') || '\u2014';
+  return `
+    <tr data-id="${esc(a.Id)}" class="transition-colors">
+      <td class="px-4 py-3 text-slate-500 font-mono text-xs">${esc(a.AccountNum) || '\u2014'}</td>
+      <td class="px-4 py-3 font-medium text-slate-800">${esc(name)}</td>
+      <td class="px-4 py-3 text-slate-600">${esc(a.Email) || '\u2014'}</td>
+      <td class="px-4 py-3 text-slate-600">${esc(a.Phone) || '\u2014'}</td>
+      <td class="px-4 py-3 text-slate-600">${esc(a.City) || '\u2014'}</td>
+      <td class="px-4 py-3 text-slate-600">${esc(a.AssignedUser) || '\u2014'}</td>
+      <td class="px-4 py-3">
+        <span class="inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium ${typeInfo.bg} ${typeInfo.text}">
+          ${typeInfo.label}
+        </span>
+      </td>
+      <td class="px-4 py-3 text-slate-500 text-xs whitespace-nowrap">${formatDate(a.LastModified)}</td>
+    </tr>
+  `;
+}
+// ── Sort Indicators ──────────────────────────────────────────────────────────
+function _updateSortIndicators() {
+  document.querySelectorAll('.sortable-col').forEach(th => {
+    th.classList.remove('sort-asc', 'sort-desc', 'text-blue-600');
+    if (th.dataset.sort === runtime.sort.field) {
+      th.classList.add(runtime.sort.dir === 'asc' ? 'sort-asc' : 'sort-desc');
+      th.classList.add('text-blue-600');
+    }
+  });
+}
+// ── Pagination ───────────────────────────────────────────────────────────────
+function _updatePagination() {
+  const count    = runtime.accounts.length;
+  const offset   = (runtime.page - 1) * runtime.pageSize;
+  const infoEl   = document.getElementById('pagination-info');
+  const pageEl   = document.getElementById('page-indicator');
+  const prevBtn  = document.getElementById('btn-prev-page');
+  const nextBtn  = document.getElementById('btn-next-page');
+  if (infoEl) {
+    if (count === 0) {
+      infoEl.textContent = 'No accounts found';
+    } else {
+      infoEl.textContent = `Showing ${offset + 1}\u2013${offset + count} accounts`;
+    }
+  }
+  if (pageEl) {
+    pageEl.textContent = `Page ${runtime.page}`;
+  }
+  if (prevBtn) prevBtn.disabled = (runtime.page <= 1);
+  if (nextBtn) nextBtn.disabled = !runtime.hasNextPage;
+}
+// ── Event Wiring ─────────────────────────────────────────────────────────────
+function _wireEvents() {
+  // -- Search input (debounced) --
+  const searchInput = document.getElementById('search-input');
+  if (searchInput) {
+    searchInput.addEventListener('input', debounce(async () => {
+      runtime.search = searchInput.value;
+      runtime.page   = 1; // Reset to first page on new search
+      await _refresh();
+    }));
+  }
+  // -- Sortable column headers --
+  document.querySelectorAll('.sortable-col').forEach(th => {
+    th.addEventListener('click', async () => {
+      const field = th.dataset.sort;
+      if (!field) return;
+      // Toggle direction if same column, otherwise default to ascending
+      if (runtime.sort.field === field) {
+        runtime.sort.dir = runtime.sort.dir === 'asc' ? 'desc' : 'asc';
+      } else {
+        runtime.sort.field = field;
+        runtime.sort.dir   = 'asc';
+      }
+      runtime.page = 1; // Reset to first page on sort change
+      await _refresh();
+    });
+  });
+  // -- Pagination --
+  document.getElementById('btn-prev-page')?.addEventListener('click', async () => {
+    if (runtime.page > 1) {
+      runtime.page--;
+      await _refresh();
+    }
+  });
+  document.getElementById('btn-next-page')?.addEventListener('click', async () => {
+    if (runtime.hasNextPage) {
+      runtime.page++;
+      await _refresh();
+    }
+  });
+  // -- Reload button --
+  document.getElementById('btn-reload')?.addEventListener('click', async () => {
+    await _refresh();
+  });
+  // -- New Account button --
+  document.getElementById('btn-new-account')?.addEventListener('click', () => {
+    _openModal('create');
+  });
+  // -- Table row click -> open edit modal --
+  document.getElementById('accounts-tbody')?.addEventListener('click', e => {
+    const row = e.target.closest('tr[data-id]');
+    if (!row) return;
+    const id = row.dataset.id;
+    if (id) _openModal('edit', id);
+  });
+  // -- Logout --
+  document.getElementById('btn-logout')?.addEventListener('click', async () => {
+    if (!confirm('Log out of ZeyOS CRM?')) return;
+    await logout();
+    clearUrl();
+    location.reload();
+  });
+  // -- Modal controls --
+  document.getElementById('modal-close')?.addEventListener('click', _closeModal);
+  document.getElementById('btn-cancel')?.addEventListener('click', _closeModal);
+  document.getElementById('account-form')?.addEventListener('submit', _handleFormSubmit);
+  document.getElementById('btn-delete-account')?.addEventListener('click', _handleDelete);
+  // Close modal on backdrop click
+  const dialog = document.getElementById('account-modal');
+  dialog?.addEventListener('click', e => {
+    if (e.target === dialog) _closeModal();
+  });
+}
+// ── Modal Logic ──────────────────────────────────────────────────────────────
+/**
+ * Open the account modal in 'create' or 'edit' mode.
+ * @param {'create'|'edit'} mode
+ * @param {string|number}   [id] - Account ID for edit mode
+ */
+async function _openModal(mode, id) {
+  const dialog         = document.getElementById('account-modal');
+  const title          = document.getElementById('modal-title');
+  const formId         = document.getElementById('form-id');
+  const firstname      = document.getElementById('form-firstname');
+  const lastname       = document.getElementById('form-lastname');
+  const type           = document.getElementById('form-type');
+  const description    = document.getElementById('form-description');
+  const contactSection = document.getElementById('contact-section');
+  const deleteBtn      = document.getElementById('btn-delete-account');
+  const contactEmail   = document.getElementById('contact-email');
+  const contactPhone   = document.getElementById('contact-phone');
+  const contactCity    = document.getElementById('contact-city');
+  if (!dialog) return;
+  if (mode === 'create') {
+    title.textContent = 'New Account';
+    formId.value      = '';
+    firstname.value   = '';
+    lastname.value    = '';
+    type.value        = '0';
+    description.value = '';
+    contactSection?.classList.add('hidden');
+    deleteBtn?.classList.add('hidden');
+    dialog.showModal();
+  } else {
+    title.textContent = 'Edit Account';
+    deleteBtn?.classList.remove('hidden');
+    contactSection?.classList.remove('hidden');
+    showLoading();
+    try {
+      const account = await getAccount(id);
+      formId.value      = account.ID ?? id;
+      firstname.value   = account.firstname ?? '';
+      lastname.value    = account.lastname ?? '';
+      type.value        = String(account.type ?? 0);
+      description.value = account.description ?? '';
+      // Also look up the row in runtime.accounts for the joined contact fields
+      const row = runtime.accounts.find(a => String(a.Id) === String(id));
+      if (contactEmail) contactEmail.textContent = row?.Email   || account.email   || '\u2014';
+      if (contactPhone) contactPhone.textContent = row?.Phone   || account.phone   || '\u2014';
+      if (contactCity)  contactCity.textContent   = row?.City    || account.city    || '\u2014';
+      dialog.showModal();
+    } catch (err) {
+      showToast(`Failed to load account: ${err.message}`, 'error');
+    } finally {
+      hideLoading();
+    }
+  }
+}
+function _closeModal() {
+  document.getElementById('account-modal')?.close();
+}
+/**
+ * Handle form submission -- create or update depending on form-id value.
+ */
+async function _handleFormSubmit(e) {
+  e.preventDefault();
+  const id = document.getElementById('form-id')?.value;
+  const data = {
+    firstname:   document.getElementById('form-firstname')?.value?.trim() || null,
+    lastname:    document.getElementById('form-lastname')?.value?.trim()  || '',
+    type:        Number(document.getElementById('form-type')?.value ?? 0),
+    description: document.getElementById('form-description')?.value?.trim() || null,
+  };
+  if (!data.lastname) {
+    showToast('Last name / company is required.', 'error');
+    return;
+  }
+  showLoading();
+  try {
+    if (id) {
+      await updateAccount(id, data);
+      showToast('Account updated.', 'success');
+    } else {
+      await createAccount(data);
+      showToast('Account created.', 'success');
+    }
+    _closeModal();
+    await _refresh();
+  } catch (err) {
+    showToast(`Save failed: ${err.message}`, 'error');
+  } finally {
+    hideLoading();
+  }
+}
+/**
+ * Handle the delete button inside the edit modal.
+ */
+async function _handleDelete() {
+  const id = document.getElementById('form-id')?.value;
+  if (!id) return;
+  const name = document.getElementById('form-lastname')?.value || 'this account';
+  if (!confirm(`Delete "${name}"? This cannot be undone.`)) return;
+  showLoading();
+  try {
+    await deleteAccount(id);
+    showToast('Account deleted.', 'success');
+    _closeModal();
+    await _refresh();
+  } catch (err) {
+    showToast(`Delete failed: ${err.message}`, 'error');
+  } finally {
+    hideLoading();
+  }
+}
+// ── Console API ──────────────────────────────────────────────────────────────
+// Provides ZeyOS.setUrl(), ZeyOS.setToken(), ZeyOS.status(), etc.
+// Values set via the console are persisted to localStorage and override
+// <body> data attributes on next page load.
+globalThis.ZeyOS = {
+  /**
+   * Set the ZeyOS instance URL.
+   * @param {string} url - e.g. 'https://cloud.zeyos.com/demo/'
+   */
+  setUrl(url) {
+    if (!url || typeof url !== 'string') {
+      console.error('[ZeyOS] Usage: ZeyOS.setUrl("https://cloud.zeyos.com/demo/")');
+      return;
+    }
+    saveUrl(url.trim());
+    console.log(`%c[ZeyOS]%c URL set to: ${url}`, 'color:#2563eb;font-weight:bold', '');
+    console.log('%c[ZeyOS]%c Call ZeyOS.reconnect() to apply.', 'color:#2563eb;font-weight:bold', '');
+  },
+  /**
+   * Set access (and optionally refresh) token.
+   * @param {string} accessToken
+   * @param {string} [refreshToken]
+   */
+  setToken(accessToken, refreshToken) {
+    if (!accessToken || typeof accessToken !== 'string') {
+      console.error('[ZeyOS] Usage: ZeyOS.setToken("access-token", "optional-refresh-token")');
+      return;
+    }
+    saveTokens({
+      accessToken:  accessToken.trim(),
+      refreshToken: refreshToken?.trim() ?? null,
+    });
+    console.log('%c[ZeyOS]%c Token saved.', 'color:#2563eb;font-weight:bold', '');
+    console.log('%c[ZeyOS]%c Call ZeyOS.reconnect() to apply.', 'color:#2563eb;font-weight:bold', '');
+  },
+  /**
+   * Print the current connection status to the console.
+   */
+  status() {
+    const config = resolveConfig();
+    const lines = [
+      '',
+      `  URL:            ${config.url ?? '(not set)'}`,
+      `  Access Token:   ${config.accessToken ? config.accessToken.slice(0, 16) + '...' : '(not set)'}`,
+      `  Refresh Token:  ${config.refreshToken ? 'yes' : 'no'}`,
+      `  Auth Mode:      ${runtime.authMode ?? '(not connected)'}`,
+      `  Page:           ${runtime.page}`,
+      `  Page Size:      ${runtime.pageSize}`,
+      `  Search:         ${runtime.search || '(none)'}`,
+      `  Sort:           ${runtime.sort.field} ${runtime.sort.dir}`,
+      `  Loaded:         ${runtime.accounts.length} accounts`,
+      '',
+    ];
+    console.log(`%c[ZeyOS] Status%c\n${lines.join('\n')}`, 'color:#2563eb;font-weight:bold', 'color:inherit');
+  },
+  /**
+   * Clear all stored config (URL + tokens) and reload.
+   */
+  logout() {
+    clearTokens();
+    clearUrl();
+    console.log('%c[ZeyOS]%c Config cleared. Reloading...', 'color:#2563eb;font-weight:bold', '');
+    location.reload();
+  },
+  /**
+   * Reload the page to re-run the boot sequence with current config.
+   */
+  reconnect() {
+    console.log('%c[ZeyOS]%c Reconnecting...', 'color:#2563eb;font-weight:bold', '');
+    location.reload();
+  },
+};

package/samples/crm/js/state.js ADDED Viewed

@@ -0,0 +1,90 @@
+/**
+ * Application state -- persistence via localStorage, in-memory for runtime data.
+ * Config resolution merges <body> data attributes with localStorage overrides.
+ *
+ * This follows the same pattern as the kanban sample app, using a separate
+ * localStorage namespace (zeyos_crm_*) to avoid collisions.
+ */
+const KEYS = {
+  URL:    'zeyos_crm_url',
+  TOKENS: 'zeyos_crm_tokens',
+};
+// ── helpers ────────────────────────────────────────────────────────────────
+function readJson(key, fallback) {
+  try {
+    const raw = localStorage.getItem(key);
+    return raw != null ? JSON.parse(raw) : fallback;
+  } catch {
+    return fallback;
+  }
+}
+function writeJson(key, value) {
+  try {
+    localStorage.setItem(key, JSON.stringify(value));
+  } catch {
+    // storage full or unavailable -- silently ignore
+  }
+}
+// ── URL ────────────────────────────────────────────────────────────────────
+export function loadUrl()    { return localStorage.getItem(KEYS.URL) ?? null; }
+export function saveUrl(url) { localStorage.setItem(KEYS.URL, url); }
+export function clearUrl()   { localStorage.removeItem(KEYS.URL); }
+// ── Tokens ─────────────────────────────────────────────────────────────────
+export function loadTokens() {
+  return readJson(KEYS.TOKENS, null);
+}
+export function saveTokens(tokens) {
+  writeJson(KEYS.TOKENS, tokens);
+}
+export function clearTokens() {
+  localStorage.removeItem(KEYS.TOKENS);
+}
+// ── Config Resolution ──────────────────────────────────────────────────────
+/**
+ * Resolve effective config by merging <body> data attributes with localStorage.
+ * localStorage values (set via ZeyOS console API) override body attributes.
+ * Returns { url, accessToken, refreshToken }.
+ */
+export function resolveConfig() {
+  const body = document.body;
+  // Body attributes (defaults)
+  const bodyUrl     = body?.dataset.zeyosUrl?.trim()         || null;
+  const bodyAccess  = body?.dataset.zeyosAccesstoken?.trim() || null;
+  const bodyRefresh = body?.dataset.zeyosRefreshtoken?.trim() || null;
+  // localStorage overrides
+  const storedUrl    = loadUrl();
+  const storedTokens = loadTokens();
+  return {
+    url:          storedUrl    || bodyUrl,
+    accessToken:  storedTokens?.accessToken  || bodyAccess,
+    refreshToken: storedTokens?.refreshToken || bodyRefresh,
+  };
+}
+// ── In-memory runtime state (not persisted) ────────────────────────────────
+export const runtime = {
+  url:      null,      // resolved ZeyOS instance URL
+  authMode: null,      // 'token' | 'session' | null
+  accounts: [],        // current page of account records
+  hasNextPage: false,  // true when the next page has at least one record
+  page:     1,         // current page number (1-based)
+  pageSize: 25,        // records per page
+  search:   '',        // current search query
+  sort:     { field: 'LastModified', dir: 'desc' }, // active sort column + direction
+};

package/samples/crm/js/ui.js ADDED Viewed

@@ -0,0 +1,51 @@
+/**
+ * Shared UI utilities: toast notifications + loading overlay.
+ * Same pattern as the kanban sample -- extracted to avoid circular imports.
+ */
+// ── Toast Notifications ────────────────────────────────────────────────────
+/**
+ * Show a brief toast notification in the bottom-right corner.
+ * @param {string}  message
+ * @param {'success'|'error'|'info'} type
+ */
+export function showToast(message, type = 'info') {
+  const container = document.getElementById('toast-container');
+  if (!container) return;
+  const colors = {
+    success: 'bg-emerald-600',
+    error:   'bg-red-600',
+    info:    'bg-slate-700',
+  };
+  const toast = document.createElement('div');
+  toast.className =
+    `pointer-events-auto flex items-center gap-3 px-4 py-3 rounded-xl text-white text-sm shadow-xl ` +
+    `${colors[type] ?? colors.info} translate-y-2 opacity-0 transition-all duration-200`;
+  toast.textContent = message;
+  container.appendChild(toast);
+  // Trigger CSS transition on next frame
+  requestAnimationFrame(() => {
+    requestAnimationFrame(() => toast.classList.remove('translate-y-2', 'opacity-0'));
+  });
+  const duration = type === 'error' ? 5000 : 3000;
+  setTimeout(() => {
+    toast.classList.add('opacity-0', 'translate-y-2');
+    toast.addEventListener('transitionend', () => toast.remove(), { once: true });
+  }, duration);
+}
+// ── Loading Overlay ────────────────────────────────────────────────────────
+export function showLoading() {
+  document.getElementById('loading-overlay')?.classList.remove('hidden');
+}
+export function hideLoading() {
+  document.getElementById('loading-overlay')?.classList.add('hidden');
+}