@fedpulse/sdk 1.0.0

package/dist/esm/errors.js

@@ -0,0 +1,187 @@
+/**
+ * FedPulse SDK error classes.
+ *
+ * All errors thrown by the SDK extend FedPulseError so callers can use
+ * `instanceof FedPulseError` to distinguish SDK errors from other exceptions.
+ */
+// ── Base error ─────────────────────────────────────────────────────────────────
+/**
+ * Base class for all FedPulse SDK errors.
+ */
+export class FedPulseError extends Error {
+    /** HTTP status code returned by the API, or 0 for network errors. */
+    status;
+    /** Machine-readable error code from the API (e.g. NOT_FOUND, RATE_LIMIT_EXCEEDED). */
+    code;
+    /** Request ID for debugging — correlates with API logs. */
+    requestId;
+    /** Additional structured details from the API response. */
+    details;
+    constructor({ message, status, code, requestId, details, }) {
+        super(message);
+        this.name = 'FedPulseError';
+        this.status = status;
+        this.code = code;
+        this.requestId = requestId;
+        this.details = details;
+        // Restore prototype chain after `extends Error` in transpiled output.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+// ── Specific error subtypes ────────────────────────────────────────────────────
+/**
+ * Thrown when the API returns 401 Unauthorized.
+ * Usually caused by missing, invalid, or revoked API key / JWT.
+ */
+export class AuthenticationError extends FedPulseError {
+    constructor(params) {
+        super({ ...params, status: 401, code: 'UNAUTHORIZED' });
+        this.name = 'AuthenticationError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when the API returns 403 Forbidden.
+ * Usually caused by insufficient plan permissions or missing key scope.
+ */
+export class PermissionError extends FedPulseError {
+    constructor(params) {
+        super({ ...params, status: 403, code: params.code ?? 'FORBIDDEN' });
+        this.name = 'PermissionError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when the API returns 404 Not Found.
+ */
+export class NotFoundError extends FedPulseError {
+    constructor(params) {
+        super({ ...params, status: 404, code: 'NOT_FOUND' });
+        this.name = 'NotFoundError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when the API returns 422 Unprocessable Entity or 400 Bad Request
+ * due to invalid request parameters or body.
+ */
+export class ValidationError extends FedPulseError {
+    constructor(params) {
+        super({ ...params, status: params.status ?? 422, code: 'VALIDATION_ERROR' });
+        this.name = 'ValidationError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when the API returns 429 Too Many Requests.
+ * The `retryAfter` property indicates when the rate limit resets (Unix seconds).
+ */
+export class RateLimitError extends FedPulseError {
+    /** Unix epoch seconds when the rate limit window resets. */
+    retryAfter;
+    constructor(params) {
+        super({ ...params, status: 429, code: 'RATE_LIMIT_EXCEEDED' });
+        this.name = 'RateLimitError';
+        this.retryAfter = params.retryAfter;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when the API returns a 5xx server error.
+ */
+export class ServerError extends FedPulseError {
+    constructor(params) {
+        super({ ...params, status: params.status ?? 500, code: params.code ?? 'INTERNAL_ERROR' });
+        this.name = 'ServerError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when a network-level failure occurs (DNS, TCP, timeout, ECONNREFUSED).
+ * The `cause` property contains the original error.
+ */
+export class NetworkError extends FedPulseError {
+    /** The underlying network error. */
+    cause;
+    constructor(params) {
+        super({ ...params, status: 0, code: 'NETWORK_ERROR' });
+        this.name = 'NetworkError';
+        this.cause = params.cause;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when a request exceeds the configured timeout.
+ */
+export class TimeoutError extends FedPulseError {
+    constructor(params) {
+        super({ ...params, status: 0, code: 'REQUEST_TIMEOUT' });
+        this.name = 'TimeoutError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when the SDK's retry budget is exhausted.
+ * The `lastError` property contains the final underlying error.
+ */
+export class RetryExhaustedError extends FedPulseError {
+    lastError;
+    attempts;
+    constructor(params) {
+        super({
+            message: `Request failed after ${params.attempts} attempt(s): ${params.lastError.message}`,
+            status: params.lastError.status,
+            code: 'RETRY_EXHAUSTED',
+            requestId: params.lastError.requestId,
+        });
+        this.name = 'RetryExhaustedError';
+        this.lastError = params.lastError;
+        this.attempts = params.attempts;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Factory — parses a raw API error response object into the correct error subtype.
+ *
+ * @param status   HTTP response status code.
+ * @param body     Parsed JSON body (may be the error envelope or anything).
+ * @param headers  Response headers map (used for Retry-After).
+ */
+export function createApiError(status, body, headers) {
+    // Extract standardised error fields from the envelope.
+    const envelope = body != null && typeof body === 'object' ? body : {};
+    const errObj = envelope['error'] ?? {};
+    const message = typeof errObj['message'] === 'string'
+        ? errObj['message']
+        : typeof envelope['message'] === 'string'
+            ? envelope['message']
+            : `HTTP ${status}`;
+    const code = typeof errObj['code'] === 'string' ? errObj['code'] : undefined;
+    const requestId = typeof envelope['meta']?.['requestId'] === 'string'
+        ? envelope['meta']['requestId']
+        : undefined;
+    const details = errObj['details'] ?? undefined;
+    switch (status) {
+        case 400:
+            return new ValidationError({ message, status: 400, requestId, details });
+        case 401:
+            return new AuthenticationError({ message, requestId, details });
+        case 403:
+            return new PermissionError({ message, code, requestId, details });
+        case 404:
+            return new NotFoundError({ message, requestId, details });
+        case 422:
+            return new ValidationError({ message, status: 422, requestId, details });
+        case 429: {
+            const retryAfterHeader = headers['retry-after'] ?? headers['x-ratelimit-reset'];
+            const retryAfter = retryAfterHeader != null ? Number(retryAfterHeader) : undefined;
+            return new RateLimitError({ message, retryAfter: Number.isFinite(retryAfter) ? retryAfter : undefined, requestId, details });
+        }
+        default:
+            if (status >= 500) {
+                return new ServerError({ message, status, code, requestId, details });
+            }
+            return new FedPulseError({ message, status, code: code ?? 'UNKNOWN_ERROR', requestId, details });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

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

package/dist/esm/http.js

@@ -0,0 +1,445 @@
+/**
+ * Core HTTP client for the FedPulse SDK.
+ *
+ * Features:
+ *  - Native fetch (Node 18+) — zero runtime dependencies
+ *  - Configurable timeout via AbortController
+ *  - Automatic retry with exponential back-off + full jitter for transient errors
+ *  - In-memory LRU cache for GET requests with per-entry TTL
+ *  - Rate-limit header tracking (X-RateLimit-*)
+ *  - Standard API envelope parsing + typed error creation
+ *  - Array query-parameter serialisation (repeated keys)
+ */
+import { FedPulseError, AuthenticationError, NetworkError, TimeoutError, RetryExhaustedError, RateLimitError, createApiError, } from './errors.js';
+// ── Constants ──────────────────────────────────────────────────────────────────
+const DEFAULT_BASE_URL = 'https://api.fedpulse.dev';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_CACHE_SIZE = 256;
+const DEFAULT_CACHE_TTL_MS = 60_000;
+/** HTTP status codes that are safe to retry (transient server-side errors). */
+const RETRYABLE_STATUSES = new Set([429, 500, 502, 503, 504]);
+/**
+ * Least-recently-used cache with per-entry TTL.
+ * Implemented with a doubly-linked list + Map for O(1) get and set.
+ *
+ * @template T  Cached value type.
+ */
+class LruCache {
+    capacity;
+    defaultTtlMs;
+    map = new Map();
+    // Sentinel nodes avoid null-checks on boundary operations.
+    head;
+    tail;
+    constructor(capacity, defaultTtlMs) {
+        this.capacity = capacity;
+        this.defaultTtlMs = defaultTtlMs;
+        this.head = { value: null, expiresAt: 0, key: '__head', prev: null, next: null };
+        this.tail = { value: null, expiresAt: 0, key: '__tail', prev: null, next: null };
+        this.head.next = this.tail;
+        this.tail.prev = this.head;
+    }
+    /**
+     * Retrieve a cached value. Returns undefined on miss or expiry.
+     */
+    get(key) {
+        const entry = this.map.get(key);
+        if (entry === undefined)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.remove(entry);
+            this.map.delete(key);
+            return undefined;
+        }
+        // Move to front (most-recently-used).
+        this.remove(entry);
+        this.insertFront(entry);
+        return entry.value;
+    }
+    /**
+     * Store a value. Returns the evicted key if capacity was exceeded.
+     */
+    set(key, value, ttlMs) {
+        // Evict stale entry for the same key first.
+        const existing = this.map.get(key);
+        if (existing !== undefined) {
+            this.remove(existing);
+        }
+        const entry = {
+            key,
+            value,
+            expiresAt: Date.now() + (ttlMs ?? this.defaultTtlMs),
+            prev: null,
+            next: null,
+        };
+        this.map.set(key, entry);
+        this.insertFront(entry);
+        // Evict LRU entry if over capacity.
+        if (this.map.size > this.capacity) {
+            // LRU entry is just before the tail sentinel.
+            const lru = this.tail.prev;
+            if (lru !== this.head) {
+                this.remove(lru);
+                this.map.delete(lru.key);
+            }
+        }
+    }
+    /** Delete a specific key from the cache. */
+    delete(key) {
+        const entry = this.map.get(key);
+        if (entry !== undefined) {
+            this.remove(entry);
+            this.map.delete(key);
+        }
+    }
+    /** Remove all entries. */
+    clear() {
+        this.map.clear();
+        this.head.next = this.tail;
+        this.tail.prev = this.head;
+    }
+    /** Number of entries currently in the cache. */
+    get size() {
+        return this.map.size;
+    }
+    insertFront(entry) {
+        entry.prev = this.head;
+        entry.next = this.head.next;
+        this.head.next.prev = entry;
+        this.head.next = entry;
+    }
+    remove(entry) {
+        entry.prev.next = entry.next;
+        entry.next.prev = entry.prev;
+    }
+}
+// ── Query string serialisation ─────────────────────────────────────────────────
+/**
+ * Serialise a plain-object params map to a URLSearchParams instance.
+ *
+ * Arrays are serialised as repeated keys: `{ naics: ['11', '21'] }` →
+ * `?naics=11&naics=21`.
+ *
+ * Undefined and null values are omitted.
+ */
+export function buildQueryParams(params) {
+    const qs = new URLSearchParams();
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item !== undefined && item !== null) {
+                    qs.append(key, String(item));
+                }
+            }
+        }
+        else {
+            qs.set(key, String(value));
+        }
+    }
+    return qs;
+}
+// ── HttpClient ─────────────────────────────────────────────────────────────────
+/**
+ * Low-level HTTP client used by all domain resources.
+ *
+ * You should not need to instantiate this directly — use `FedPulse` instead.
+ */
+export class HttpClient {
+    apiKey;
+    baseUrl;
+    timeoutMs;
+    maxRetries;
+    cache;
+    defaultCacheTtlMs;
+    fetchFn;
+    /** Most recent rate-limit info observed across all requests. */
+    lastRateLimit = null;
+    constructor(options) {
+        if (!options.apiKey || typeof options.apiKey !== 'string' || options.apiKey.trim() === '') {
+            throw new AuthenticationError({
+                message: 'API key is required and must be a non-empty string. ' +
+                    'Generate one at https://app.fedpulse.dev/dashboard.',
+            });
+        }
+        this.apiKey = options.apiKey.trim();
+        this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+        this.defaultCacheTtlMs = options.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+        this.fetchFn = options.fetchFn ?? globalThis.fetch;
+        const cacheSize = options.cacheSize ?? DEFAULT_CACHE_SIZE;
+        this.cache = cacheSize > 0 ? new LruCache(cacheSize, this.defaultCacheTtlMs) : null;
+    }
+    // ── Public request methods ───────────────────────────────────────────────────
+    /**
+     * Perform a GET request. Results are cached unless `cacheTtlMs` is 0.
+     *
+     * @param path     API path (e.g. `/v1/opportunities`).
+     * @param params   Query parameters — arrays serialised as repeated keys.
+     * @param options  Per-request overrides.
+     */
+    async get(path, params = {}, options) {
+        const qs = buildQueryParams(params);
+        const qsStr = qs.toString();
+        const url = `${this.baseUrl}${path}${qsStr ? `?${qsStr}` : ''}`;
+        const ttl = options?.cacheTtlMs ?? this.defaultCacheTtlMs;
+        const shouldCache = this.cache !== null && ttl > 0;
+        if (shouldCache) {
+            const cached = this.cache.get(url);
+            if (cached !== undefined) {
+                return { ...cached, fromCache: true };
+            }
+        }
+        const result = await this.executeWithRetry('GET', url, undefined, options);
+        if (shouldCache) {
+            this.cache.set(url, result, ttl);
+        }
+        return result;
+    }
+    /**
+     * Perform a POST request (never cached).
+     *
+     * @param path   API path.
+     * @param body   JSON-serialisable request body.
+     * @param options  Per-request overrides.
+     */
+    async post(path, body, options) {
+        const url = `${this.baseUrl}${path}`;
+        return this.executeWithRetry('POST', url, body, options);
+    }
+    /**
+     * Perform a PATCH request (never cached).
+     */
+    async patch(path, body, options) {
+        const url = `${this.baseUrl}${path}`;
+        return this.executeWithRetry('PATCH', url, body, options);
+    }
+    /**
+     * Perform a DELETE request (never cached).
+     */
+    async del(path, options) {
+        const url = `${this.baseUrl}${path}`;
+        return this.executeWithRetry('DELETE', url, undefined, options);
+    }
+    /**
+     * Clear all cached responses.
+     */
+    clearCache() {
+        this.cache?.clear();
+    }
+    // ── Internal methods ─────────────────────────────────────────────────────────
+    /**
+     * Execute a request, retrying on transient failures with exponential back-off
+     * and full jitter.
+     */
+    async executeWithRetry(method, url, body, options) {
+        let lastError = null;
+        const maxAttempts = this.maxRetries + 1;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            try {
+                return await this.executeOnce(method, url, body, options);
+            }
+            catch (err) {
+                if (!(err instanceof FedPulseError)) {
+                    // Should not happen, but guard defensively.
+                    throw err;
+                }
+                lastError = err;
+                // Do not retry 4xx errors (except 429).
+                const isRetryable = err instanceof NetworkError ||
+                    err instanceof TimeoutError ||
+                    RETRYABLE_STATUSES.has(err.status);
+                if (!isRetryable) {
+                    // Non-retryable (4xx): throw the specific error type immediately.
+                    throw err;
+                }
+                if (attempt >= maxAttempts) {
+                    // Retryable but no more attempts available.
+                    break;
+                }
+                // Calculate delay: exponential back-off (base 500ms) with full jitter.
+                let delayMs;
+                if (err instanceof RateLimitError && err.retryAfter !== undefined) {
+                    // Honour API-provided Retry-After header.
+                    const waitUntil = err.retryAfter * 1000;
+                    delayMs = Math.max(0, waitUntil - Date.now());
+                }
+                else {
+                    const baseMs = 500 * Math.pow(2, attempt - 1); // 500, 1000, 2000 …
+                    const capMs = 30_000;
+                    delayMs = Math.random() * Math.min(baseMs, capMs);
+                }
+                await sleep(delayMs);
+            }
+        }
+        // Only use RetryExhaustedError when we actually retried (maxAttempts > 1).
+        // With maxRetries=0 the caller gets the specific error type directly.
+        if (maxAttempts > 1) {
+            throw new RetryExhaustedError({ lastError: lastError, attempts: maxAttempts });
+        }
+        throw lastError;
+    }
+    /**
+     * Execute a single HTTP request (no retry logic).
+     * Handles timeout, response parsing, header extraction, and error creation.
+     */
+    async executeOnce(method, url, body, options) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: 'application/json',
+            'User-Agent': '@fedpulse/sdk/1.0.0 (node)',
+            ...(options?.headers ?? {}),
+        };
+        if (body !== undefined && body !== null) {
+            headers['Content-Type'] = 'application/json';
+        }
+        let response;
+        try {
+            response = await this.fetchFn(url, {
+                method,
+                headers,
+                body: body !== undefined && body !== null ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            if (err != null && typeof err === 'object' && 'name' in err && err.name === 'AbortError') {
+                throw new TimeoutError({
+                    message: `Request timed out after ${this.timeoutMs}ms: ${method} ${url}`,
+                });
+            }
+            const cause = err instanceof Error ? err : new Error(String(err));
+            throw new NetworkError({
+                message: `Network error: ${cause.message}`,
+                cause,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        // Extract headers for rate limit tracking and error context.
+        const headerMap = {
+            'x-ratelimit-limit': response.headers.get('x-ratelimit-limit'),
+            'x-ratelimit-remaining': response.headers.get('x-ratelimit-remaining'),
+            'x-ratelimit-reset': response.headers.get('x-ratelimit-reset'),
+            'retry-after': response.headers.get('retry-after'),
+        };
+        const rateLimit = parseRateLimitHeaders(headerMap);
+        if (rateLimit !== null) {
+            this.lastRateLimit = rateLimit;
+        }
+        // Parse body — always attempt JSON; fall back to text for error messages.
+        let parsedBody;
+        const contentType = response.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            try {
+                parsedBody = await response.json();
+            }
+            catch {
+                parsedBody = null;
+            }
+        }
+        else {
+            // Non-JSON body (e.g. download streams or plain-text errors).
+            parsedBody = null;
+        }
+        if (!response.ok) {
+            throw createApiError(response.status, parsedBody, headerMap);
+        }
+        // Unwrap the standard success envelope.
+        const envelope = parsedBody;
+        if (envelope === null || typeof envelope !== 'object' || !('data' in envelope)) {
+            // Unexpected response shape — treat as server error.
+            throw createApiError(500, { error: { message: 'Unexpected response format from API' } }, headerMap);
+        }
+        const meta = (envelope.meta ?? { requestId: '' });
+        return {
+            data: envelope.data,
+            pagination: envelope.pagination ?? null,
+            meta,
+            rateLimit,
+            fromCache: false,
+        };
+    }
+    /**
+     * Perform a raw fetch that returns the full Response (for streaming downloads).
+     * No retry, no envelope parsing.
+     *
+     * @param path   API path.
+     * @param params Query parameters.
+     */
+    async rawGet(path, params = {}) {
+        const qs = buildQueryParams(params);
+        const qsStr = qs.toString();
+        const url = `${this.baseUrl}${path}${qsStr ? `?${qsStr}` : ''}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await this.fetchFn(url, {
+                method: 'GET',
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'User-Agent': '@fedpulse/sdk/1.0.0 (node)',
+                },
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                let body = null;
+                try {
+                    body = await response.json();
+                }
+                catch { /* ignore */ }
+                throw createApiError(response.status, body, {
+                    'retry-after': response.headers.get('retry-after'),
+                    'x-ratelimit-reset': response.headers.get('x-ratelimit-reset'),
+                    'x-ratelimit-limit': response.headers.get('x-ratelimit-limit'),
+                    'x-ratelimit-remaining': response.headers.get('x-ratelimit-remaining'),
+                });
+            }
+            return response;
+        }
+        catch (err) {
+            if (err instanceof FedPulseError)
+                throw err;
+            if (err != null && typeof err === 'object' && 'name' in err && err.name === 'AbortError') {
+                throw new TimeoutError({ message: `Request timed out after ${this.timeoutMs}ms` });
+            }
+            const cause = err instanceof Error ? err : new Error(String(err));
+            throw new NetworkError({ message: `Network error: ${cause.message}`, cause });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+/**
+ * Parse X-RateLimit-* response headers into a typed object.
+ * Returns null if none of the headers are present.
+ */
+function parseRateLimitHeaders(headers) {
+    const limit = headers['x-ratelimit-limit'];
+    const remaining = headers['x-ratelimit-remaining'];
+    const reset = headers['x-ratelimit-reset'];
+    if (limit === null && remaining === null && reset === null)
+        return null;
+    return {
+        limit: limit !== null ? Number(limit) : 0,
+        remaining: remaining !== null ? Number(remaining) : 0,
+        reset: reset !== null ? Number(reset) : 0,
+    };
+}
+/**
+ * Promise-based sleep helper.
+ * @param ms  Milliseconds to wait.
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=http.js.map

package/dist/esm/http.js.map

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