@ballelakka/elv-sdk

SDK + CLI + framework adapters for the ELV voice support widget.

v1.0.0-alpha — full release at v1.0.0.

npm install @ballelakka/elv-sdk

Three ways to use it

1. CLI (recommended for most projects)

npx elv init       # OAuth login + framework auto-detect
npx elv sync       # extract + push all your content

2. Framework adapter (zero customer code beyond one import)

// Next.js
import { withElv } from "@ballelakka/elv-sdk/next";
export default withElv({})(nextConfig);

// React SPA
import { ElvProvider } from "@ballelakka/elv-sdk/react";
<ElvProvider apiKey={env.ELV_API_KEY}>{children}</ElvProvider>

// Vue 3
import { ElvPlugin } from "@ballelakka/elv-sdk/vue";
app.use(ElvPlugin, { apiKey: env.ELV_API_KEY });

3. Programmatic API (for custom integrations)

import { ElvClient } from "@ballelakka/elv-sdk";

const elv = new ElvClient({ apiKey: process.env.ELV_API_KEY! });

// Push a batch directly:
await elv.upsertDocuments({
  documents: [{ externalId: "faq-1", body: "..." }],
});

// Or auto-sync from a URL list:
await elv.syncFromSitemap("https://your-site.com/sitemap.xml");

Documentation

Full docs: https://elv.ballelakka.in/docs/sdk

License

MIT