fix: export REPError and document all getSecure() throw conditions

[olamide226]

Summary

• Exports REPError from @rep-protocol/sdk — it was defined but not exported, making instanceof REPError checks impossible for consumers
• Documents all four getSecure() throw conditions in the SDK reference (key not found, endpoint unreachable, key expired, decryption failure)
• Adds a complete try/catch example with correct REPError import

Test plan

• Verify import { REPError } from '@rep-protocol/sdk' resolves after build
• Verify instanceof REPError works in a catch block
• Review docs example renders correctly in Astro/Starlight

[Copilot]

Pull request overview

This PR makes REPError part of the public SDK surface so consumers can reliably import it, and updates the SDK reference docs to enumerate getSecure() failure modes and show a try/catch example using REPError.

Changes:

• Export REPError from @rep-protocol/sdk (sdk/src/index.ts).
• Expand getSecure() “Throws” documentation and add an example that imports REPError (docs/.../sdk.mdx).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
sdk/src/index.ts	Makes REPError a named export so consumers can import it for error handling.
docs/src/content/docs/reference/sdk.mdx	Updates getSecure() docs with explicit throw cases and a try/catch example referencing REPError.

Comments suppressed due to low confidence (1)

sdk/src/index.ts:51

• Exporting REPError enables instanceof checks, but getSecure() can still reject with non-REPError exceptions (e.g. fetch() network rejections, invalid JSON/base64, WebCrypto import/decrypt errors). That makes consumer instanceof REPError handling incomplete and also conflicts with the docs’ claim that decryption/network failures throw REPError. Consider catching errors inside _loadSensitiveVars() (and the await _sensitiveLoadPromise path) and rethrowing a REPError (optionally using the cause field) so all getSecure() failures are consistently typed.

export class REPError extends Error {
  constructor(message: string) {
    super(`[REP] ${message}`);
    this.name = 'REPError';
  }

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.