secretcarousel-sdk

Node.js SDK for SecretCarousel — the agent-native secret vault.

Install

npm install secretcarousel-sdk

Quick Start

const { SecretCarouselClient } = require('secretcarousel-sdk');

const sc = new SecretCarouselClient({
  apiKey: process.env.SC_API_KEY,
  baseUrl: 'https://secretcarousel.com'
});

// Store a secret (AES-256-GCM encrypted at rest)
const secret = await sc.createSecret({
  name: 'DATABASE_URL',
  value: 'postgres://user:pass@host/db',
  secretType: 'database-credentials'
});

// Retrieve (decrypted on demand)
const result = await sc.getSecret(secret.secretId);
console.log(result.value);

// List all
const secrets = await sc.listSecrets();

Features

• Zero dependencies (Node.js 18+ built-in fetch)
• AES-256-GCM encrypted storage
• Secret versioning and rotation
• Time-limited share links
• Complete audit trail
• Backup and restore

API

| Method | Description | |--------|-------------| | listSecrets(query?) | List secrets (metadata only) | | getSecret(id) | Get secret with decrypted value | | createSecret(data) | Create new secret | | updateSecret(id, data) | Update (creates new version) | | deleteSecret(id) | Delete secret | | rotateSecret(id) | Rotate secret | | exportEnv(query) | Export as .env format | | getAuditLogs(query) | Query audit trail | | createBackup(data) | Create encrypted backup |

Links

• Quick Start: https://secretcarousel.com/docs/quickstart.html
• API Reference: https://secretcarousel.com/api
• CLI: https://www.npmjs.com/package/secretcarousel

License

Proprietary — Tyga.Cloud Ltd. See LICENSE file.