Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

5.7 KB
Raw Blame
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';

import { clearConnectionCache, readConnectionCache, writeConnectionCache } from './connectionCache';
import type { ComposioConnection, ComposioToolkitCatalogEntry } from './types';

const ACTIVE_USER_KEY = 'OPENHUMAN_ACTIVE_USER_ID';

const conn = (toolkit: string, status = 'ACTIVE'): ComposioConnection => ({
  id: `c-${toolkit}`,
  toolkit,
  status,
});
const cat = (slug: string): ComposioToolkitCatalogEntry => ({ slug, name: slug });

describe('connectionCache', () => {
  beforeEach(() => {
    window.localStorage.clear();
    // The module keeps an in-memory mirror; clear it between tests by evicting
    // for whatever user id a prior test may have left active.
    clearConnectionCache();
    window.localStorage.setItem(ACTIVE_USER_KEY, 'user-a');
    clearConnectionCache();
  });

  afterEach(() => {
    vi.useRealTimers();
    window.localStorage.clear();
  });

  it('returns null when nothing is cached', () => {
    expect(readConnectionCache()).toBeNull();
  });

  it('round-trips a written snapshot', () => {
    writeConnectionCache({
      connections: [conn('gmail'), conn('notion')],
      toolkits: ['gmail', 'notion'],
      catalog: [cat('gmail'), cat('notion')],
    });

    const got = readConnectionCache();
    expect(got?.connections.map(c => c.toolkit)).toEqual(['gmail', 'notion']);
    expect(got?.toolkits).toEqual(['gmail', 'notion']);
    expect(got?.catalog.map(c => c.slug)).toEqual(['gmail', 'notion']);
  });

  it('merges a connections-only patch without clobbering toolkit/catalog', () => {
    writeConnectionCache({
      connections: [conn('gmail')],
      toolkits: ['gmail', 'github'],
      catalog: [cat('gmail'), cat('github')],
    });

    // Poll-style refresh: only connections supplied.
    writeConnectionCache({ connections: [conn('gmail'), conn('github')] });

    const got = readConnectionCache();
    expect(got?.connections.map(c => c.toolkit)).toEqual(['gmail', 'github']);
    // Toolkit allowlist + catalog survive the partial write.
    expect(got?.toolkits).toEqual(['gmail', 'github']);
    expect(got?.catalog.map(c => c.slug)).toEqual(['gmail', 'github']);
  });

  it('clears the cached snapshot', () => {
    writeConnectionCache({ connections: [conn('gmail')] });
    expect(readConnectionCache()).not.toBeNull();

    clearConnectionCache();
    expect(readConnectionCache()).toBeNull();
  });

  it('expires snapshots older than the TTL', () => {
    vi.useFakeTimers();
    vi.setSystemTime(new Date('2026-01-01T00:00:00Z'));
    writeConnectionCache({ connections: [conn('gmail')] });
    expect(readConnectionCache()).not.toBeNull();

    // Advance just past the 24h TTL; the in-memory mirror must also respect it.
    vi.setSystemTime(new Date('2026-01-02T00:00:01Z'));
    expect(readConnectionCache()).toBeNull();
  });

  it('namespaces the cache per active user', () => {
    writeConnectionCache({ connections: [conn('gmail')] });
    expect(readConnectionCache()?.connections).toHaveLength(1);

    // Identity flip to user-b — must not see user-a's connections.
    window.localStorage.setItem(ACTIVE_USER_KEY, 'user-b');
    expect(readConnectionCache()).toBeNull();

    writeConnectionCache({ connections: [conn('slack'), conn('github')] });
    expect(readConnectionCache()?.connections.map(c => c.toolkit)).toEqual(['slack', 'github']);

    // Flipping back to user-a restores their original snapshot from disk.
    window.localStorage.setItem(ACTIVE_USER_KEY, 'user-a');
    expect(readConnectionCache()?.connections.map(c => c.toolkit)).toEqual(['gmail']);
  });

  it('returns null on malformed persisted JSON', () => {
    window.localStorage.setItem('user-a:composio:connections:v1', '{ not json');
    expect(readConnectionCache()).toBeNull();
  });

  it('returns null when the persisted shape is invalid', () => {
    window.localStorage.setItem(
      'user-a:composio:connections:v1',
      JSON.stringify({ fetchedAt: Date.now(), connections: 'nope' })
    );
    expect(readConnectionCache()).toBeNull();
  });

  it('namespaces the cache under the user prefix so clearAllAppData purges it', () => {
    writeConnectionCache({ connections: [conn('gmail')] });
    // clearAllAppData removes every `${userId}:` key — the cache must live there.
    expect(window.localStorage.getItem('user-a:composio:connections:v1')).not.toBeNull();
  });

  it('does not revive expired toolkit/catalog via a later connections-only write', () => {
    vi.useFakeTimers();
    vi.setSystemTime(new Date('2026-01-01T00:00:00Z'));
    writeConnectionCache({
      connections: [conn('gmail')],
      toolkits: ['gmail'],
      catalog: [cat('gmail')],
    });

    // Past the TTL: the snapshot is stale. A connections-only poll write must
    // start from an empty base, not resurrect the expired toolkits/catalog.
    vi.setSystemTime(new Date('2026-01-02T00:00:01Z'));
    writeConnectionCache({ connections: [conn('gmail'), conn('notion')] });

    const got = readConnectionCache();
    expect(got?.connections.map(c => c.toolkit)).toEqual(['gmail', 'notion']);
    expect(got?.toolkits).toEqual([]);
    expect(got?.catalog).toEqual([]);
  });

  it('survives a simulated process restart (warm localStorage, cold module memory)', async () => {
    writeConnectionCache({
      connections: [conn('gmail')],
      toolkits: ['gmail'],
      catalog: [cat('gmail')],
    });

    // Drop the module-level in-memory mirror but keep the durable localStorage
    // blob, exactly like a cold app restart, then re-import the module fresh.
    vi.resetModules();
    const fresh = await import('./connectionCache');
    const got = fresh.readConnectionCache();
    expect(got?.connections.map(c => c.toolkit)).toEqual(['gmail']);
    expect(got?.toolkits).toEqual(['gmail']);
  });
});