JavaScript / TypeScript SDK

npm install @nebutra/sdk
# 或
pnpm add @nebutra/sdk

import { createClient } from "@nebutra/sdk";

const nebutra = createClient({
  apiKey: process.env.NEBUTRA_API_KEY!,
  orgId: process.env.NEBUTRA_ORG_ID!,
  retry: { maxAttempts: 3, backoff: "exponential" },
});

import { verifyToken } from "@nebutra/sdk/server";

// 验证 JWT 令牌
const payload = await verifyToken(bearerToken, {
  apiKey: process.env.NEBUTRA_API_KEY!,
});
// payload.userId, payload.orgId, payload.scopes, payload.plan

const org = await nebutra.orgs.get(orgId);
await nebutra.orgs.update(orgId, { name: "新名称" });

const members = await nebutra.members.list({ orgId });
await nebutra.members.invite({ orgId, email: "[email protected]", role: "MEMBER" });
await nebutra.members.remove({ orgId, userId });

const { data, meta } = await nebutra.projects.list({ limit: 20 });
const project = await nebutra.projects.get("proj_123");
const project = await nebutra.projects.create({ name: "我的项目" });
await nebutra.projects.update("proj_123", { name: "新名称" });
await nebutra.projects.delete("proj_123");

import { can, requirePermission } from "@nebutra/sdk/permissions";

const allowed = await can(userId, "project:delete", { orgId });
await requirePermission("project:delete"); // 权限不足时抛出 403

const quota = await nebutra.metering.getQuota("api_calls");
// { limit, used, remaining, percentage, reset_at }

await nebutra.metering.ingest({ metricId: "api_calls", tenantId: orgId, quantity: 1 });

import { NebutraError, NotFoundError, ValidationError, RateLimitError } from "@nebutra/sdk";

try {
  await nebutra.projects.get("proj_123");
} catch (error) {
  if (error instanceof NotFoundError) { return notFound(); }
  if (error instanceof ValidationError) { return { errors: error.fields }; }
  if (error instanceof RateLimitError) { await sleep(error.retryAfter * 1000); }
  if (error instanceof NebutraError) {
    console.error(`[${error.code}] ${error.requestId}`);
    throw error;
  }
}

npm install @nebutra/react

import { useNebutraUser, useNebutraOrg, Can, NebutraProvider } from "@nebutra/react";