Live Mode

{
  slug: 'my-integration',
  name: 'My Integration',
  // ... other fields ...

  definition: asHarnessDefinition(myDefinition),

  live: {
    // Optional: seeds that stay mocked in live mode
    seeds: [
      { queryKey: settingsKey, data: mySettings },
    ],
    // Optional: open in live mode until the toolbar is changed
    default: 'live',
  },
}

Egress to https://unlisted.example.com is not in this integration's allowlist. Declare the origin in the integration's egress list — an exact origin ("https://api.example.com") or a "*." subdomain wildcard ("https://*.example.com") — or call an allowed origin instead. Allowlist changes are a security-posture change reviewed at promotion.

live: {
  seeds: [
    { queryKey: settingsKey, data: { locale: 'en', timezone: 'UTC' } },
  ],
}

import type { IntegrationFetch } from '@ekanos/sdk';
import { useIntegrationFetch } from '@ekanos/sdk/hooks';
import { useQuery } from '@tanstack/react-query';

export async function fetchMyData(fetch: IntegrationFetch, accountId: string) {
  const response = await fetch('https://api.acme.com/v1/data');
  if (!response.ok) throw new Error(`Acme returned ${response.status}`);
  return response.json();
}

function useMyData(accountId: string) {
  const fetch = useIntegrationFetch();

  return useQuery({
    queryKey: ['my-data', accountId],
    queryFn: () => fetchMyData(fetch, accountId),
  });
}

import { useHarnessDataMode } from '@ekanos/harness/hooks';
import { useIntegrationFetch } from '@ekanos/sdk/hooks';

function MyWidget() {
  const mode = useHarnessDataMode(); // 'fixtures' | 'live'
  const fetch = useIntegrationFetch();

  if (mode === 'live') {
    // Render live-mode-only UI
  }
}