@citadel/error-tracking

Zero-dependency error tracking SDK for JavaScript and TypeScript with React bindings.

Installation

``bash
npm install @citadel/error-tracking
`

Quick Start

$3

`typescript
import { init } from '@citadel/error-tracking';

init({
endpoint: 'https://citadel.example.com',
apiKey: 'ck_...',
environment: 'production',
release: 'v1.2.3',
});
`

$3

`tsx
import { CitadelErrorBoundary } from '@citadel/error-tracking/react';

function App() {
return (
}>


);
}
`

$3

`tsx
import { useCitadelError } from '@citadel/error-tracking/react';

function MyComponent() {
const { captureError, captureMessage } = useCitadelError();

const handleClick = async () => {
try {
await riskyOperation();
} catch (error) {
captureError(error);
}
};

return Do Something;
}
`

$3

`tsx
import { withCitadelErrorBoundary } from '@citadel/error-tracking/react';

const MyComponent = () =>

#### init(config: CitadelConfig)

Initialize the SDK.

`typescript
init({
endpoint: 'https://citadel.example.com',
apiKey: 'ck_...',
environment: 'production', // optional
release: 'v1.2.3', // optional
captureConsoleErrors: true, // optional
beforeSend: (error) => error, // optional
sampleRate: 1.0, // optional (0-1)
debug: false, // optional
});
`

#### captureError(error: Error, context?: ErrorContext)

Capture an error.

`typescript
try {
riskyOperation();
} catch (error) {
captureError(error, {
extra: { userId: '123' },
});
}
`

#### captureMessage(message: string, context?: ErrorContext)

Capture a message.

`typescript
captureMessage('Something unexpected happened', {
extra: { details: 'Additional context' },
});
`

#### setContext(context: ErrorContext)

Set global context for all errors.

`typescript
setContext({
user: { id: '123', email: 'user@example.com' },
extra: { appVersion: '1.0.0' },
});
`

$3

####

Error boundary component.

`tsx
fallback={} // or function
onError={(error, componentStack) => {}}
context={{ extra: { page: 'dashboard' } }}
>


`

#### withCitadelErrorBoundary(Component, options?)

HOC to wrap component with error boundary.

`tsx
const WrappedComponent = withCitadelErrorBoundary(MyComponent, {
fallback:

#### useCitadelError()

Hook for manual error reporting.

`tsx
const { captureError, captureMessage, setContext, isInitialized } =
useCitadelError();
``

Defensive Features

- Infinite Loop Protection: Error boundary never throws
- Stack Truncation: Stack traces limited to 50KB
- Component Stack Truncation: Limited to 50 frames
- Rate Limiting: Max 100 errors/minute client-side
- Graceful Degradation: App continues if Citadel unreachable

Bundle Size

- Core SDK: ~3KB minified+gzipped
- React bindings: ~2KB minified+gzipped (when imported)
- Total (with React): ~5KB minified+gzipped

License

MIT