TypeScript SDK

npm install @neuraldraft/sdk

import { NeuralDraftClient } from "@neuraldraft/sdk";

const nd = NeuralDraftClient.fromEnv(); // reads NEURALDRAFT_API_KEY
// or: new NeuralDraftClient({ apiKey: process.env.NEURALDRAFT_API_KEY! })

const project = await nd.projects.me();

import { NeuralDraftWorkspaces } from "@neuraldraft/sdk";

// NEURALDRAFT_API_KEYS="villa-lavanda=ndsk_live_…,linden-bakery=ndsk_live_…"
// NEURALDRAFT_WORKSPACE="linden-bakery"   (optional: the active one)
const ws = NeuralDraftWorkspaces.fromEnv();
// or: new NeuralDraftWorkspaces({ keys: { "villa-lavanda": "ndsk_live_…", "linden-bakery": "ndsk_live_…" } })

for (const name of ws.names()) {
  const { meta } = await ws.get(name).bookings.list({ status: "pending" });
  console.log(name, meta.total, "bookings waiting");
}

ws.use("villa-lavanda");
await ws.current.siteTexts.list();

const { blocks } = await nd.siteTexts.list({ search: "hours" });

await nd.siteTexts.update({
  texts: { hours: "Mon–Sat 6:00–14:00" },          // simple HTML: b, i, a, br
  images: { hero: "https://cdn.example.com/new-hero.webp" },
  lang: "en",                                      // default: the site's default language
});
// { language: "en", changed: ["hours", "hero"], unknown: [] }

// Bookings
const pending = await nd.bookings.list({ status: "pending" });
await nd.bookings.confirm(pending.data[0].id);
const free = await nd.booking.availability({ service_id: 12, from: "2026-11-02", to: "2026-11-06" });

// Blog: your own post (free) or one researched and written by Neural Draft (60 credits)
const post = await nd.blogPosts.create({ title: "Our new rye", content: "<p>…</p>", language_code: "en" });
const job = await nd.blogPosts.generateAi({ topic: "How to store sourdough", word_count: 1200 });
await nd.jobs.poll(job.id);

// Shop
const orders = await nd.orders.list({ status: "paid" });
await nd.orders.update(orders.data[0].id, { status: "shipped", tracking_number: "RM123456GB" });

// nd.js on another website
await nd.projects.update({ allowed_origins: ["https://www.client.co.uk"] });

import { ApiError } from "@neuraldraft/sdk";

try {
  await nd.blogPosts.generateAi({ topic: "…" });
} catch (err) {
  if (err instanceof ApiError) {
    const { code } = JSON.parse(err.body || "{}") as { code?: string };
    if (err.status === 402) { /* out of credits */ }
    else if (err.status === 429) { /* rate limited: back off */ }
    else throw err;
  }
}