Unofficial Luma SDK

Under construction — not ready for production use.

A TypeScript client for the Luma public API. Not affiliated with or maintained by Luma.

Note: You need a Luma Plus organization to use the API. See the Getting Started guide for setup and authentication.

Install

bun add luma-api

For the CLI:

bun add luma-cli

Setup

Get an API key from Luma API keys (Luma Plus required).

cp .env.example .env
# add LUMA_API_KEY=your-key-here

Usage

import { Luma } from "luma-api";

const luma = new Luma(process.env.LUMA_API_KEY!);

await luma.events.guests.add("evt-abc123", {
  guests: [
    { email: "[email protected]", name: "Jane Doe" },
  ],
});

CLI

After installing luma-cli:

luma whoami
luma events list
luma --help

Local development

From this repo:

bun install
cp .env.example .env   # add your API key
bun run luma whoami
bun test
bun run build

Publish

Publish to npm in this order:

1. luma-api (repo root) — the SDK library
2. luma-cli (cli/) — depends on luma-api

npm login

# from repo root
bun run build:api
npm publish --access public

# from cli/ — update luma-api dependency to "^0.1.0" in cli/package.json first
cd cli && bun run build
npm publish --access public

Verify with npm publish --dry-run before the first release.