Node.js SDK Quickstart

The @centure/node-sdk package provides type-safe TypeScript support for detecting prompt injection attacks in your Node.js applications.

Installation

Install the package

Install the SDK using your preferred package manager:

npm install @centure/node-sdk

yarn add @centure/node-sdk

pnpm add @centure/node-sdk

Get your API key

Obtain your API key from the Centure dashboard. Store it securely in your environment variables.

Never commit API keys to version control. Use environment variables or a secrets manager.

Initialize the client

Create a client instance with your API key:

import { CentureClient } from "@centure/node-sdk";

// Using environment variable
const client = new CentureClient();

// Or provide API key directly
const client = new CentureClient({
  apiKey: "your-api-key",
  baseUrl: "https://api.centure.ai", // Optional
});

Set the CENTURE_API_KEY environment variable to avoid passing the API key in code.

Scan Text Content

Detect prompt injection attempts in text messages, user inputs, or prompts:

const result = await client.scanText("Your text content here");

console.log("Is safe:", result.is_safe);
console.log("Detected categories:", result.categories);
console.log("Request ID:", result.request_id);

Response Example

{
  "is_safe": false,
  "categories": [
    {
      "code": "context_injection",
      "confidence": "high"
    }
  ],
  "request_id": "req_abc123",
  "api_key_id": "key_xyz789",
  "request_units": 1,
  "service_tier": "standard"
}

Scan Images

Detect text-based prompt injection in images using base64 encoding or Buffer objects:

Base64 String
Buffer (Node.js)

const base64Image = "iVBORw0KGgoAAAANSUhEUgAA...";
const result = await client.scanImage(base64Image);

console.log("Is safe:", result.is_safe);
console.log("Detected threats:", result.categories);

import fs from "fs";

const imageBuffer = fs.readFileSync("./image.png");
const result = await client.scanImage(imageBuffer);

console.log("Is safe:", result.is_safe);

The SDK automatically converts Buffer objects to base64 format for transmission.

Error Handling

Handle specific error scenarios with typed error classes:

import {
  CentureClient,
  BadRequestError,
  UnauthorizedError,
  PayloadTooLargeError,
  MissingApiKeyError,
} from "@centure/node-sdk";

try {
  const result = await client.scanText("content");
} catch (error) {
  if (error instanceof UnauthorizedError) {
    console.error("Invalid API key");
  } else if (error instanceof BadRequestError) {
    console.error("Invalid request:", error.message);
  } else if (error instanceof PayloadTooLargeError) {
    console.error("Image exceeds size limit");
  } else if (error instanceof MissingApiKeyError) {
    console.error("API key not provided");
  }
}

Next Steps

API Reference

Explore response types, threat categories, and advanced configuration options

MCP Integration

Secure Model Context Protocol applications with automatic scanning

npm Package

View package details and version history on npm

GitHub Repository

View source code, report issues, and contribute

Getting Started

API Reference

Security Concepts

SDKs

Pricing

Monitoring & Logs

Node.js SDK Quickstart

Installation

Scan Text Content

Response Example

Scan Images

Error Handling

Next Steps

API Reference

MCP Integration

npm Package

GitHub Repository

​Installation

​Scan Text Content

​Response Example

​Scan Images

​Error Handling

​Next Steps

API Reference

MCP Integration

npm Package

GitHub Repository

Installation

Scan Text Content

Response Example

Scan Images

Error Handling

Next Steps