@observa/sdk 2.3.0 → 2.3.1

package/dist/src/apis/ingestApi.d.ts

@@ -0,0 +1,22 @@
+import type { IngestRequest, IngestResponse } from '../domain/ingest';
+import type { HttpClient } from '../http/httpClient';
+export type IngestNormalizationOptions = {
+    schemaVersion?: number;
+    includeContext?: boolean;
+    includeSystemContext?: boolean;
+    includeRuntimeContext?: boolean;
+    maxEventBytes?: number;
+    maxFrames?: number;
+    maxMessageLength?: number;
+    maxExceptionValueLength?: number;
+};
+export declare class IngestApi {
+    private readonly http;
+    private readonly defaultDsnKey?;
+    private readonly normalization?;
+    constructor(http: HttpClient, defaultDsnKey?: string | undefined, normalization?: IngestNormalizationOptions | undefined);
+    event(input: IngestRequest): Promise<IngestResponse>;
+    health(dsnKey?: string): Promise<{
+        ok: boolean;
+    }>;
+}

package/dist/src/apis/ingestApi.js

@@ -0,0 +1,167 @@
+import { randomUUID } from 'crypto';
+import { ValidationError } from '../http/errors.js';
+import { getProcessContextDynamic, getProcessContextStatic } from '../utils/processContext.js';
+import { ensureDefined, ensureNonEmpty } from '../utils/validate.js';
+const DEFAULT_NORMALIZATION = {
+    schemaVersion: 1,
+    includeContext: true,
+    includeSystemContext: true,
+    includeRuntimeContext: true,
+    maxEventBytes: 64 * 1024,
+    maxFrames: 60,
+    maxMessageLength: 4000,
+    maxExceptionValueLength: 4000,
+};
+export class IngestApi {
+    http;
+    defaultDsnKey;
+    normalization;
+    constructor(http, defaultDsnKey, normalization) {
+        this.http = http;
+        this.defaultDsnKey = defaultDsnKey;
+        this.normalization = normalization;
+    }
+    async event(input) {
+        ensureDefined(input, 'input');
+        const dsnKey = input.dsnKey ?? this.defaultDsnKey;
+        ensureDefined(dsnKey, 'dsnKey');
+        ensureNonEmpty(dsnKey, 'dsnKey');
+        ensureDefined(input.event, 'event');
+        if (input.idempotencyKey && input.idempotencyKey.length > 128) {
+            throw new ValidationError('idempotencyKey must be at most 128 characters');
+        }
+        const headers = {};
+        if (input.idempotencyKey)
+            headers['x-idempotency-key'] = input.idempotencyKey;
+        if (input.sdkVersion)
+            headers['x-sdk-version'] = input.sdkVersion;
+        const { idempotencyKey, sdkVersion, event, ...body } = input;
+        const normalizedEvent = normalizeEvent(event, this.normalization);
+        return this.http.post('/ingest/events', { ...body, dsnKey, event: normalizedEvent }, { auth: 'apiKey', headers });
+    }
+    async health(dsnKey) {
+        const resolvedDsnKey = dsnKey ?? this.defaultDsnKey;
+        ensureDefined(resolvedDsnKey, 'dsnKey');
+        ensureNonEmpty(resolvedDsnKey, 'dsnKey');
+        return this.http.post('/ingest/health', { dsnKey: resolvedDsnKey }, { auth: 'apiKey' });
+    }
+}
+function normalizeEvent(event, options) {
+    const config = { ...DEFAULT_NORMALIZATION, ...options };
+    const normalizedTimestamp = normalizeTimestamp(event.timestamp);
+    const normalizedLevel = event.level ? event.level.toLowerCase() : undefined;
+    const normalizedMessage = event.message ? truncate(event.message, config.maxMessageLength) : undefined;
+    const normalizedException = normalizeException(event.exception, config);
+    if (!normalizedMessage && !normalizedException) {
+        throw new ValidationError('event message or exception is required');
+    }
+    const normalizedContext = normalizeContext(event.context, config);
+    const normalizedEvent = {
+        ...event,
+        event_id: event.event_id ?? randomUUID(),
+        timestamp: normalizedTimestamp,
+        schema_version: event.schema_version ?? config.schemaVersion,
+        level: normalizedLevel,
+        message: normalizedMessage,
+        exception: normalizedException,
+        context: normalizedContext,
+    };
+    return enforceSizeLimit(normalizedEvent, config);
+}
+function normalizeTimestamp(timestamp) {
+    if (!timestamp)
+        return new Date().toISOString();
+    const parsed = new Date(timestamp);
+    if (Number.isNaN(parsed.getTime())) {
+        throw new ValidationError('timestamp must be a valid ISO date');
+    }
+    return parsed.toISOString();
+}
+function normalizeException(exception, config) {
+    if (!exception)
+        return undefined;
+    if (!exception.type || !exception.value) {
+        throw new ValidationError('exception.type and exception.value are required');
+    }
+    return {
+        ...exception,
+        value: truncate(exception.value, config.maxExceptionValueLength),
+        stacktrace: normalizeStacktrace(exception.stacktrace, config.maxFrames),
+    };
+}
+function normalizeStacktrace(stacktrace, maxFrames) {
+    if (!stacktrace || !Array.isArray(stacktrace.frames))
+        return undefined;
+    const frames = stacktrace.frames;
+    const normalizedFrames = frames.slice(0, maxFrames).map((frame) => {
+        const filename = typeof frame?.filename === 'string' ? frame.filename : undefined;
+        const functionName = typeof frame?.function === 'string' ? frame.function : undefined;
+        const lineno = typeof frame?.lineno === 'number' ? frame.lineno : undefined;
+        const colno = typeof frame?.colno === 'number' ? frame.colno : undefined;
+        const inferredInApp = filename ? !filename.includes('node_modules') : false;
+        return {
+            filename,
+            function: functionName,
+            lineno,
+            colno,
+            in_app: typeof frame?.in_app === 'boolean' ? frame.in_app : inferredInApp,
+        };
+    });
+    return { frames: normalizedFrames };
+}
+function normalizeContext(context, config) {
+    if (!config.includeContext)
+        return context;
+    const systemContext = config.includeSystemContext ? getProcessContextDynamic() : undefined;
+    const runtimeContext = config.includeRuntimeContext ? getProcessContextStatic({ includeVersions: false }) : undefined;
+    const mergedContext = {
+        ...context,
+        system: context?.system ?? systemContext,
+        runtime: context?.runtime ?? runtimeContext,
+    };
+    return mergedContext;
+}
+function enforceSizeLimit(event, config) {
+    let normalized = event;
+    if (getSize(normalized) <= config.maxEventBytes)
+        return normalized;
+    if (normalized.extra) {
+        normalized = { ...normalized, extra: undefined };
+    }
+    if (getSize(normalized) <= config.maxEventBytes)
+        return normalized;
+    if (normalized.tags) {
+        normalized = { ...normalized, tags: undefined };
+    }
+    if (getSize(normalized) <= config.maxEventBytes)
+        return normalized;
+    if (normalized.exception?.stacktrace) {
+        normalized = {
+            ...normalized,
+            exception: { ...normalized.exception, stacktrace: undefined },
+        };
+    }
+    if (getSize(normalized) <= config.maxEventBytes)
+        return normalized;
+    if (normalized.message) {
+        normalized = { ...normalized, message: truncate(normalized.message, config.maxMessageLength) };
+    }
+    if (normalized.exception?.value) {
+        normalized = {
+            ...normalized,
+            exception: { ...normalized.exception, value: truncate(normalized.exception.value, config.maxExceptionValueLength) },
+        };
+    }
+    if (getSize(normalized) <= config.maxEventBytes)
+        return normalized;
+    throw new ValidationError('event payload exceeds size limit');
+}
+function getSize(value) {
+    return Buffer.byteLength(JSON.stringify(value), 'utf8');
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength)
+        return value;
+    return value.slice(0, maxLength);
+}
+//# sourceMappingURL=ingestApi.js.map

package/dist/src/apis/ingestApi.js.map

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

package/dist/src/apis/uptimeApi.d.ts

@@ -0,0 +1,11 @@
+import type { UptimeEvent, UptimeHeartbeatInput, UptimeSummary } from '../domain/uptime';
+import type { HttpClient } from '../http/httpClient';
+export declare class UptimeApi {
+    private readonly http;
+    private readonly defaultDsnKey?;
+    constructor(http: HttpClient, defaultDsnKey?: string | undefined);
+    recordHeartbeat(input: UptimeHeartbeatInput): Promise<UptimeEvent>;
+    history(projectId: string, date: string): Promise<UptimeEvent[]>;
+    latest(projectId: string): Promise<UptimeEvent | null>;
+    summary(projectId: string, days?: number, delayThresholdMinutes?: number): Promise<UptimeSummary[]>;
+}

package/dist/src/apis/uptimeApi.js

@@ -0,0 +1,39 @@
+import { ensureDefined, ensureNonEmpty } from '../utils/validate.js';
+export class UptimeApi {
+    http;
+    defaultDsnKey;
+    constructor(http, defaultDsnKey) {
+        this.http = http;
+        this.defaultDsnKey = defaultDsnKey;
+    }
+    async recordHeartbeat(input) {
+        ensureDefined(input, 'input');
+        const dsnKey = input.dsnKey ?? this.defaultDsnKey;
+        ensureDefined(dsnKey, 'dsnKey');
+        ensureNonEmpty(dsnKey, 'dsnKey');
+        ensureNonEmpty(input.status, 'status');
+        return this.http.post('/uptime/heartbeats', { ...input, dsnKey }, { auth: 'apiKey' });
+    }
+    async history(projectId, date) {
+        ensureNonEmpty(projectId, 'projectId');
+        ensureNonEmpty(date, 'date');
+        return this.http.get(`/projects/${encodeURIComponent(projectId)}/uptime/history`, {
+            query: { date },
+            auth: 'none',
+        });
+    }
+    async latest(projectId) {
+        ensureNonEmpty(projectId, 'projectId');
+        return this.http.get(`/projects/${encodeURIComponent(projectId)}/uptime/latest`, {
+            auth: 'none',
+        });
+    }
+    async summary(projectId, days, delayThresholdMinutes) {
+        ensureNonEmpty(projectId, 'projectId');
+        return this.http.get(`/projects/${encodeURIComponent(projectId)}/uptime/summary`, {
+            query: { days, delayThresholdMinutes },
+            auth: 'none',
+        });
+    }
+}
+//# sourceMappingURL=uptimeApi.js.map

package/dist/src/apis/uptimeApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uptimeApi.js","sourceRoot":"","sources":["../../../src/apis/uptimeApi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAMjE,MAAM,OAAO,SAAS;IAIW;IAAmC;IAAhE,YAA6B,IAAgB,EAAmB,aAAsB;QAAzD,SAAI,GAAJ,IAAI,CAAY;QAAmB,kBAAa,GAAb,aAAa,CAAS;IAAI,CAAC;IAK3F,KAAK,CAAC,eAAe,CAAC,KAA2B;QAC7C,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,CAAA;QACjD,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC/B,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAChC,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAc,oBAAoB,EAAE,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IACtG,CAAC;IAKD,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,IAAY;QACzC,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;QACtC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,aAAa,kBAAkB,CAAC,SAAS,CAAC,iBAAiB,EAAE;YAC7F,KAAK,EAAE,EAAE,IAAI,EAAE;YACf,IAAI,EAAE,MAAM;SACf,CAAC,CAAA;IACN,CAAC;IAKD,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC1B,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAqB,aAAa,kBAAkB,CAAC,SAAS,CAAC,gBAAgB,EAAE;YACjG,IAAI,EAAE,MAAM;SACf,CAAC,CAAA;IACN,CAAC;IAKD,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,IAAa,EAAE,qBAA8B;QAC1E,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAkB,aAAa,kBAAkB,CAAC,SAAS,CAAC,iBAAiB,EAAE;YAC/F,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE;YACtC,IAAI,EAAE,MAAM;SACf,CAAC,CAAA;IACN,CAAC;CACJ"}

package/dist/src/domain/ingest.d.ts

@@ -0,0 +1,47 @@
+import type { ProcessContextDynamic, ProcessContextStatic } from '../utils/processContext';
+export type IngestLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export type StacktraceFrame = {
+    filename?: string;
+    function?: string;
+    lineno?: number;
+    colno?: number;
+    in_app?: boolean;
+};
+export type Stacktrace = {
+    frames: StacktraceFrame[];
+};
+export type IngestException = {
+    type: string;
+    value: string;
+    stacktrace?: Stacktrace;
+};
+export type RequestContext = {
+    requestId?: string;
+    userId?: string;
+    [key: string]: unknown;
+};
+export type IngestEventContext = {
+    system?: ProcessContextDynamic;
+    runtime?: ProcessContextStatic;
+    request?: RequestContext;
+};
+export type IngestEvent = {
+    event_id?: string;
+    timestamp?: string;
+    schema_version?: number;
+    level?: IngestLevel;
+    message?: string;
+    exception?: IngestException;
+    context?: IngestEventContext;
+    tags?: Record<string, string>;
+    extra?: Record<string, unknown>;
+};
+export type IngestRequest = {
+    dsnKey?: string;
+    event: IngestEvent;
+    idempotencyKey?: string;
+    sdkVersion?: string;
+};
+export type IngestResponse = {
+    event_id: string;
+};

package/dist/src/domain/ingest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ingest.js.map

package/dist/src/domain/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../src/domain/ingest.ts"],"names":[],"mappings":""}

package/dist/src/domain/uptime.d.ts

@@ -0,0 +1,23 @@
+export type UptimeStatus = 'up' | 'down' | 'degraded';
+export type UptimeEvent = {
+    id: string;
+    projectId: string;
+    status: UptimeStatus;
+    message?: string;
+    responseTimeMs?: number;
+    checkedAt?: string;
+    createdAt?: string;
+};
+export type UptimeHeartbeatInput = {
+    dsnKey?: string;
+    status: UptimeStatus;
+    responseTimeMs?: number;
+    checkedAt?: string;
+    message?: string;
+};
+export type UptimeSummary = {
+    date: string;
+    missingHours?: number;
+    delayMinutes?: number;
+    delayedCount?: number;
+};

package/dist/src/domain/uptime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=uptime.js.map

package/dist/src/domain/uptime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uptime.js","sourceRoot":"","sources":["../../../src/domain/uptime.ts"],"names":[],"mappings":""}

package/dist/src/http/errors.d.ts

@@ -0,0 +1,33 @@
+export type ErrorDetails = {
+    status?: number;
+    code?: string;
+    details?: unknown;
+    retryAfter?: number;
+};
+export declare class SdkError extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    constructor(message: string, details?: ErrorDetails);
+}
+export declare class ValidationError extends SdkError {
+}
+export declare class AuthError extends SdkError {
+}
+export declare class ForbiddenError extends SdkError {
+}
+export declare class NotFoundError extends SdkError {
+}
+export declare class ConflictError extends SdkError {
+}
+export declare class RateLimitError extends SdkError {
+    readonly retryAfter?: number;
+    constructor(message: string, details?: ErrorDetails);
+}
+export declare class ServerError extends SdkError {
+}
+export declare class NetworkError extends SdkError {
+}
+export declare class TimeoutError extends SdkError {
+}
+export declare function mapHttpError(status: number, details?: unknown, retryAfter?: number): SdkError;

package/dist/src/http/errors.js

@@ -0,0 +1,54 @@
+export class SdkError extends Error {
+    status;
+    code;
+    details;
+    constructor(message, details) {
+        super(message);
+        this.name = new.target.name;
+        this.status = details?.status;
+        this.code = details?.code;
+        this.details = details?.details;
+    }
+}
+export class ValidationError extends SdkError {
+}
+export class AuthError extends SdkError {
+}
+export class ForbiddenError extends SdkError {
+}
+export class NotFoundError extends SdkError {
+}
+export class ConflictError extends SdkError {
+}
+export class RateLimitError extends SdkError {
+    retryAfter;
+    constructor(message, details) {
+        super(message, details);
+        this.retryAfter = details?.retryAfter;
+    }
+}
+export class ServerError extends SdkError {
+}
+export class NetworkError extends SdkError {
+}
+export class TimeoutError extends SdkError {
+}
+export function mapHttpError(status, details, retryAfter) {
+    const info = { status, details, retryAfter };
+    if (status === 400)
+        return new ValidationError('Invalid request', info);
+    if (status === 401)
+        return new AuthError('Unauthorized', info);
+    if (status === 403)
+        return new ForbiddenError('Forbidden', info);
+    if (status === 404)
+        return new NotFoundError('Resource not found', info);
+    if (status === 409)
+        return new ConflictError('Conflict', info);
+    if (status === 429)
+        return new RateLimitError('Rate limit exceeded', info);
+    if (status >= 500)
+        return new ServerError('Server error', info);
+    return new SdkError('HTTP error', info);
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/http/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/http/errors.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACtB,MAAM,CAAS;IACf,IAAI,CAAS;IACb,OAAO,CAAU;IAK1B,YAAY,OAAe,EAAE,OAAsB;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAA;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,CAAA;IACnC,CAAC;CACJ;AAKD,MAAM,OAAO,eAAgB,SAAQ,QAAQ;CAAI;AAIjD,MAAM,OAAO,SAAU,SAAQ,QAAQ;CAAI;AAI3C,MAAM,OAAO,cAAe,SAAQ,QAAQ;CAAI;AAIhD,MAAM,OAAO,aAAc,SAAQ,QAAQ;CAAI;AAI/C,MAAM,OAAO,aAAc,SAAQ,QAAQ;CAAI;AAI/C,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC/B,UAAU,CAAS;IAE5B,YAAY,OAAe,EAAE,OAAsB;QAC/C,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAA;IACzC,CAAC;CACJ;AAID,MAAM,OAAO,WAAY,SAAQ,QAAQ;CAAI;AAI7C,MAAM,OAAO,YAAa,SAAQ,QAAQ;CAAI;AAI9C,MAAM,OAAO,YAAa,SAAQ,QAAQ;CAAI;AAK9C,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAAiB,EAAE,UAAmB;IAC/E,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;IAC5C,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,eAAe,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAA;IACvE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,SAAS,CAAC,cAAc,EAAE,IAAI,CAAC,CAAA;IAC9D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;IAChE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,aAAa,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAA;IACxE,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAC9D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,cAAc,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAA;IAC1E,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,WAAW,CAAC,cAAc,EAAE,IAAI,CAAC,CAAA;IAC/D,OAAO,IAAI,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;AAC3C,CAAC"}

package/dist/src/http/httpClient.d.ts

@@ -0,0 +1,45 @@
+export type AuthMode = 'apiKey' | 'none';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export type QueryParams = Record<string, string | number | boolean | undefined>;
+export type RetryPolicy = {
+    retries: number;
+    retryDelayMs?: (attempt: number, response?: Response, error?: unknown) => number;
+    retryOn?: (response?: Response, error?: unknown) => boolean;
+};
+export type HttpClientOptions = {
+    baseUrl: string;
+    apiKey?: string;
+    timeoutMs?: number;
+    headers?: Record<string, string>;
+    retry?: RetryPolicy;
+};
+export type RequestOptions = {
+    method: HttpMethod;
+    path: string;
+    query?: QueryParams;
+    body?: unknown;
+    headers?: Record<string, string>;
+    auth?: AuthMode;
+};
+export declare class HttpClient {
+    private apiKey?;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly headers;
+    private readonly retry?;
+    private healthCheckPromise?;
+    constructor(options: HttpClientOptions);
+    setApiKey(apiKey?: string): void;
+    startHealthCheck(healthCheck: () => Promise<unknown>): void;
+    get<T>(path: string, options?: Omit<RequestOptions, 'method' | 'path'>): Promise<T>;
+    post<T>(path: string, body?: unknown, options?: Omit<RequestOptions, 'method' | 'path' | 'body'>): Promise<T>;
+    put<T>(path: string, body?: unknown, options?: Omit<RequestOptions, 'method' | 'path' | 'body'>): Promise<T>;
+    patch<T>(path: string, body?: unknown, options?: Omit<RequestOptions, 'method' | 'path' | 'body'>): Promise<T>;
+    delete<T>(path: string, options?: Omit<RequestOptions, 'method' | 'path'>): Promise<T>;
+    request<T>(options: RequestOptions): Promise<T>;
+    private execute;
+    private buildUrl;
+    private readBody;
+    private parseRetryAfter;
+    private delay;
+}

package/dist/src/http/httpClient.js

@@ -0,0 +1,165 @@
+import { AuthError, NetworkError, TimeoutError, mapHttpError } from './errors.js';
+export class HttpClient {
+    apiKey;
+    baseUrl;
+    timeoutMs;
+    headers;
+    retry;
+    healthCheckPromise;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, '');
+        this.apiKey = options.apiKey;
+        this.timeoutMs = options.timeoutMs ?? 5000;
+        this.headers = options.headers ?? {};
+        this.retry = options.retry;
+    }
+    setApiKey(apiKey) {
+        this.apiKey = apiKey;
+    }
+    startHealthCheck(healthCheck) {
+        if (!this.healthCheckPromise) {
+            const promise = healthCheck();
+            this.healthCheckPromise = promise;
+            promise.catch(() => undefined);
+        }
+    }
+    async get(path, options) {
+        return this.request({ method: 'GET', path, ...options });
+    }
+    async post(path, body, options) {
+        return this.request({ method: 'POST', path, body, ...options });
+    }
+    async put(path, body, options) {
+        return this.request({ method: 'PUT', path, body, ...options });
+    }
+    async patch(path, body, options) {
+        return this.request({ method: 'PATCH', path, body, ...options });
+    }
+    async delete(path, options) {
+        return this.request({ method: 'DELETE', path, ...options });
+    }
+    async request(options) {
+        if (this.healthCheckPromise) {
+            await this.healthCheckPromise;
+        }
+        const retry = this.retry ?? { retries: 0 };
+        const retryOn = retry.retryOn ?? ((response, error) => {
+            if (response)
+                return response.status === 429 || response.status >= 500;
+            return error instanceof NetworkError || error instanceof TimeoutError || error instanceof TypeError;
+        });
+        const retryDelayMs = retry.retryDelayMs ?? ((attempt) => Math.min(1000 * 2 ** (attempt - 1), 8000));
+        let lastError;
+        for (let attempt = 0; attempt <= retry.retries; attempt += 1) {
+            try {
+                const { response, data } = await this.execute(options);
+                if (!response.ok) {
+                    const retryAfter = this.parseRetryAfter(response.headers.get('retry-after'));
+                    const error = mapHttpError(response.status, data, retryAfter);
+                    if (retryOn(response, error) && attempt < retry.retries) {
+                        await this.delay(retryDelayMs(attempt + 1, response, error));
+                        continue;
+                    }
+                    throw error;
+                }
+                return data;
+            }
+            catch (error) {
+                lastError = error;
+                if (retryOn(undefined, error) && attempt < retry.retries) {
+                    await this.delay(retryDelayMs(attempt + 1, undefined, error));
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throw lastError;
+    }
+    async execute(options) {
+        const url = this.buildUrl(options.path, options.query);
+        const headers = { ...this.headers, ...options.headers };
+        if (options.body !== undefined)
+            headers['content-type'] = 'application/json';
+        const authMode = options.auth ?? 'none';
+        if (authMode === 'apiKey') {
+            if (!this.apiKey)
+                throw new AuthError('API key is required');
+            headers['x-api-key'] = this.apiKey;
+        }
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method: options.method,
+                headers,
+                body: options.body === undefined ? undefined : JSON.stringify(options.body),
+                signal: controller.signal,
+            });
+            const data = await this.readBody(response);
+            return { response, data };
+        }
+        catch (error) {
+            if (error?.name === 'AbortError') {
+                throw new TimeoutError('Request timeout');
+            }
+            if (error instanceof NetworkError || error instanceof TimeoutError)
+                throw error;
+            if (error instanceof Error) {
+                if (error instanceof AuthError)
+                    throw error;
+            }
+            if (error instanceof Error && 'status' in error)
+                throw error;
+            throw new NetworkError('Network error', { details: error });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    buildUrl(path, query) {
+        const base = this.baseUrl;
+        const fullPath = path.startsWith('http') ? path : `${base}${path.startsWith('/') ? '' : '/'}${path}`;
+        if (!query)
+            return fullPath;
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(query)) {
+            if (value === undefined)
+                continue;
+            params.set(key, String(value));
+        }
+        const suffix = params.toString();
+        return suffix ? `${fullPath}?${suffix}` : fullPath;
+    }
+    async readBody(response) {
+        if (response.status === 204)
+            return undefined;
+        const text = await response.text();
+        if (!text)
+            return undefined;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    parseRetryAfter(value) {
+        if (!value)
+            return undefined;
+        const seconds = Number(value);
+        if (!Number.isNaN(seconds) && Number.isFinite(seconds)) {
+            return Math.max(0, seconds);
+        }
+        const parsedDate = Date.parse(value);
+        if (Number.isNaN(parsedDate))
+            return undefined;
+        const diffMs = parsedDate - Date.now();
+        if (diffMs <= 0)
+            return 0;
+        return Math.ceil(diffMs / 1000);
+    }
+    async delay(ms) {
+        await new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=httpClient.js.map