JavaScript SDK Installation

Quick Install

Install the Vedika SDK using your preferred package manager:

npm install @vedika/sdk

yarn add @vedika/sdk

pnpm add @vedika/sdk

Requirements

Verify Installation

After installation, verify the SDK is working:

import { VedikaClient } from '@vedika/sdk';

// Check version
console.log(VedikaClient.VERSION); // '2.4.0'

// Initialize client
const vedika = new VedikaClient({
  apiKey: process.env.VEDIKA_API_KEY
});

// Test connection
const health = await vedika.health();
console.log('API Status:', health.status); // 'ok'

TypeScript Setup

The SDK includes TypeScript definitions out of the box. No additional setup required.

import {
  VedikaClient,
  BirthChart,
  KundliMatch,
  Panchang,
  VedikaError
} from '@vedika/sdk';

// Full type safety
const vedika = new VedikaClient({
  apiKey: process.env.VEDIKA_API_KEY!,
  timeout: 30000,
  retries: 3
});

// Response types are fully typed
const chart: BirthChart = await vedika.birthChart({
  datetime: '1990-05-15T10:30:00+05:30',
  latitude: 28.6139,
  longitude: 77.2090
});

CDN Usage (Browser)

For browser-only projects without a build step:

<!-- UMD Bundle -->
<script src="https://unpkg.com/@vedika/sdk@2.4.0/dist/vedika.umd.js"></script>
<script>
  const vedika = new Vedika.Client({
    apiKey: 'your-api-key'
  });

  vedika.panchang({ date: '2026-01-07' })
    .then(data => console.log(data));
</script>

<!-- ES Module -->
<script type="module">
  import { VedikaClient } from 'https://unpkg.com/@vedika/sdk@2.4.0/dist/vedika.esm.js';

  const vedika = new VedikaClient({ apiKey: 'your-api-key' });
</script>

Environment Variables

The SDK automatically reads from environment variables:

# .env file
VEDIKA_API_KEY=vk_live_abc123xyz789
VEDIKA_BASE_URL=https://api.vedika.io  # Optional, defaults to production
VEDIKA_TIMEOUT=30000                    # Optional, milliseconds
VEDIKA_MAX_RETRIES=3                    # Optional

// The SDK auto-detects VEDIKA_API_KEY
import { VedikaClient } from '@vedika/sdk';

// No need to pass apiKey if env var is set
const vedika = new VedikaClient();

Package Contents