dominus-sdk-nodejs 1.0.0

package/dist/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAkRD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAEZ,cAAc,CAAC,EAAE,MAAM;IAKnC;;OAEG;YACW,QAAQ;IAuBtB;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAkJ/D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAGtD;AAKD,wBAAgB,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,aAAa,CAKhE"}

package/dist/lib/client.js

@@ -0,0 +1,374 @@
+/**
+ * Core HTTP Client for Dominus SDK
+ *
+ * Handles JWT management, base64 encoding/decoding, retries, and circuit breaker.
+ */
+import { BASE_URL, resolveToken } from './config.js';
+import { DominusError, AuthenticationError, raiseForStatus, ConnectionError, TimeoutError, } from './errors.js';
+// Constants
+const MAX_RETRIES = 3;
+const REQUEST_TIMEOUT = 30000; // 30 seconds
+// State
+let cachedJwt = null;
+let validated = false;
+// Circuit breaker state
+let circuitState = 'closed';
+let failureCount = 0;
+let lastFailureTime = 0;
+const CIRCUIT_THRESHOLD = 5;
+const CIRCUIT_TIMEOUT = 30000; // 30 seconds
+/**
+ * Base64 encode a JSON object to string
+ */
+function b64Encode(data) {
+    const json = JSON.stringify(data);
+    return Buffer.from(json).toString('base64');
+}
+/**
+ * Base64 decode a string to JSON object
+ */
+function b64Decode(encoded) {
+    const decoded = Buffer.from(encoded, 'base64').toString('utf-8');
+    return JSON.parse(decoded);
+}
+/**
+ * Decode JWT payload without verification (for exp checks only)
+ */
+function decodeJwtPayload(jwt) {
+    const parts = jwt.split('.');
+    if (parts.length !== 3) {
+        throw new Error('Invalid JWT format');
+    }
+    // Base64url decode
+    let payload = parts[1];
+    payload = payload.replace(/-/g, '+').replace(/_/g, '/');
+    const padding = 4 - (payload.length % 4);
+    if (padding !== 4) {
+        payload += '='.repeat(padding);
+    }
+    const decoded = Buffer.from(payload, 'base64').toString('utf-8');
+    return JSON.parse(decoded);
+}
+/**
+ * Calculate exponential backoff with jitter
+ */
+function backoffWithJitter(attempt, baseDelay = 1000, maxDelay = 15000) {
+    const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+    const jitter = delay * 0.5 * Math.random();
+    return delay + jitter;
+}
+/**
+ * Check if circuit breaker allows execution
+ */
+function canExecute() {
+    if (circuitState === 'closed')
+        return true;
+    if (circuitState === 'open') {
+        if (Date.now() - lastFailureTime > CIRCUIT_TIMEOUT) {
+            circuitState = 'half-open';
+            return true;
+        }
+        return false;
+    }
+    // half-open
+    return true;
+}
+/**
+ * Record success for circuit breaker
+ */
+function recordSuccess() {
+    failureCount = 0;
+    circuitState = 'closed';
+}
+/**
+ * Record failure for circuit breaker
+ */
+function recordFailure() {
+    failureCount++;
+    lastFailureTime = Date.now();
+    if (failureCount >= CIRCUIT_THRESHOLD) {
+        circuitState = 'open';
+    }
+}
+/**
+ * Get service JWT by calling /newapi/auth with PSK
+ */
+async function getServiceJwt(pskToken) {
+    if (!canExecute()) {
+        throw new AuthenticationError('Circuit breaker OPEN - too many recent failures. Will retry after recovery timeout.');
+    }
+    const headers = {
+        Authorization: `Bearer ${pskToken}`,
+        'Content-Type': 'text/plain',
+    };
+    const body = b64Encode({ method: 'auth.self', params: {} });
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT);
+        const response = await fetch(`${BASE_URL}/newapi/auth`, {
+            method: 'POST',
+            headers,
+            body,
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+            recordFailure();
+            throw new AuthenticationError(`Auth failed with status ${response.status}`);
+        }
+        const text = await response.text();
+        const result = b64Decode(text);
+        if (!result.success) {
+            recordFailure();
+            throw new AuthenticationError(result.error || 'Unknown auth error');
+        }
+        const jwt = result.data?.access_token || result.data?.token;
+        if (!jwt) {
+            recordFailure();
+            throw new AuthenticationError('No JWT token in auth response');
+        }
+        recordSuccess();
+        return jwt;
+    }
+    catch (error) {
+        if (error instanceof DominusError)
+            throw error;
+        recordFailure();
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new TimeoutError('JWT request timed out');
+        }
+        throw new ConnectionError(`Failed to get JWT: ${error}`);
+    }
+}
+/**
+ * Ensure we have a valid JWT, fetching and caching if needed
+ */
+async function ensureValidJwt(pskToken) {
+    // Check cached JWT
+    if (cachedJwt) {
+        try {
+            const payload = decodeJwtPayload(cachedJwt);
+            const exp = payload.exp || 0;
+            const currentTime = Math.floor(Date.now() / 1000);
+            // Refresh if <60 seconds remain
+            if (exp - currentTime > 60) {
+                return cachedJwt;
+            }
+        }
+        catch {
+            // If decode fails, fetch new JWT
+        }
+    }
+    // Fetch new JWT
+    const jwt = await getServiceJwt(pskToken);
+    cachedJwt = jwt;
+    return jwt;
+}
+/**
+ * Verify token with server
+ */
+async function verifyTokenWithServer(token) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 5000);
+    try {
+        const response = await fetch(`${BASE_URL}/verify`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ token }),
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+            throw new AuthenticationError(`Token verification failed: ${response.status}`);
+        }
+        const result = (await response.json());
+        if (!result.valid) {
+            throw new AuthenticationError(result.error || 'Invalid token');
+        }
+        return true;
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        if (error instanceof DominusError)
+            throw error;
+        throw new ConnectionError(`Token verification failed: ${error}`);
+    }
+}
+/**
+ * Health check
+ */
+async function healthCheck() {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 5000);
+    const start = Date.now();
+    try {
+        const response = await fetch(`${BASE_URL}/newapi/health`, {
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        const latency = Date.now() - start;
+        if (!response.ok) {
+            return {
+                status: 'unhealthy',
+                error: `HTTP ${response.status}`,
+                latency_ms: latency,
+            };
+        }
+        const data = (await response.json());
+        return {
+            status: data.status || 'healthy',
+            latency_ms: latency,
+            ...data,
+        };
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        return {
+            status: 'unhealthy',
+            error: String(error),
+        };
+    }
+}
+/**
+ * Main Dominus client class
+ */
+export class DominusClient {
+    token;
+    baseUrl;
+    constructor(hardcodedToken) {
+        this.token = resolveToken(hardcodedToken);
+        this.baseUrl = BASE_URL;
+    }
+    /**
+     * Validate token on first use
+     */
+    async validate() {
+        if (validated)
+            return;
+        if (!this.token) {
+            throw new AuthenticationError('DOMINUS_TOKEN not found.\n\n' +
+                'Production:\n  export DOMINUS_TOKEN=your_token\n\n' +
+                'Development:\n  Pass token to createDominus({ token: "..." })');
+        }
+        // Verify token
+        await verifyTokenWithServer(this.token);
+        // Health check
+        const health = await healthCheck();
+        if (health.status !== 'healthy') {
+            throw new DominusError(`Services unhealthy: ${JSON.stringify(health)}`);
+        }
+        validated = true;
+    }
+    /**
+     * Make an authenticated request to the orchestrator
+     */
+    async request(options) {
+        await this.validate();
+        const { endpoint, method = 'POST', body = {} } = options;
+        // Get JWT
+        const jwt = await ensureValidJwt(this.token);
+        // Prepare request
+        const headers = {
+            Authorization: `Bearer ${jwt}`,
+            'Content-Type': 'text/plain',
+        };
+        const encodedBody = b64Encode(body);
+        // Retry loop
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT);
+                let response;
+                if (method === 'GET') {
+                    // For GET requests, we don't send body
+                    response = await fetch(`${this.baseUrl}${endpoint}`, {
+                        method: 'GET',
+                        headers: {
+                            Authorization: `Bearer ${jwt}`,
+                        },
+                        signal: controller.signal,
+                    });
+                }
+                else {
+                    response = await fetch(`${this.baseUrl}${endpoint}`, {
+                        method,
+                        headers,
+                        body: encodedBody,
+                        signal: controller.signal,
+                    });
+                }
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    // Try to decode error response
+                    let errorMessage = `HTTP ${response.status}`;
+                    let errorDetails = {};
+                    try {
+                        const errorText = await response.text();
+                        const decoded = b64Decode(errorText);
+                        errorMessage =
+                            decoded.error ||
+                                decoded.detail ||
+                                errorMessage;
+                        errorDetails = decoded;
+                    }
+                    catch {
+                        // Use default error message
+                    }
+                    // Don't retry 4xx errors
+                    if (response.status >= 400 && response.status < 500) {
+                        raiseForStatus(response.status, errorMessage, errorDetails, endpoint);
+                    }
+                    // Retry 5xx errors
+                    if (attempt === MAX_RETRIES - 1) {
+                        raiseForStatus(response.status, errorMessage, errorDetails, endpoint);
+                    }
+                    const delay = backoffWithJitter(attempt);
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                    continue;
+                }
+                // Decode successful response
+                const text = await response.text();
+                const result = b64Decode(text);
+                // Handle wrapped response format
+                if ('success' in result && result.success === false) {
+                    throw new DominusError(result.error || 'Unknown error', undefined, undefined, endpoint);
+                }
+                // Return data field if present, otherwise the whole result
+                if ('data' in result && result.data !== undefined) {
+                    return result.data;
+                }
+                return result;
+            }
+            catch (error) {
+                if (error instanceof DominusError)
+                    throw error;
+                if (error instanceof Error && error.name === 'AbortError') {
+                    if (attempt === MAX_RETRIES - 1) {
+                        throw new TimeoutError('Request timed out', undefined, undefined, endpoint);
+                    }
+                }
+                if (attempt === MAX_RETRIES - 1) {
+                    throw new ConnectionError(`Request failed after ${MAX_RETRIES} retries: ${error}`, undefined, undefined, endpoint);
+                }
+                const delay = backoffWithJitter(attempt);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        throw new ConnectionError(`Request failed after ${MAX_RETRIES} retries`, undefined, undefined, endpoint);
+    }
+    /**
+     * Health check endpoint
+     */
+    async healthCheck() {
+        return healthCheck();
+    }
+}
+// Export singleton factory
+let clientInstance = null;
+export function getClient(hardcodedToken) {
+    if (!clientInstance) {
+        clientInstance = new DominusClient(hardcodedToken);
+    }
+    return clientInstance;
+}
+//# sourceMappingURL=client.js.map

package/dist/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"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"}

package/dist/lib/config.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Dominus Orchestrator Configuration
+ *
+ * Single backend URL for all services. The SDK targets dominus-orchestrator
+ * which consolidates all service functionality.
+ */
+export declare const BASE_URL = "https://dominus-orchestrator-production-775398158805.us-east4.run.app";
+/**
+ * Get the dominus-orchestrator base URL.
+ */
+export declare function getBaseUrl(): string;
+/**
+ * Resolve authentication token.
+ *
+ * Priority:
+ * 1. Environment variable: DOMINUS_TOKEN
+ * 2. Hardcoded fallback (if provided)
+ */
+export declare function resolveToken(hardcodedToken?: string): string | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,eAAO,MAAM,QAAQ,0EAAgF,CAAC;AAEtG;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASnE"}

package/dist/lib/config.js

@@ -0,0 +1,35 @@
+/**
+ * Dominus Orchestrator Configuration
+ *
+ * Single backend URL for all services. The SDK targets dominus-orchestrator
+ * which consolidates all service functionality.
+ */
+// Cloud Run configuration
+const PROJECT_NUMBER = '775398158805';
+const REGION = 'us-east4';
+// Single orchestrator URL - all services consolidated here
+export const BASE_URL = `https://dominus-orchestrator-production-${PROJECT_NUMBER}.${REGION}.run.app`;
+/**
+ * Get the dominus-orchestrator base URL.
+ */
+export function getBaseUrl() {
+    return BASE_URL;
+}
+/**
+ * Resolve authentication token.
+ *
+ * Priority:
+ * 1. Environment variable: DOMINUS_TOKEN
+ * 2. Hardcoded fallback (if provided)
+ */
+export function resolveToken(hardcodedToken) {
+    const token = process.env.DOMINUS_TOKEN;
+    if (token) {
+        return token;
+    }
+    if (hardcodedToken) {
+        return hardcodedToken;
+    }
+    return null;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0BAA0B;AAC1B,MAAM,cAAc,GAAG,cAAc,CAAC;AACtC,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,2DAA2D;AAC3D,MAAM,CAAC,MAAM,QAAQ,GAAG,2CAA2C,cAAc,IAAI,MAAM,UAAU,CAAC;AAEtG;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,cAAuB;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACxC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Dominus SDK Error Classes
+ *
+ * Custom exceptions for the Dominus SDK with structured error information.
+ */
+export interface ErrorDetails {
+    [key: string]: unknown;
+}
+/**
+ * Base exception for all Dominus SDK errors.
+ */
+export declare class DominusError extends Error {
+    readonly statusCode?: number;
+    readonly details: ErrorDetails;
+    readonly endpoint?: string;
+    constructor(message: string, statusCode?: number, details?: ErrorDetails, endpoint?: string);
+    toString(): string;
+}
+/**
+ * Raised when authentication fails (invalid token, expired JWT, etc.).
+ */
+export declare class AuthenticationError extends DominusError {
+    constructor(message?: string, statusCode?: number, details?: ErrorDetails, endpoint?: string);
+}
+/**
+ * Raised when authorization fails (insufficient permissions).
+ */
+export declare class AuthorizationError extends DominusError {
+    constructor(message?: string, statusCode?: number, details?: ErrorDetails, endpoint?: string);
+}
+/**
+ * Raised when a requested resource is not found.
+ */
+export declare class NotFoundError extends DominusError {
+    constructor(message?: string, statusCode?: number, details?: ErrorDetails, endpoint?: string);
+}
+/**
+ * Raised when request validation fails.
+ */
+export declare class ValidationError extends DominusError {
+    constructor(message?: string, statusCode?: number, details?: ErrorDetails, endpoint?: string);
+}
+/**
+ * Raised when there's a conflict (duplicate key, version mismatch, etc.).
+ */
+export declare class ConflictError extends DominusError {
+    constructor(message?: string, statusCode?: number, details?: ErrorDetails, endpoint?: string);
+}
+/**
+ * Raised when a backend service error occurs.
+ */
+export declare class ServiceError extends DominusError {
+    constructor(message?: string, statusCode?: number, details?: ErrorDetails, endpoint?: string);
+}
+/**
+ * Raised when connection to the backend fails.
+ */
+export declare class ConnectionError extends DominusError {
+    constructor(message?: string, statusCode?: number, details?: ErrorDetails, endpoint?: string);
+}
+/**
+ * Raised when a request times out.
+ */
+export declare class TimeoutError extends DominusError {
+    constructor(message?: string, statusCode?: number, details?: ErrorDetails, endpoint?: string);
+}
+/**
+ * Raised when accessing a secure table without providing a reason.
+ */
+export declare class SecureTableError extends DominusError {
+    constructor(message?: string, statusCode?: number, details?: ErrorDetails, endpoint?: string);
+}
+/**
+ * Raise appropriate DominusError subclass based on status code.
+ */
+export declare function raiseForStatus(statusCode: number, message: string, details?: ErrorDetails, endpoint?: string): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,OAAO,EAAE,YAAY,CAAC;IACtC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAGhC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM;IAcnB,QAAQ,IAAI,MAAM;CAUnB;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;gBAEjD,OAAO,SAA0B,EACjC,UAAU,SAAM,EAChB,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM;CAKpB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBAEhD,OAAO,SAAsB,EAC7B,UAAU,SAAM,EAChB,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM;CAKpB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBAE3C,OAAO,SAAuB,EAC9B,UAAU,SAAM,EAChB,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM;CAKpB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBAE7C,OAAO,SAAsB,EAC7B,UAAU,SAAM,EAChB,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM;CAKpB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;gBAE3C,OAAO,SAAa,EACpB,UAAU,SAAM,EAChB,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM;CAKpB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;gBAE1C,OAAO,SAAkB,EACzB,UAAU,SAAM,EAChB,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM;CAKpB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;gBAE7C,OAAO,SAAsB,EAC7B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM;CAKpB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;gBAE1C,OAAO,SAAsB,EAC7B,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM;CAKpB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBAE9C,OAAO,SAAuD,EAC9D,UAAU,SAAM,EAChB,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM;CAKpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,KAAK,CAeP"}

package/dist/lib/errors.js

@@ -0,0 +1,134 @@
+/**
+ * Dominus SDK Error Classes
+ *
+ * Custom exceptions for the Dominus SDK with structured error information.
+ */
+/**
+ * Base exception for all Dominus SDK errors.
+ */
+export class DominusError extends Error {
+    statusCode;
+    details;
+    endpoint;
+    constructor(message, statusCode, details, endpoint) {
+        super(message);
+        this.name = 'DominusError';
+        this.statusCode = statusCode;
+        this.details = details || {};
+        this.endpoint = endpoint;
+        // Maintains proper stack trace for where error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    toString() {
+        const parts = [this.message];
+        if (this.statusCode) {
+            parts.push(`(status ${this.statusCode})`);
+        }
+        if (this.endpoint) {
+            parts.push(`at ${this.endpoint}`);
+        }
+        return parts.join(' ');
+    }
+}
+/**
+ * Raised when authentication fails (invalid token, expired JWT, etc.).
+ */
+export class AuthenticationError extends DominusError {
+    constructor(message = 'Authentication failed', statusCode = 401, details, endpoint) {
+        super(message, statusCode, details, endpoint);
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * Raised when authorization fails (insufficient permissions).
+ */
+export class AuthorizationError extends DominusError {
+    constructor(message = 'Permission denied', statusCode = 403, details, endpoint) {
+        super(message, statusCode, details, endpoint);
+        this.name = 'AuthorizationError';
+    }
+}
+/**
+ * Raised when a requested resource is not found.
+ */
+export class NotFoundError extends DominusError {
+    constructor(message = 'Resource not found', statusCode = 404, details, endpoint) {
+        super(message, statusCode, details, endpoint);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Raised when request validation fails.
+ */
+export class ValidationError extends DominusError {
+    constructor(message = 'Validation failed', statusCode = 400, details, endpoint) {
+        super(message, statusCode, details, endpoint);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Raised when there's a conflict (duplicate key, version mismatch, etc.).
+ */
+export class ConflictError extends DominusError {
+    constructor(message = 'Conflict', statusCode = 409, details, endpoint) {
+        super(message, statusCode, details, endpoint);
+        this.name = 'ConflictError';
+    }
+}
+/**
+ * Raised when a backend service error occurs.
+ */
+export class ServiceError extends DominusError {
+    constructor(message = 'Service error', statusCode = 500, details, endpoint) {
+        super(message, statusCode, details, endpoint);
+        this.name = 'ServiceError';
+    }
+}
+/**
+ * Raised when connection to the backend fails.
+ */
+export class ConnectionError extends DominusError {
+    constructor(message = 'Connection failed', statusCode, details, endpoint) {
+        super(message, statusCode, details, endpoint);
+        this.name = 'ConnectionError';
+    }
+}
+/**
+ * Raised when a request times out.
+ */
+export class TimeoutError extends DominusError {
+    constructor(message = 'Request timed out', statusCode, details, endpoint) {
+        super(message, statusCode, details, endpoint);
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Raised when accessing a secure table without providing a reason.
+ */
+export class SecureTableError extends DominusError {
+    constructor(message = "Access to secure table requires 'reason' parameter", statusCode = 403, details, endpoint) {
+        super(message, statusCode, details, endpoint);
+        this.name = 'SecureTableError';
+    }
+}
+/**
+ * Raise appropriate DominusError subclass based on status code.
+ */
+export function raiseForStatus(statusCode, message, details, endpoint) {
+    const errorClasses = {
+        400: ValidationError,
+        401: AuthenticationError,
+        403: AuthorizationError,
+        404: NotFoundError,
+        409: ConflictError,
+        500: ServiceError,
+        502: ServiceError,
+        503: ServiceError,
+        504: TimeoutError,
+    };
+    const ErrorClass = errorClasses[statusCode] || DominusError;
+    throw new ErrorClass(message, statusCode, details, endpoint);
+}
+//# sourceMappingURL=errors.js.map