SDKs

npm install @luxxon/sdk

import { Luxxon } from "@luxxon/sdk";

const lx = new Luxxon({ apiKey: process.env.LUXXON_API_KEY });

// Headline: open a session, dispatch an operator, wait for LIVE.
const { session, viewer } = await lx.requestLiveView({
  lat: 4.71, lng: -74.05,
  maxDurationSeconds: 30,
});

// Pull the latest decoded frame as JPEG bytes
const { bytes, contentType } = await lx.sessions.frame(session.id);
// Hand `bytes` to any vision model

// Or hand `viewer.whepUrl` to a WebRTC player for a live stream
console.log(viewer.whepUrl);

// End it whenever
await lx.sessions.end(session.id);

const data = await lx.json("/some-new-endpoint");
const res  = await lx.raw("/some-new-endpoint", { method: "POST" });

new Luxxon({ apiKey: "lxxn_test_..." });
new Luxxon({ bearer: "Bearer lxxn_test_..." });
new Luxxon({ cookie: "lx_session=eyJ..." });   // browser / SSR

import type { LuxxonError } from "@luxxon/sdk";

try {
  await lx.sessions.frame(id);
} catch (err) {
  const e = err as LuxxonError;
  if (e.code === "FRAME_NOT_AVAILABLE") {
    // first keyframe hasn't arrived — retry in 1s
  } else if (e.code === "NO_COVERAGE") {
    // no operator in range
  }
}