Nyxeara Developers

Phase 11 establishes Nyxeara as an extensible platform. This portal holds canonical SDK, API, and extension documentation. The initial skeleton is live; full docs are generated from the platform contracts and will expand incrementally.

What You Can Build

• Tool, Parser, Intelligence, Workflow, Integration, Notification, Report, and UI Extensions
• Normalized parsers and result renderers
• Webhook endpoints with signing and replay protection

SDK Contracts (preview)

export type ExtensionType = 'tool' | 'parser' | 'intelligence' | 'workflow' | 'integration' | 'notification' | 'report' | 'ui' | 'developer';
export interface ExtensionManifest {
  id: string; name: string; version: string; publisher: string; type: ExtensionType; nyxSdk: string;
  permissions?: string[]; capabilities?: string[]; configSchema?: { fields: Array<{ name: string; type: string; required?: boolean }> };
  runtime?: { node?: string; container?: string; entry?: string };
}

Webhook Signing

Outgoing webhooks are signed with HMAC-SHA256. Verify using the helper below.

import { signWebhook, verifyWebhook } from '@nyxeara/sdk/webhooks';
const secret = process.env.NYX_WEBHOOK_SECRET!;
const body = JSON.stringify({ event: 'finding.created', data: { id: 'f_123' } });
// Sender:
const signature = signWebhook(body, secret); // => 't=..., v1=...'
// Receiver:
const ok = verifyWebhook(signature, body, secret, 300);

Lifecycle

1. Validate manifest
2. Install (admin)
3. Verify (admin)
4. Enable/Disable/Revoke (admin)

See Admin → Extensions for the live registry (to be expanded).