TypeScript SDK

The official Misar.Dev client SDK for TypeScript and JavaScript. This is the reference SDK and exposes the full Misar.Dev API surface. It ships with complete type definitions and runs on any runtime with native fetch (Node.js ≥18, Bun, Deno, edge runtimes).

Installation

npm install @misar/dev
pnpm add @misar/dev

Quick start

import { MisarDevClient } from "@misar/dev";

const client = new MisarDevClient(process.env.MISARDEV_API_KEY!);

const { project } = await client.projects.create({ name: "my-app" });
console.log(project.id);

Configuration

The constructor takes the API key as the first argument and an optional options object:

const client = new MisarDevClient("your-api-key", {
  baseURL: "https://api.misar.io/dev",
  maxRetries: 3,
  timeoutMs: 30_000,
});

Requests send Authorization: Bearer <apiKey>. Responses with status 429, 500, 502, 503, or 504 are retried with exponential backoff up to maxRetries.

Resources

projects

templates

apiKeys

chat

usage

billing

rag

Requires the Pro plan or higher.

analytics

Error handling

Failed requests throw a MisarDevError (with a numeric status and errorType). Transport-level failures throw a MisarDevNetworkError, which extends MisarDevError.

import { MisarDevError, MisarDevNetworkError } from "@misar/dev";

try {
  await client.projects.get("missing-id");
} catch (err) {
  if (err instanceof MisarDevNetworkError) {
    console.error("network failure:", err.message);
  } else if (err instanceof MisarDevError) {
    console.error(err.status, err.errorType, err.message);
  }
}