@observa/sdk 1.0.0

package/README.md

@@ -0,0 +1,20 @@
+# observa-sdk-node
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.2.20. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+
+## SDK Contract
+
+This SDK is an official client for the Observa backend.
+It targets a fixed API and does not support custom base URLs.

package/dist/apis/ingestApi.d.ts

@@ -0,0 +1,18 @@
+import type { IngestRequest, IngestResponse } from '../domain/ingest';
+import type { HttpClient } from '../http/httpClient';
+/**
+ * Event ingestion API.
+ */
+export declare class IngestApi {
+    private readonly http;
+    private readonly defaultDsnKey?;
+    /**
+     * Creates the ingestion client with an optional default DSN.
+     */
+    constructor(http: HttpClient, defaultDsnKey?: string | undefined);
+    /**
+     * Sends an event to the ingestion backend.
+     */
+    event(input: IngestRequest): Promise<IngestResponse>;
+}
+//# sourceMappingURL=ingestApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingestApi.d.ts","sourceRoot":"","sources":["../../src/apis/ingestApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAErE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD;;GAEG;AACH,qBAAa,SAAS;IAIN,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAc,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAH9E;;OAEG;gBAC0B,IAAI,EAAE,UAAU,EAAmB,aAAa,CAAC,EAAE,MAAM,YAAA;IAEtF;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAQ7D"}

package/dist/apis/ingestApi.js

@@ -0,0 +1,27 @@
+import { ensureDefined, ensureNonEmpty } from '../utils/validate';
+/**
+ * Event ingestion API.
+ */
+export class IngestApi {
+    http;
+    defaultDsnKey;
+    /**
+     * Creates the ingestion client with an optional default DSN.
+     */
+    constructor(http, defaultDsnKey) {
+        this.http = http;
+        this.defaultDsnKey = defaultDsnKey;
+    }
+    /**
+     * Sends an event to the ingestion backend.
+     */
+    async event(input) {
+        ensureDefined(input, 'input');
+        const dsnKey = input.dsnKey ?? this.defaultDsnKey;
+        ensureDefined(dsnKey, 'dsnKey');
+        ensureNonEmpty(dsnKey, 'dsnKey');
+        ensureDefined(input.event, 'event');
+        return this.http.post('/ingest/events', { ...input, dsnKey }, { auth: 'apiKey' });
+    }
+}
+//# sourceMappingURL=ingestApi.js.map

package/dist/apis/ingestApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestApi.js","sourceRoot":"","sources":["../../src/apis/ingestApi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGjE;;GAEG;AACH,MAAM,OAAO,SAAS;IAIW;IAAmC;IAHhE;;OAEG;IACH,YAA6B,IAAgB,EAAmB,aAAsB;QAAzD,SAAI,GAAJ,IAAI,CAAY;QAAmB,kBAAa,GAAb,aAAa,CAAS;IAAI,CAAC;IAE3F;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,KAAoB;QAC5B,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,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAiB,gBAAgB,EAAE,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IACrG,CAAC;CACJ"}

package/dist/apis/uptimeApi.d.ts

@@ -0,0 +1,30 @@
+import type { UptimeEvent, UptimeHeartbeatInput, UptimeSummary } from '../domain/uptime';
+import type { HttpClient } from '../http/httpClient';
+/**
+ * Uptime API for heartbeats and public reads.
+ */
+export declare class UptimeApi {
+    private readonly http;
+    private readonly defaultDsnKey?;
+    /**
+     * Creates the uptime client with an optional default DSN.
+     */
+    constructor(http: HttpClient, defaultDsnKey?: string | undefined);
+    /**
+     * Records an uptime heartbeat.
+     */
+    recordHeartbeat(input: UptimeHeartbeatInput): Promise<UptimeEvent>;
+    /**
+     * Lists a project's daily uptime history.
+     */
+    history(projectId: string, date: string): Promise<UptimeEvent[]>;
+    /**
+     * Gets the latest uptime event for a project.
+     */
+    latest(projectId: string): Promise<UptimeEvent | null>;
+    /**
+     * Summarizes daily uptime.
+     */
+    summary(projectId: string, days?: number, delayThresholdMinutes?: number): Promise<UptimeSummary[]>;
+}
+//# sourceMappingURL=uptimeApi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uptimeApi.d.ts","sourceRoot":"","sources":["../../src/apis/uptimeApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAExF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAEpD;;GAEG;AACH,qBAAa,SAAS;IAIN,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAc,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAH9E;;OAEG;gBAC0B,IAAI,EAAE,UAAU,EAAmB,aAAa,CAAC,EAAE,MAAM,YAAA;IAEtF;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IASxE;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAStE;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAO5D;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAO5G"}

package/dist/apis/uptimeApi.js

@@ -0,0 +1,57 @@
+import { ensureDefined, ensureNonEmpty } from '../utils/validate';
+/**
+ * Uptime API for heartbeats and public reads.
+ */
+export class UptimeApi {
+    http;
+    defaultDsnKey;
+    /**
+     * Creates the uptime client with an optional default DSN.
+     */
+    constructor(http, defaultDsnKey) {
+        this.http = http;
+        this.defaultDsnKey = defaultDsnKey;
+    }
+    /**
+     * Records an uptime heartbeat.
+     */
+    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' });
+    }
+    /**
+     * Lists a project's daily uptime history.
+     */
+    async history(projectId, date) {
+        ensureNonEmpty(projectId, 'projectId');
+        ensureNonEmpty(date, 'date');
+        return this.http.get(`/projects/${encodeURIComponent(projectId)}/uptime/history`, {
+            query: { date },
+            auth: 'none',
+        });
+    }
+    /**
+     * Gets the latest uptime event for a project.
+     */
+    async latest(projectId) {
+        ensureNonEmpty(projectId, 'projectId');
+        return this.http.get(`/projects/${encodeURIComponent(projectId)}/uptime/latest`, {
+            auth: 'none',
+        });
+    }
+    /**
+     * Summarizes daily uptime.
+     */
+    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/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;AAGjE;;GAEG;AACH,MAAM,OAAO,SAAS;IAIW;IAAmC;IAHhE;;OAEG;IACH,YAA6B,IAAgB,EAAmB,aAAsB;QAAzD,SAAI,GAAJ,IAAI,CAAY;QAAmB,kBAAa,GAAb,aAAa,CAAS;IAAI,CAAC;IAE3F;;OAEG;IACH,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;IAED;;OAEG;IACH,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;IAED;;OAEG;IACH,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;IAED;;OAEG;IACH,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/domain/ingest.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Severity levels for events.
+ */
+export type IngestLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/**
+ * Ingestion event.
+ */
+export type IngestEvent = {
+    /**
+     * Unique event identifier.
+     */
+    event_id?: string;
+    /**
+     * Event ISO timestamp.
+     */
+    timestamp?: string;
+    /**
+     * Severity level.
+     */
+    level?: IngestLevel;
+    /**
+     * Main message.
+     */
+    message?: string;
+    /**
+     * Free-form context payload.
+     */
+    payload?: unknown;
+};
+/**
+ * Payload for sending an event to the backend.
+ */
+export type IngestRequest = {
+    /**
+     * Project DSN. Uses the SDK default when omitted.
+     */
+    dsnKey?: string;
+    /**
+     * Event to record.
+     */
+    event: IngestEvent;
+};
+/**
+ * Response after sending an event.
+ */
+export type IngestResponse = {
+    /**
+     * Assigned event identifier.
+     */
+    event_id: string;
+};
+//# sourceMappingURL=ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/domain/ingest.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAEvE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,KAAK,EAAE,WAAW,CAAA;CACrB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;CACnB,CAAA"}

package/dist/domain/ingest.js

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

package/dist/domain/ingest.js.map

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

package/dist/domain/uptime.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Possible uptime statuses.
+ */
+export type UptimeStatus = 'up' | 'down' | 'degraded';
+/**
+ * Recorded uptime event.
+ */
+export type UptimeEvent = {
+    /**
+     * Event identifier.
+     */
+    id: string;
+    /**
+     * Project the event belongs to.
+     */
+    projectId: string;
+    /**
+     * Uptime status.
+     */
+    status: UptimeStatus;
+    /**
+     * Optional message for the event.
+     */
+    message?: string;
+    /**
+     * Response time in milliseconds.
+     */
+    responseTimeMs?: number;
+    /**
+     * ISO timestamp of the check.
+     */
+    checkedAt?: string;
+    /**
+     * ISO timestamp of backend creation.
+     */
+    createdAt?: string;
+};
+/**
+ * Payload for sending an uptime heartbeat.
+ */
+export type UptimeHeartbeatInput = {
+    /**
+     * Project DSN. Uses the SDK default when omitted.
+     */
+    dsnKey?: string;
+    /**
+     * Reported status.
+     */
+    status: UptimeStatus;
+    /**
+     * Response time in milliseconds.
+     */
+    responseTimeMs?: number;
+    /**
+     * ISO timestamp of the check.
+     */
+    checkedAt?: string;
+    /**
+     * Optional message.
+     */
+    message?: string;
+};
+/**
+ * Daily uptime summary.
+ */
+export type UptimeSummary = {
+    /**
+     * ISO date of the summary.
+     */
+    date: string;
+    /**
+     * Hours without data.
+     */
+    missingHours?: number;
+    /**
+     * Accumulated delay minutes.
+     */
+    delayMinutes?: number;
+    /**
+     * Number of delayed events.
+     */
+    delayedCount?: number;
+};
+//# sourceMappingURL=uptime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uptime.d.ts","sourceRoot":"","sources":["../../src/domain/uptime.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,UAAU,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IACV;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,MAAM,EAAE,YAAY,CAAA;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,MAAM,EAAE,YAAY,CAAA;IACpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA"}

package/dist/domain/uptime.js

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

package/dist/domain/uptime.js.map

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

package/dist/http/errors.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Additional data to enrich SDK errors.
+ */
+export type ErrorDetails = {
+    status?: number;
+    code?: string;
+    details?: unknown;
+    retryAfter?: number;
+};
+/**
+ * Base SDK error.
+ */
+export declare class SdkError extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    /**
+     * Creates an error with optional metadata.
+     */
+    constructor(message: string, details?: ErrorDetails);
+}
+/**
+ * Input validation error.
+ */
+export declare class ValidationError extends SdkError {
+}
+/**
+ * Authentication error.
+ */
+export declare class AuthError extends SdkError {
+}
+/**
+ * Error caused by insufficient permissions.
+ */
+export declare class ForbiddenError extends SdkError {
+}
+/**
+ * Error when a resource does not exist.
+ */
+export declare class NotFoundError extends SdkError {
+}
+/**
+ * Error caused by a state conflict.
+ */
+export declare class ConflictError extends SdkError {
+}
+/**
+ * Error caused by rate limiting.
+ */
+export declare class RateLimitError extends SdkError {
+    readonly retryAfter?: number;
+    constructor(message: string, details?: ErrorDetails);
+}
+/**
+ * Server-side error.
+ */
+export declare class ServerError extends SdkError {
+}
+/**
+ * Network error.
+ */
+export declare class NetworkError extends SdkError {
+}
+/**
+ * Request timeout error.
+ */
+export declare class TimeoutError extends SdkError {
+}
+/**
+ * Maps HTTP status codes to typed SDK errors.
+ */
+export declare function mapHttpError(status: number, details?: unknown, retryAfter?: number): SdkError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAE1B;;OAEG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAOtD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;CAAI;AACjD;;GAEG;AACH,qBAAa,SAAU,SAAQ,QAAQ;CAAI;AAC3C;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;CAAI;AAChD;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;CAAI;AAC/C;;GAEG;AACH,qBAAa,aAAc,SAAQ,QAAQ;CAAI;AAC/C;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;gBAEhB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAItD;AACD;;GAEG;AACH,qBAAa,WAAY,SAAQ,QAAQ;CAAI;AAC7C;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;CAAI;AAC9C;;GAEG;AACH,qBAAa,YAAa,SAAQ,QAAQ;CAAI;AAE9C;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAU7F"}

package/dist/http/errors.js

@@ -0,0 +1,90 @@
+/**
+ * Base SDK error.
+ */
+export class SdkError extends Error {
+    status;
+    code;
+    details;
+    /**
+     * Creates an error with optional metadata.
+     */
+    constructor(message, details) {
+        super(message);
+        this.name = new.target.name;
+        this.status = details?.status;
+        this.code = details?.code;
+        this.details = details?.details;
+    }
+}
+/**
+ * Input validation error.
+ */
+export class ValidationError extends SdkError {
+}
+/**
+ * Authentication error.
+ */
+export class AuthError extends SdkError {
+}
+/**
+ * Error caused by insufficient permissions.
+ */
+export class ForbiddenError extends SdkError {
+}
+/**
+ * Error when a resource does not exist.
+ */
+export class NotFoundError extends SdkError {
+}
+/**
+ * Error caused by a state conflict.
+ */
+export class ConflictError extends SdkError {
+}
+/**
+ * Error caused by rate limiting.
+ */
+export class RateLimitError extends SdkError {
+    retryAfter;
+    constructor(message, details) {
+        super(message, details);
+        this.retryAfter = details?.retryAfter;
+    }
+}
+/**
+ * Server-side error.
+ */
+export class ServerError extends SdkError {
+}
+/**
+ * Network error.
+ */
+export class NetworkError extends SdkError {
+}
+/**
+ * Request timeout error.
+ */
+export class TimeoutError extends SdkError {
+}
+/**
+ * Maps HTTP status codes to typed SDK errors.
+ */
+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/http/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACtB,MAAM,CAAS;IACf,IAAI,CAAS;IACb,OAAO,CAAU;IAE1B;;OAEG;IACH,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;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;CAAI;AACjD;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,QAAQ;CAAI;AAC3C;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;CAAI;AAChD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,QAAQ;CAAI;AAC/C;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,QAAQ;CAAI;AAC/C;;GAEG;AACH,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;AACD;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,QAAQ;CAAI;AAC7C;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;CAAI;AAC9C;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;CAAI;AAE9C;;GAEG;AACH,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/http/httpClient.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Authentication mode per request.
+ */
+export type AuthMode = 'apiKey' | 'none';
+/**
+ * Supported HTTP methods.
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+/**
+ * Serializable query parameters.
+ */
+export type QueryParams = Record<string, string | number | boolean | undefined>;
+/**
+ * Retry policy for transient errors.
+ */
+export type RetryPolicy = {
+    /**
+     * Number of additional retries.
+     */
+    retries: number;
+    /**
+     * Computes the delay between retries.
+     */
+    retryDelayMs?: (attempt: number, response?: Response, error?: unknown) => number;
+    /**
+     * Determines whether a response or error should be retried.
+     */
+    retryOn?: (response?: Response, error?: unknown) => boolean;
+};
+/**
+ * Base HTTP client configuration.
+ */
+export type HttpClientOptions = {
+    /**
+     * Backend base URL.
+     */
+    baseUrl: string;
+    /**
+     * API key used for SDK authentication.
+     */
+    apiKey?: string;
+    /**
+     * Request timeout in milliseconds.
+     */
+    timeoutMs?: number;
+    /**
+     * Global headers.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Retry policy.
+     */
+    retry?: RetryPolicy;
+};
+/**
+ * Per-request options.
+ */
+export type RequestOptions = {
+    method: HttpMethod;
+    path: string;
+    query?: QueryParams;
+    body?: unknown;
+    headers?: Record<string, string>;
+    /**
+     * Defines whether the request requires an apiKey or is public.
+     */
+    auth?: AuthMode;
+};
+/**
+ * Base HTTP client for the SDK.
+ */
+export declare class HttpClient {
+    private apiKey?;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly headers;
+    private readonly retry?;
+    private healthCheckPromise?;
+    /**
+     * Creates an HTTP client with baseUrl and optional apiKey.
+     */
+    constructor(options: HttpClientOptions);
+    /**
+     * Updates the API key at runtime.
+     */
+    setApiKey(apiKey?: string): void;
+    startHealthCheck(): void;
+    /**
+     * GET request.
+     */
+    get<T>(path: string, options?: Omit<RequestOptions, 'method' | 'path'>): Promise<T>;
+    /**
+     * POST request.
+     */
+    post<T>(path: string, body?: unknown, options?: Omit<RequestOptions, 'method' | 'path' | 'body'>): Promise<T>;
+    /**
+     * PUT request.
+     */
+    put<T>(path: string, body?: unknown, options?: Omit<RequestOptions, 'method' | 'path' | 'body'>): Promise<T>;
+    /**
+     * PATCH request.
+     */
+    patch<T>(path: string, body?: unknown, options?: Omit<RequestOptions, 'method' | 'path' | 'body'>): Promise<T>;
+    /**
+     * DELETE request.
+     */
+    delete<T>(path: string, options?: Omit<RequestOptions, 'method' | 'path'>): Promise<T>;
+    /**
+     * Executes a request with retry logic.
+     */
+    request<T>(options: RequestOptions): Promise<T>;
+    /**
+     * Executes a request without retry and returns response + data.
+     */
+    private execute;
+    /**
+     * Builds the final URL with query params.
+     */
+    private buildUrl;
+    /**
+     * Parses the body as JSON when possible.
+     */
+    private readBody;
+    private checkHealth;
+    private parseRetryAfter;
+    /**
+     * Simple delay for retries.
+     */
+    private delay;
+}
+//# sourceMappingURL=httpClient.d.ts.map

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

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

package/dist/http/httpClient.js

@@ -0,0 +1,235 @@
+import { AuthError, NetworkError, TimeoutError, ServerError, mapHttpError } from './errors';
+/**
+ * Base HTTP client for the SDK.
+ */
+export class HttpClient {
+    apiKey;
+    baseUrl;
+    timeoutMs;
+    headers;
+    retry;
+    healthCheckPromise;
+    /**
+     * Creates an HTTP client with baseUrl and optional apiKey.
+     */
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, '');
+        this.apiKey = options.apiKey;
+        this.timeoutMs = options.timeoutMs ?? 5000;
+        this.headers = options.headers ?? {};
+        this.retry = options.retry;
+    }
+    /**
+     * Updates the API key at runtime.
+     */
+    setApiKey(apiKey) {
+        this.apiKey = apiKey;
+    }
+    startHealthCheck() {
+        if (!this.healthCheckPromise) {
+            this.healthCheckPromise = this.checkHealth();
+            this.healthCheckPromise.catch(() => undefined);
+        }
+    }
+    /**
+     * GET request.
+     */
+    async get(path, options) {
+        return this.request({ method: 'GET', path, ...options });
+    }
+    /**
+     * POST request.
+     */
+    async post(path, body, options) {
+        return this.request({ method: 'POST', path, body, ...options });
+    }
+    /**
+     * PUT request.
+     */
+    async put(path, body, options) {
+        return this.request({ method: 'PUT', path, body, ...options });
+    }
+    /**
+     * PATCH request.
+     */
+    async patch(path, body, options) {
+        return this.request({ method: 'PATCH', path, body, ...options });
+    }
+    /**
+     * DELETE request.
+     */
+    async delete(path, options) {
+        return this.request({ method: 'DELETE', path, ...options });
+    }
+    /**
+     * Executes a request with retry logic.
+     */
+    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;
+    }
+    /**
+     * Executes a request without retry and returns response + data.
+     */
+    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);
+        }
+    }
+    /**
+     * Builds the final URL with query params.
+     */
+    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;
+    }
+    /**
+     * Parses the body as JSON when possible.
+     */
+    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;
+        }
+    }
+    async checkHealth() {
+        const url = this.buildUrl('/api/health');
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: this.headers,
+                signal: controller.signal,
+            });
+            const data = await this.readBody(response);
+            if (!response.ok) {
+                throw mapHttpError(response.status, data);
+            }
+            if (!data || typeof data !== 'object' || data.status !== 'ok') {
+                throw new ServerError('Health check failed', { details: 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 && 'status' in error)
+                throw error;
+            throw new NetworkError('Network error', { details: error });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    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);
+    }
+    /**
+     * Simple delay for retries.
+     */
+    async delay(ms) {
+        await new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=httpClient.js.map

package/dist/http/httpClient.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Main SDK.
+ */
+export { ObservaSDK } from './sdk';
+/**
+ * SDK options.
+ */
+export type { ObservaSDKOptions } from './sdk';
+/**
+ * Base HTTP client.
+ */
+export { HttpClient } from './http/httpClient';
+/**
+ * HTTP types.
+ */
+export type { HttpClientOptions, RequestOptions, RetryPolicy, AuthMode } from './http/httpClient';
+/**
+ * Typed SDK errors.
+ */
+export { SdkError, ValidationError, AuthError, ForbiddenError, NotFoundError, ConflictError, RateLimitError, ServerError, NetworkError, TimeoutError, } from './http/errors';
+/**
+ * Domain APIs.
+ */
+export { UptimeApi } from './apis/uptimeApi';
+export { IngestApi } from './apis/ingestApi';
+/**
+ * Uptime types.
+ */
+export type { UptimeEvent, UptimeStatus, UptimeHeartbeatInput, UptimeSummary } from './domain/uptime';
+/**
+ * Ingestion types.
+ */
+export type { IngestEvent, IngestLevel, IngestRequest, IngestResponse } from './domain/ingest';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAClC;;GAEG;AACH,YAAY,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAE9C;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C;;GAEG;AACH,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjG;;GAEG;AACH,OAAO,EACL,QAAQ,EACR,eAAe,EACf,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAA;AAEtB;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE5C;;GAEG;AACH,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACrG;;GAEG;AACH,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * Main SDK.
+ */
+export { ObservaSDK } from './sdk';
+/**
+ * Base HTTP client.
+ */
+export { HttpClient } from './http/httpClient';
+/**
+ * Typed SDK errors.
+ */
+export { SdkError, ValidationError, AuthError, ForbiddenError, NotFoundError, ConflictError, RateLimitError, ServerError, NetworkError, TimeoutError, } from './http/errors';
+/**
+ * Domain APIs.
+ */
+export { UptimeApi } from './apis/uptimeApi';
+export { IngestApi } from './apis/ingestApi';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAMlC;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAM9C;;GAEG;AACH,OAAO,EACL,QAAQ,EACR,eAAe,EACf,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAA;AAEtB;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/sdk.d.ts

@@ -0,0 +1,51 @@
+import { IngestApi } from './apis/ingestApi';
+import { UptimeApi } from './apis/uptimeApi';
+import { type RetryPolicy } from './http/httpClient';
+/**
+ * SDK configuration options.
+ */
+export type ObservaSDKOptions = {
+    /**
+     * Organization API key used to authenticate SDK requests.
+     */
+    apiKey: string;
+    /**
+     * Project DSN used to identify the destination of events and heartbeats.
+     */
+    dsnKey: string;
+    /**
+     * HTTP request timeout in milliseconds.
+     */
+    timeoutMs?: number;
+    /**
+     * Retry policy for transient errors.
+     */
+    retry?: RetryPolicy;
+    /**
+     * Additional headers sent with every request.
+     */
+    headers?: Record<string, string>;
+};
+/**
+ * Main SDK for error ingestion and uptime heartbeats.
+ */
+export declare class ObservaSDK {
+    /**
+     * Uptime API (heartbeats and public reads).
+     */
+    readonly uptime: UptimeApi;
+    /**
+     * Event ingestion API.
+     */
+    readonly ingest: IngestApi;
+    private readonly http;
+    /**
+     * Creates an SDK instance with required apiKey and dsnKey.
+     */
+    constructor(options: ObservaSDKOptions);
+    /**
+     * Updates the API key used by the SDK at runtime.
+     */
+    setApiKey(apiKey: string): void;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEhE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC,CAAA;AAOD;;GAEG;AACH,qBAAa,UAAU;IACnB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAC1B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;IAE1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAY;IAEjC;;OAEG;gBACS,OAAO,EAAE,iBAAiB;IAgBtC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM;CAG3B"}

package/dist/sdk.js

@@ -0,0 +1,46 @@
+import { IngestApi } from './apis/ingestApi';
+import { UptimeApi } from './apis/uptimeApi';
+import { HttpClient } from './http/httpClient';
+/**
+ * Fixed backend target for the SDK.
+ */
+const DEFAULT_BASE_URL = 'https://backend-observa-production.up.railway.app';
+/**
+ * Main SDK for error ingestion and uptime heartbeats.
+ */
+export class ObservaSDK {
+    /**
+     * Uptime API (heartbeats and public reads).
+     */
+    uptime;
+    /**
+     * Event ingestion API.
+     */
+    ingest;
+    http;
+    /**
+     * Creates an SDK instance with required apiKey and dsnKey.
+     */
+    constructor(options) {
+        if (!options || !options.apiKey || !options.dsnKey) {
+            throw new Error('ObservaSDK requires both apiKey and dsnKey');
+        }
+        this.http = new HttpClient({
+            baseUrl: DEFAULT_BASE_URL,
+            apiKey: options.apiKey,
+            timeoutMs: options.timeoutMs,
+            retry: options.retry,
+            headers: options.headers,
+        });
+        this.http.startHealthCheck();
+        this.uptime = new UptimeApi(this.http, options.dsnKey);
+        this.ingest = new IngestApi(this.http, options.dsnKey);
+    }
+    /**
+     * Updates the API key used by the SDK at runtime.
+     */
+    setApiKey(apiKey) {
+        this.http.setApiKey(apiKey);
+    }
+}
+//# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAA;AA4BhE;;GAEG;AACH,MAAM,gBAAgB,GAAG,mDAAmD,CAAA;AAE5E;;GAEG;AACH,MAAM,OAAO,UAAU;IACnB;;OAEG;IACM,MAAM,CAAW;IAC1B;;OAEG;IACM,MAAM,CAAW;IAET,IAAI,CAAY;IAEjC;;OAEG;IACH,YAAY,OAA0B;QAClC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QACjE,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC;YACvB,OAAO,EAAE,gBAAgB;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;SAC3B,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAA;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QACtD,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1D,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAc;QACpB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC/B,CAAC;CACJ"}

package/dist/utils/validate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Ensures a string is present and non-empty.
+ */
+export declare function ensureNonEmpty(value: string, name: string): void;
+/**
+ * Ensures a value is neither null nor undefined.
+ */
+export declare function ensureDefined<T>(value: T | null | undefined, name: string): asserts value is T;
+//# sourceMappingURL=validate.d.ts.map

package/dist/utils/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/utils/validate.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAIzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAI9F"}

package/dist/utils/validate.js

@@ -0,0 +1,18 @@
+import { ValidationError } from '../http/errors';
+/**
+ * Ensures a string is present and non-empty.
+ */
+export function ensureNonEmpty(value, name) {
+    if (!value || value.trim().length === 0) {
+        throw new ValidationError(`${name} is required`);
+    }
+}
+/**
+ * Ensures a value is neither null nor undefined.
+ */
+export function ensureDefined(value, name) {
+    if (value === null || value === undefined) {
+        throw new ValidationError(`${name} is required`);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/utils/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/utils/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,IAAY;IACtD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,eAAe,CAAC,GAAG,IAAI,cAAc,CAAC,CAAA;IACpD,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,KAA2B,EAAE,IAAY;IACtE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,IAAI,eAAe,CAAC,GAAG,IAAI,cAAc,CAAC,CAAA;IACpD,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@observa/sdk",
+  "version": "1.0.0",
+  "description": "Observa SDK for Node.js",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ObservaSolutions/observa-sdk"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/jest": "^29.5.12",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --config ./jest.config.mjs",
+    "test:watch": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --watch --config ./jest.config.mjs",
+    "test:list": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --listTests --config ./jest.config.mjs"
+  }
+}