@kavachos/electron

Electron integration for KavachOS — secure storage, OAuth windows, and IPC bridge.

Install

npm install @kavachos/electron

Usage

Set up the IPC bridge in the main process, then use the provider in the renderer.

// main.ts (main process)
import { setupKavachIpc, createElectronStorage } from '@kavachos/electron';

const storage = createElectronStorage({ encryptionKey: process.env.STORAGE_KEY });
setupKavachIpc({ storage });

// renderer.tsx
import { ElectronKavachProvider, useElectronKavachContext } from '@kavachos/electron';

function App() {
  return (
    <ElectronKavachProvider apiUrl="https://auth.yourapp.com" tenantId="your-tenant-id">
      <MainWindow />
    </ElectronKavachProvider>
  );
}

// OAuth login from renderer
import { openOAuthWindow } from '@kavachos/electron';

const result = await openOAuthWindow({ provider: 'google', redirectUri: 'kavach://oauth' });

Exports

• ElectronKavachProvider / ElectronKavachContext / useElectronKavachContext — renderer-side provider
• createElectronStorage — encrypted keychain-backed storage
• createMemoryStorage — in-memory storage for testing
• setupKavachIpc / createIpcStorage / KAVACH_IPC_CHANNELS — main-process IPC setup
• openOAuthWindow — opens a managed OAuth popup window

Docs

https://docs.kavachos.com

License

MIT