JavaScript SDK

The lunary module is lightweight and works with Node JS, Deno, Cloudflare Workers, Vercel Edge functions and even Bun.

npm install lunary

compatibility_flags = [ "nodejs_compat" ]

Start by importing the lunary module:

import lunary from "lunary"

If you're using in the browser, import like this:

import lunary from "lunary/browser"

Then initialize the module with your unique app ID.

Option 1: Automatic using environment variables (recommended):

LUNARY_PUBLIC_KEY="PUBLIC KEY"

Option 2: Manually using the .init method:

// Initialize the Lunary module with your unique app ID
lunary.init({
  publicKey: "PUBLIC KEY",
})

The .init method accepts the following arguments:

{
  "appId": string, // Your unique app ID obtained from the dashboard
  "apiUrl": string, // Optional: Use a custom endpoint if you're self-hosting (you can also set LUNARY_API_URL)
  "verbose": boolean // Optional: Enable verbose logging for debugging
}