Solvyst Atlas Node.js SDK

Typed Node.js client for Solvyst Atlas Meta APIs.

Install

npm install @solvyst/atlas

Usage

import { SolvystAtlasClient } from "@solvyst/atlas";

const atlas = new SolvystAtlasClient({
  baseUrl: "https://atlasv1.solvyst.com",
  apiKey: process.env.ATLAS_API_KEY!,
});

const countries = await atlas.meta.countries({ search: "india", limit: 10 });
const states = await atlas.meta.states({ countryCode: "IN" });
const phoneCodes = await atlas.meta.phoneCodes({ dialCode: "+91" });

Meta Methods

atlas.meta.geo("india")
atlas.meta.regions({ search: "asia" })
atlas.meta.countries({ iso2: "IN" })
atlas.meta.states({ countryCode: "IN" })
atlas.meta.cities({ stateId: 4026 })
atlas.meta.adminAreas({ countryCode: "US", type: "county" })
atlas.meta.localities({ countryCode: "IN", search: "bhubaneswar" })
atlas.meta.languages({ code: "hi" })
atlas.meta.locales({ countryCode: "IN" })
atlas.meta.postalCodeRules({ countryCode: "IN" })
atlas.meta.phoneNumberRules({ dialCode: "+91" })
atlas.meta.addressFormats({ countryCode: "IN" })
atlas.meta.phoneCodes({ dialCode: "+91" })
atlas.meta.currencies({ search: "INR" })
atlas.meta.timezones({ countryId: 101 })

Errors

Non-2xx responses throw SolvystAtlasError.

try {
  await atlas.meta.countries({ iso2: "IND" });
} catch (error) {
  if (error instanceof SolvystAtlasError) {
    console.log(error.status, error.message);
  }
}