dominus-sdk-nodejs-staging 1.2.4

package/dist/lib/cache.js

@@ -0,0 +1,237 @@
+/**
+ * Internal cache with automatic encryption and circuit breaker.
+ *
+ * NOT exposed to SDK users - internal use only.
+ */
+import crypto from 'crypto';
+/**
+ * Circuit breaker states.
+ */
+var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "closed";
+    CircuitState["OPEN"] = "open";
+    CircuitState["HALF_OPEN"] = "half_open";
+})(CircuitState || (CircuitState = {}));
+/**
+ * Simple circuit breaker to prevent runaway retries.
+ *
+ * States:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Too many failures, requests blocked
+ * - HALF_OPEN: Testing if service recovered
+ *
+ * Prevents CPU/quota exhaustion from retry storms.
+ */
+export class CircuitBreaker {
+    failureThreshold;
+    recoveryTimeout;
+    halfOpenMaxCalls;
+    failureCount = 0;
+    state = CircuitState.CLOSED;
+    lastFailureTime = 0;
+    halfOpenCalls = 0;
+    constructor(failureThreshold = 5, recoveryTimeout = 30000, // 30 seconds in ms
+    halfOpenMaxCalls = 1) {
+        this.failureThreshold = failureThreshold;
+        this.recoveryTimeout = recoveryTimeout;
+        this.halfOpenMaxCalls = halfOpenMaxCalls;
+    }
+    /**
+     * Get current state, transitioning OPEN→HALF_OPEN if timeout elapsed.
+     */
+    getState() {
+        if (this.state === CircuitState.OPEN) {
+            if (Date.now() - this.lastFailureTime >= this.recoveryTimeout) {
+                this.state = CircuitState.HALF_OPEN;
+                this.halfOpenCalls = 0;
+            }
+        }
+        return this.state;
+    }
+    /**
+     * Check if a request can be executed.
+     */
+    canExecute() {
+        const state = this.getState();
+        if (state === CircuitState.CLOSED) {
+            return true;
+        }
+        if (state === CircuitState.HALF_OPEN) {
+            return this.halfOpenCalls < this.halfOpenMaxCalls;
+        }
+        return false; // OPEN
+    }
+    /**
+     * Record a successful call.
+     */
+    recordSuccess() {
+        if (this.state === CircuitState.HALF_OPEN) {
+            this.state = CircuitState.CLOSED;
+        }
+        this.failureCount = 0;
+        this.halfOpenCalls = 0;
+    }
+    /**
+     * Record a failed call.
+     */
+    recordFailure() {
+        this.failureCount++;
+        this.lastFailureTime = Date.now();
+        if (this.state === CircuitState.HALF_OPEN) {
+            // Failed during recovery test, go back to OPEN
+            this.state = CircuitState.OPEN;
+        }
+        else if (this.failureCount >= this.failureThreshold) {
+            this.state = CircuitState.OPEN;
+        }
+    }
+    /**
+     * Record a call attempt in HALF_OPEN state.
+     */
+    recordHalfOpenCall() {
+        this.halfOpenCalls++;
+    }
+    /**
+     * Reset the circuit breaker.
+     */
+    reset() {
+        this.failureCount = 0;
+        this.state = CircuitState.CLOSED;
+        this.lastFailureTime = 0;
+        this.halfOpenCalls = 0;
+    }
+}
+/**
+ * Calculate backoff delay with jitter to prevent thundering herd.
+ *
+ * @param attempt - Zero-based attempt number
+ * @param baseDelay - Base delay in milliseconds
+ * @param maxDelay - Maximum delay cap
+ * @param jitter - Jitter factor (0-1), adds randomness
+ * @returns Delay in milliseconds
+ */
+export function exponentialBackoffWithJitter(attempt, baseDelay = 1000, maxDelay = 30000, jitter = 0.5) {
+    const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+    const jitterRange = delay * jitter;
+    return delay + (Math.random() * 2 - 1) * jitterRange;
+}
+/**
+ * Internal process-local cache with auto-encryption.
+ *
+ * Used by dominus services only:
+ * - Validation state
+ * - Service URLs
+ * - API responses
+ *
+ * NOT accessible by SDK users.
+ */
+export class DominusCache {
+    defaultTtl;
+    store = new Map();
+    cipher = null;
+    constructor(defaultTtl = 300000) {
+        this.defaultTtl = defaultTtl;
+    } // 5 minutes in ms
+    /**
+     * Initialize encryption using auth token.
+     */
+    setEncryptionKey(token) {
+        if (!token)
+            return;
+        const key = crypto.createHash('sha256').update(token).digest();
+        this.cipher = { key, algorithm: 'aes-256-gcm' };
+    }
+    /**
+     * Get and decrypt, refresh TTL.
+     */
+    get(key) {
+        const entry = this.store.get(key);
+        if (!entry)
+            return null;
+        // Check expiry
+        if (Date.now() >= entry.expiresAt) {
+            this.store.delete(key);
+            return null;
+        }
+        try {
+            let value;
+            if (this.cipher) {
+                // Decrypt
+                const iv = entry.encryptedValue.subarray(0, 16);
+                const authTag = entry.encryptedValue.subarray(16, 32);
+                const encrypted = entry.encryptedValue.subarray(32);
+                const decipher = crypto.createDecipheriv(this.cipher.algorithm, this.cipher.key, iv);
+                decipher.setAuthTag(authTag);
+                const decrypted = Buffer.concat([
+                    decipher.update(encrypted),
+                    decipher.final(),
+                ]);
+                value = JSON.parse(decrypted.toString('utf8'));
+            }
+            else {
+                value = JSON.parse(entry.encryptedValue.toString('utf8'));
+            }
+            // Touch TTL
+            entry.expiresAt = Date.now() + this.defaultTtl;
+            return value;
+        }
+        catch {
+            this.store.delete(key);
+            return null;
+        }
+    }
+    /**
+     * Encrypt and store.
+     */
+    set(key, value, ttl) {
+        const duration = ttl ?? this.defaultTtl;
+        const plaintext = JSON.stringify(value);
+        let encryptedValue;
+        if (this.cipher) {
+            const iv = crypto.randomBytes(16);
+            const cipher = crypto.createCipheriv(this.cipher.algorithm, this.cipher.key, iv);
+            const encrypted = Buffer.concat([
+                cipher.update(plaintext, 'utf8'),
+                cipher.final(),
+            ]);
+            const authTag = cipher.getAuthTag();
+            encryptedValue = Buffer.concat([iv, authTag, encrypted]);
+        }
+        else {
+            encryptedValue = Buffer.from(plaintext, 'utf8');
+        }
+        this.store.set(key, {
+            encryptedValue,
+            expiresAt: Date.now() + duration,
+        });
+    }
+    /**
+     * Delete key.
+     */
+    delete(key) {
+        return this.store.delete(key);
+    }
+    /**
+     * Clear all.
+     */
+    clear() {
+        const count = this.store.size;
+        this.store.clear();
+        return count;
+    }
+    /**
+     * Get cache size.
+     */
+    size() {
+        return this.store.size;
+    }
+}
+// Internal singletons - NOT exported to users
+export const dominusCache = new DominusCache(300000); // 5 minutes
+// Circuit breakers for different services (prevents retry storms)
+export const orchestratorCircuitBreaker = new CircuitBreaker(5, // Open after 5 consecutive failures
+30000, // Try again after 30 seconds
+1 // Allow 1 test call in half-open state
+);
+//# sourceMappingURL=cache.js.map

package/dist/lib/cache.js.map

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

package/dist/lib/client.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Core HTTP Client for Dominus SDK
+ *
+ * Handles JWT management, base64 encoding/decoding, retries, and circuit breaker.
+ */
+export interface RequestOptions {
+    endpoint: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    body?: Record<string, unknown>;
+    /** User JWT token for user-authenticated requests (bypasses service token) */
+    userToken?: string;
+}
+/**
+ * Main Dominus client class
+ */
+export declare class DominusClient {
+    private token;
+    private baseUrl;
+    constructor(hardcodedToken?: string);
+    /**
+     * Validate token on first use
+     */
+    private validate;
+    /**
+     * Make an authenticated request to the orchestrator
+     *
+     * @param options - Request options including endpoint, method, body, and optional userToken
+     * @param options.userToken - If provided, uses this JWT instead of the service token.
+     *                            Use this for user-authenticated requests (e.g., /api/portal/auth/me)
+     */
+    request<T = unknown>(options: RequestOptions): Promise<T>;
+    /**
+     * Health check endpoint
+     */
+    healthCheck(): Promise<Record<string, unknown>>;
+}
+export declare function getClient(hardcodedToken?: string): DominusClient;
+//# sourceMappingURL=client.d.ts.map

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;IAC/B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuUD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAEZ,cAAc,CAAC,EAAE,MAAM;IAKnC;;OAEG;YACW,QAAQ;IAyBtB;;;;;;OAMG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAwJ/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"}