The HAVE SDK

import { getAI } from '@happyvertical/ai';
import { getDatabase } from '@happyvertical/sql';

// Adapters accept explicit config...
const ai = await getAI({ type: 'anthropic', apiKey: process.env.ANTHROPIC_API_KEY });
const db = await getDatabase({ type: 'postgres', url: process.env.DATABASE_URL });

// ...or auto-configure from HAVE_* environment variables.
// const ai = await getAI();
// const db = await getDatabase();

// When requirements change, swap providers without touching this code.
const summary = await ai.message('Summarize the latest trends in AI agents.');
await db.insert('summaries', { content: summary.content, created_at: new Date() });

import { getAI } from '@happyvertical/ai';

// OpenAI (default when type is omitted)
const openai = await getAI({ apiKey: process.env.OPENAI_API_KEY });

// Anthropic Claude
const claude = await getAI({ type: 'anthropic', apiKey: process.env.ANTHROPIC_API_KEY });

// Google Gemini
const gemini = await getAI({ type: 'gemini', apiKey: process.env.GEMINI_API_KEY });

// Ollama (local model, no key)
const ollama = await getAI({ type: 'ollama', baseUrl: 'http://localhost:11434' });

// Claude CLI (uses a Claude subscription, no API key)
const cli = await getAI({ type: 'claude-cli', defaultModel: 'sonnet' });

// Same interface regardless of provider:
const reply = await claude.message('Explain generics in one sentence');
for await (const chunk of ollama.stream([{ role: 'user', content: 'Hi' }])) {
  process.stdout.write(chunk.content ?? '');
}

// Pace requests that share a provider budget, and observe every call.
const ai = await getAI({
  type: 'gemini',
  apiKey: process.env.GEMINI_API_KEY,
  defaultModel: 'gemini-2.5-flash',
  rateLimit: { key: 'gemini:shared-batch', requestsPerMinute: 60 },
  usageTags: { app: 'indagator', team: 'news' },
  onUsage: (event) => {
    // event => { provider, model, operation, usage?, duration, timestamp, tags? }
    console.log(
      `[${event.provider}/${event.model}] ${event.operation}: ` +
        `${event.usage?.totalTokens} tokens in ${event.duration}ms`,
    );
  },
});

import { getDatabase } from '@happyvertical/sql';

const db = await getDatabase({ type: 'sqlite', url: 'file:./app.db' });

// Template-literal queries: interpolated values are ALWAYS parameterized
// (never string-concatenated), with per-adapter placeholder handling.
const status = 'active';
const users = await db.many`
  SELECT id, email FROM users WHERE status = ${status} LIMIT 50
`;

// CRUD helpers + transactions.
await db.transaction(async (tx) => {
  const id = await tx.insert('users', { email: 'a@b.com', status });
  await tx.update('profiles', { user_id: id }, { onboarded: true });
});

// PostgreSQL exposes db.vector when pgvector is available.
const pg = await getDatabase({ type: 'postgres', url: process.env.DATABASE_URL });
if (pg.vector) {
  await pg.vector.ensureColumn('documents', 'embedding', 1536);
  const neighbors = await pg.vector.search(
    'documents',
    'embedding',
    queryEmbedding,
    { limit: 5 },
  );
}

import { getCache } from '@happyvertical/cache';

const cache = await getCache({
  provider: 'redis',
  host: 'localhost',
  port: 6379,
  namespace: 'app',
  enableCompression: true,
});

await cache.set('user:123', { name: 'Alice' }, 3600); // TTL in seconds
const user = await cache.get('user:123');

// Same CacheProvider interface for memory, file, redis, and s3 — swap the
// provider, keep the code. Batch ops cut round-trips:
await cache.setMany([{ key: 'a', value: 1 }, { key: 'b', value: 2, ttl: 60 }]);

import { getSecretStore } from '@happyvertical/secrets';
import { getDatabase } from '@happyvertical/sql';

const db = await getDatabase({ type: 'sqlite', url: ':memory:' });

// Envelope encryption: an Application Master Key wraps per-tenant Data
// Encryption Keys, which encrypt the secret values (AES-256-GCM).
const store = await getSecretStore({
  type: 'database',
  db,
  amk: { provider: 'env', keyEnvVar: 'MY_SECRET_KEY', keyId: 'amk-v1' },
});

await store.createTenantKey('tenant-123');
const envelope = await store.encrypt('tenant-123', 'api-key', 'sk_live_xxx');
const value = await store.decrypt('tenant-123', envelope);

// Rotate a tenant key without re-encrypting every secret or downtime.
await store.rotateTenantKey('tenant-123');

import { getFilesystem } from '@happyvertical/files';

// Local disk, Google Drive, or S3 — one interface.
const fs = await getFilesystem({ type: 'local', basePath: '/app/data' });

await fs.write('reports/q3.txt', 'hello');
const buf = await fs.read('reports/q3.txt');
const entries = await fs.list('reports/');