@kopai/sdk 0.0.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Kopai Authors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.cjs

@@ -0,0 +1,336 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let _kopai_core = require("@kopai/core");
+let zod = require("zod");
+zod = __toESM(zod);
+
+//#region src/errors.ts
+/**
+* Base error for Kopai API errors (non-2xx responses).
+* Follows RFC 7807 Problem Details format.
+*/
+var KopaiError = class extends Error {
+	/** Error code from problem type */
+	code;
+	/** HTTP status code */
+	status;
+	/** URI identifying the problem type */
+	type;
+	/** Human-readable explanation */
+	detail;
+	constructor(options) {
+		super(options.message);
+		this.name = "KopaiError";
+		this.code = options.code;
+		this.status = options.status;
+		this.type = options.type;
+		this.detail = options.detail;
+	}
+};
+/**
+* Network-level errors (connection failed, DNS resolution, etc.)
+*/
+var KopaiNetworkError = class extends Error {
+	/** Original error that caused this */
+	cause;
+	constructor(message, cause) {
+		super(message);
+		this.name = "KopaiNetworkError";
+		this.cause = cause;
+	}
+};
+/**
+* Request timeout errors
+*/
+var KopaiTimeoutError = class extends Error {
+	/** Timeout duration in milliseconds */
+	timeout;
+	constructor(timeout) {
+		super(`Request timed out after ${timeout}ms`);
+		this.name = "KopaiTimeoutError";
+		this.timeout = timeout;
+	}
+};
+/**
+* Response validation errors (Zod schema validation failed)
+*/
+var KopaiValidationError = class extends Error {
+	/** Original Zod error */
+	zodError;
+	constructor(zodError) {
+		super(`Response validation failed: ${zodError.message}`);
+		this.name = "KopaiValidationError";
+		this.zodError = zodError;
+	}
+};
+
+//#endregion
+//#region src/request.ts
+const DEFAULT_TIMEOUT$1 = 3e4;
+/**
+* Internal fetch wrapper with timeout, signal, and Zod validation.
+*/
+async function request(url, schema, options) {
+	const { method = "GET", body, headers = {}, baseHeaders = {}, signal, timeout, fetchFn, defaultTimeout } = options;
+	const effectiveTimeout = timeout ?? defaultTimeout ?? DEFAULT_TIMEOUT$1;
+	const timeoutController = new AbortController();
+	const timeoutId = setTimeout(() => timeoutController.abort(), effectiveTimeout);
+	const combinedSignal = signal ? AbortSignal.any([signal, timeoutController.signal]) : timeoutController.signal;
+	try {
+		const response = await fetchFn(url, {
+			method,
+			headers: {
+				"Content-Type": "application/json",
+				...baseHeaders,
+				...headers
+			},
+			body: body ? JSON.stringify(body) : void 0,
+			signal: combinedSignal
+		});
+		clearTimeout(timeoutId);
+		if (!response.ok) await handleErrorResponse(response);
+		const data = await response.json();
+		const result = schema.safeParse(data);
+		if (!result.success) throw new KopaiValidationError(result.error);
+		return result.data;
+	} catch (error) {
+		clearTimeout(timeoutId);
+		if (error instanceof KopaiError || error instanceof KopaiValidationError || error instanceof KopaiTimeoutError || error instanceof KopaiNetworkError) throw error;
+		if (error instanceof DOMException && error.name === "AbortError") {
+			if (timeoutController.signal.aborted) throw new KopaiTimeoutError(effectiveTimeout);
+			throw error;
+		}
+		if (error instanceof TypeError) throw new KopaiNetworkError(error.message || "Network request failed", error);
+		throw error;
+	}
+}
+async function handleErrorResponse(response) {
+	let body;
+	try {
+		body = await response.json();
+	} catch {
+		body = null;
+	}
+	if (body && typeof body === "object") {
+		const problem = body;
+		throw new KopaiError({
+			message: problem.title || problem.message || `HTTP ${response.status}`,
+			code: problem.code || `HTTP_${response.status}`,
+			status: response.status,
+			type: problem.type || `about:blank`,
+			detail: problem.detail
+		});
+	}
+	throw new KopaiError({
+		message: `HTTP ${response.status}`,
+		code: `HTTP_${response.status}`,
+		status: response.status,
+		type: "about:blank"
+	});
+}
+
+//#endregion
+//#region src/pagination.ts
+/**
+* Creates an async iterator that auto-paginates through results.
+* Yields individual items from each page.
+*/
+async function* paginate(fetcher, signal) {
+	let cursor;
+	do {
+		signal?.throwIfAborted();
+		const result = await fetcher(cursor, signal);
+		for (const item of result.data) yield item;
+		cursor = result.nextCursor ?? void 0;
+	} while (cursor);
+}
+
+//#endregion
+//#region src/client.ts
+const DEFAULT_TIMEOUT = 3e4;
+const tracesResponseSchema = zod.default.object({
+	data: zod.default.array(_kopai_core.denormalizedSignals.otelTracesSchema),
+	nextCursor: zod.default.string().nullable()
+});
+const logsResponseSchema = zod.default.object({
+	data: zod.default.array(_kopai_core.denormalizedSignals.otelLogsSchema),
+	nextCursor: zod.default.string().nullable()
+});
+const metricsResponseSchema = zod.default.object({
+	data: zod.default.array(_kopai_core.denormalizedSignals.otelMetricsSchema),
+	nextCursor: zod.default.string().nullable()
+});
+const metricsDiscoverySchema = zod.default.object({ metrics: zod.default.array(zod.default.object({
+	name: zod.default.string(),
+	type: zod.default.enum([
+		"Gauge",
+		"Sum",
+		"Histogram",
+		"ExponentialHistogram",
+		"Summary"
+	]),
+	unit: zod.default.string().optional(),
+	description: zod.default.string().optional(),
+	attributes: zod.default.object({
+		values: zod.default.record(zod.default.string(), zod.default.array(zod.default.string())),
+		_truncated: zod.default.boolean().optional()
+	}),
+	resourceAttributes: zod.default.object({
+		values: zod.default.record(zod.default.string(), zod.default.array(zod.default.string())),
+		_truncated: zod.default.boolean().optional()
+	})
+})) });
+var KopaiClient = class {
+	baseUrl;
+	fetchFn;
+	defaultTimeout;
+	baseHeaders;
+	constructor(options) {
+		this.baseUrl = options.baseUrl.replace(/\/$/, "");
+		this.fetchFn = options.fetch ?? fetch;
+		this.defaultTimeout = options.timeout ?? DEFAULT_TIMEOUT;
+		this.baseHeaders = { ...options.headers };
+		if (options.token) this.baseHeaders["Authorization"] = `Bearer ${options.token}`;
+	}
+	/**
+	* Get all spans for a specific trace by ID.
+	*/
+	async getTrace(traceId, opts) {
+		const schema = zod.default.array(_kopai_core.denormalizedSignals.otelTracesSchema);
+		return request(`${this.baseUrl}/traces/${traceId}`, schema, {
+			method: "GET",
+			...opts,
+			baseHeaders: this.baseHeaders,
+			fetchFn: this.fetchFn,
+			defaultTimeout: this.defaultTimeout
+		});
+	}
+	/**
+	* Search traces with auto-pagination.
+	* Yields individual trace rows.
+	*/
+	searchTraces(filter, opts) {
+		return paginate((cursor, signal) => this.searchTracesPage({
+			...filter,
+			cursor
+		}, {
+			...opts,
+			signal
+		}), opts?.signal);
+	}
+	/**
+	* Search traces for a single page.
+	* Use this for manual pagination.
+	*/
+	async searchTracesPage(filter, opts) {
+		const validatedFilter = _kopai_core.dataFilterSchemas.tracesDataFilterSchema.parse(filter);
+		return request(`${this.baseUrl}/traces/search`, tracesResponseSchema, {
+			method: "POST",
+			body: validatedFilter,
+			...opts,
+			baseHeaders: this.baseHeaders,
+			fetchFn: this.fetchFn,
+			defaultTimeout: this.defaultTimeout
+		});
+	}
+	/**
+	* Search logs with auto-pagination.
+	* Yields individual log rows.
+	*/
+	searchLogs(filter, opts) {
+		return paginate((cursor, signal) => this.searchLogsPage({
+			...filter,
+			cursor
+		}, {
+			...opts,
+			signal
+		}), opts?.signal);
+	}
+	/**
+	* Search logs for a single page.
+	* Use this for manual pagination.
+	*/
+	async searchLogsPage(filter, opts) {
+		const validatedFilter = _kopai_core.dataFilterSchemas.logsDataFilterSchema.parse(filter);
+		return request(`${this.baseUrl}/logs/search`, logsResponseSchema, {
+			method: "POST",
+			body: validatedFilter,
+			...opts,
+			baseHeaders: this.baseHeaders,
+			fetchFn: this.fetchFn,
+			defaultTimeout: this.defaultTimeout
+		});
+	}
+	/**
+	* Search metrics with auto-pagination.
+	* Yields individual metric rows.
+	*/
+	searchMetrics(filter, opts) {
+		return paginate((cursor, signal) => this.searchMetricsPage({
+			...filter,
+			cursor
+		}, {
+			...opts,
+			signal
+		}), opts?.signal);
+	}
+	/**
+	* Search metrics for a single page.
+	* Use this for manual pagination.
+	*/
+	async searchMetricsPage(filter, opts) {
+		const validatedFilter = _kopai_core.dataFilterSchemas.metricsDataFilterSchema.parse(filter);
+		return request(`${this.baseUrl}/metrics/search`, metricsResponseSchema, {
+			method: "POST",
+			body: validatedFilter,
+			...opts,
+			baseHeaders: this.baseHeaders,
+			fetchFn: this.fetchFn,
+			defaultTimeout: this.defaultTimeout
+		});
+	}
+	/**
+	* Discover available metrics and their attributes.
+	*/
+	async discoverMetrics(opts) {
+		return request(`${this.baseUrl}/metrics/discover`, metricsDiscoverySchema, {
+			method: "GET",
+			...opts,
+			baseHeaders: this.baseHeaders,
+			fetchFn: this.fetchFn,
+			defaultTimeout: this.defaultTimeout
+		});
+	}
+};
+
+//#endregion
+exports.KopaiClient = KopaiClient;
+exports.KopaiError = KopaiError;
+exports.KopaiNetworkError = KopaiNetworkError;
+exports.KopaiTimeoutError = KopaiTimeoutError;
+exports.KopaiValidationError = KopaiValidationError;

package/dist/index.d.cts

@@ -0,0 +1,137 @@
+import { dataFilterSchemas, datasource, denormalizedSignals } from "@kopai/core";
+import { ZodError } from "zod";
+
+//#region src/types.d.ts
+type TracesDataFilter = dataFilterSchemas.TracesDataFilter;
+type LogsDataFilter = dataFilterSchemas.LogsDataFilter;
+type MetricsDataFilter = dataFilterSchemas.MetricsDataFilter;
+type OtelTracesRow = denormalizedSignals.OtelTracesRow;
+type OtelLogsRow = denormalizedSignals.OtelLogsRow;
+type OtelMetricsRow = denormalizedSignals.OtelMetricsRow;
+type MetricsDiscoveryResult = datasource.MetricsDiscoveryResult;
+type DiscoveredMetric = datasource.DiscoveredMetric;
+type DiscoveredMetricAttributes = datasource.DiscoveredMetricAttributes;
+/** Options for KopaiClient constructor */
+interface KopaiClientOptions {
+  /** Base URL for the Kopai API */
+  baseUrl: string;
+  /** Bearer token for authentication */
+  token?: string;
+  /** Additional headers to include in requests */
+  headers?: Record<string, string>;
+  /** Custom fetch implementation (defaults to global fetch) */
+  fetch?: typeof fetch;
+  /** Default timeout in milliseconds (default: 30000) */
+  timeout?: number;
+}
+/** Options for individual requests */
+interface RequestOptions {
+  /** AbortSignal for cancellation */
+  signal?: AbortSignal;
+  /** Request-specific timeout in milliseconds */
+  timeout?: number;
+}
+/** Paginated search result */
+interface SearchResult<T> {
+  /** Array of items */
+  data: T[];
+  /** Cursor for next page, null if no more pages */
+  nextCursor: string | null;
+}
+//#endregion
+//#region src/client.d.ts
+declare class KopaiClient {
+  private readonly baseUrl;
+  private readonly fetchFn;
+  private readonly defaultTimeout;
+  private readonly baseHeaders;
+  constructor(options: KopaiClientOptions);
+  /**
+   * Get all spans for a specific trace by ID.
+   */
+  getTrace(traceId: string, opts?: RequestOptions): Promise<OtelTracesRow[]>;
+  /**
+   * Search traces with auto-pagination.
+   * Yields individual trace rows.
+   */
+  searchTraces(filter: Omit<TracesDataFilter, "cursor">, opts?: RequestOptions): AsyncIterable<OtelTracesRow>;
+  /**
+   * Search traces for a single page.
+   * Use this for manual pagination.
+   */
+  searchTracesPage(filter: TracesDataFilter, opts?: RequestOptions): Promise<SearchResult<OtelTracesRow>>;
+  /**
+   * Search logs with auto-pagination.
+   * Yields individual log rows.
+   */
+  searchLogs(filter: Omit<LogsDataFilter, "cursor">, opts?: RequestOptions): AsyncIterable<OtelLogsRow>;
+  /**
+   * Search logs for a single page.
+   * Use this for manual pagination.
+   */
+  searchLogsPage(filter: LogsDataFilter, opts?: RequestOptions): Promise<SearchResult<OtelLogsRow>>;
+  /**
+   * Search metrics with auto-pagination.
+   * Yields individual metric rows.
+   */
+  searchMetrics(filter: Omit<MetricsDataFilter, "cursor">, opts?: RequestOptions): AsyncIterable<OtelMetricsRow>;
+  /**
+   * Search metrics for a single page.
+   * Use this for manual pagination.
+   */
+  searchMetricsPage(filter: MetricsDataFilter, opts?: RequestOptions): Promise<SearchResult<OtelMetricsRow>>;
+  /**
+   * Discover available metrics and their attributes.
+   */
+  discoverMetrics(opts?: RequestOptions): Promise<MetricsDiscoveryResult>;
+}
+//#endregion
+//#region src/errors.d.ts
+/**
+ * Base error for Kopai API errors (non-2xx responses).
+ * Follows RFC 7807 Problem Details format.
+ */
+declare class KopaiError extends Error {
+  /** Error code from problem type */
+  code: string;
+  /** HTTP status code */
+  status: number;
+  /** URI identifying the problem type */
+  type: string;
+  /** Human-readable explanation */
+  detail?: string;
+  constructor(options: {
+    message: string;
+    code: string;
+    status: number;
+    type: string;
+    detail?: string;
+  });
+}
+/**
+ * Network-level errors (connection failed, DNS resolution, etc.)
+ */
+declare class KopaiNetworkError extends Error {
+  /** Original error that caused this */
+  cause?: Error;
+  constructor(message: string, cause?: Error);
+}
+/**
+ * Request timeout errors
+ */
+declare class KopaiTimeoutError extends Error {
+  /** Timeout duration in milliseconds */
+  timeout: number;
+  constructor(timeout: number);
+}
+/**
+ * Response validation errors (Zod schema validation failed)
+ */
+declare class KopaiValidationError extends Error {
+  /** Original Zod error */
+  zodError: ZodError;
+  constructor(zodError: ZodError);
+}
+//#endregion
+export { type DiscoveredMetric, type DiscoveredMetricAttributes, KopaiClient, type KopaiClientOptions, KopaiError, KopaiNetworkError, KopaiTimeoutError, KopaiValidationError, type LogsDataFilter, type MetricsDataFilter, type MetricsDiscoveryResult, type OtelLogsRow, type OtelMetricsRow, type OtelTracesRow, type RequestOptions, type SearchResult, type TracesDataFilter };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/client.ts","../src/errors.ts"],"mappings":";;;;KAUY,gBAAA,GAAmB,iBAAA,CAAkB,gBAAA;AAAA,KACrC,cAAA,GAAiB,iBAAA,CAAkB,cAAA;AAAA,KACnC,iBAAA,GAAoB,iBAAA,CAAkB,iBAAA;AAAA,KAEtC,aAAA,GAAgB,mBAAA,CAAoB,aAAA;AAAA,KACpC,WAAA,GAAc,mBAAA,CAAoB,WAAA;AAAA,KAClC,cAAA,GAAiB,mBAAA,CAAoB,cAAA;AAAA,KAErC,sBAAA,GAAyB,UAAA,CAAW,sBAAA;AAAA,KACpC,gBAAA,GAAmB,UAAA,CAAW,gBAAA;AAAA,KAC9B,0BAAA,GAA6B,UAAA,CAAW,0BAAA;;UAGnC,kBAAA;EAXY;EAa3B,OAAA;EAb8B;EAe9B,KAAA;EAbU;EAeV,OAAA,GAAU,MAAA;;EAEV,KAAA,UAAe,KAAA;EAjB4C;EAmB3D,OAAA;AAAA;;UAIe,cAAA;EAtBwC;EAwBvD,MAAA,GAAS,WAAA;EAvBe;EAyBxB,OAAA;AAAA;;UAIe,YAAA;EA3BiB;EA6BhC,IAAA,EAAM,CAAA;EA7B6B;EA+BnC,UAAA;AAAA;;;cCWW,WAAA;EAAA,iBACM,OAAA;EAAA,iBACA,OAAA;EAAA,iBACA,cAAA;EAAA,iBACA,WAAA;cAEL,OAAA,EAAS,kBAAA;EDxDQ;;AAC/B;ECwEQ,QAAA,CACJ,OAAA,UACA,IAAA,GAAO,cAAA,GACN,OAAA,CAAQ,aAAA;;;;AD1Eb;ECyFE,YAAA,CACE,MAAA,EAAQ,IAAA,CAAK,gBAAA,aACb,IAAA,GAAO,cAAA,GACN,aAAA,CAAc,aAAA;;;;AD1FnB;ECsGQ,gBAAA,CACJ,MAAA,EAAQ,gBAAA,EACR,IAAA,GAAO,cAAA,GACN,OAAA,CAAQ,YAAA,CAAa,aAAA;;;;ADxG1B;EC2HE,UAAA,CACE,MAAA,EAAQ,IAAA,CAAK,cAAA,aACb,IAAA,GAAO,cAAA,GACN,aAAA,CAAc,WAAA;;;;AD7HnB;ECyIQ,cAAA,CACJ,MAAA,EAAQ,cAAA,EACR,IAAA,GAAO,cAAA,GACN,OAAA,CAAQ,YAAA,CAAa,WAAA;;;;AD1I1B;EC6JE,aAAA,CACE,MAAA,EAAQ,IAAA,CAAK,iBAAA,aACb,IAAA,GAAO,cAAA,GACN,aAAA,CAAc,cAAA;;;;AD/JnB;EC2KQ,iBAAA,CACJ,MAAA,EAAQ,iBAAA,EACR,IAAA,GAAO,cAAA,GACN,OAAA,CAAQ,YAAA,CAAa,cAAA;;;;EAkBlB,eAAA,CACJ,IAAA,GAAO,cAAA,GACN,OAAA,CAAQ,sBAAA;AAAA;;;;;;AD3Mb;cEJa,UAAA,SAAmB,KAAA;;EAE9B,IAAA;EFE+D;EEA/D,MAAA;EFCwB;EECxB,IAAA;EFD2B;EEG3B,MAAA;cAEY,OAAA;IACV,OAAA;IACA,IAAA;IACA,MAAA;IACA,IAAA;IACA,MAAA;EAAA;AAAA;;;AFNJ;cEoBa,iBAAA,SAA0B,KAAA;;EAErC,KAAA,GAAQ,KAAA;cAEI,OAAA,UAAiB,KAAA,GAAQ,KAAA;AAAA;;;;cAU1B,iBAAA,SAA0B,KAAA;EF/B3B;EEiCV,OAAA;cAEY,OAAA;AAAA;;AFlCd;;cE4Ca,oBAAA,SAA6B,KAAA;EF5CX;EE8C7B,QAAA,EAAU,QAAA;cAEE,QAAA,EAAU,QAAA;AAAA"}

package/dist/index.d.ts

@@ -0,0 +1,137 @@
+import { dataFilterSchemas, datasource, denormalizedSignals } from "@kopai/core";
+import { ZodError } from "zod";
+
+//#region src/types.d.ts
+type TracesDataFilter = dataFilterSchemas.TracesDataFilter;
+type LogsDataFilter = dataFilterSchemas.LogsDataFilter;
+type MetricsDataFilter = dataFilterSchemas.MetricsDataFilter;
+type OtelTracesRow = denormalizedSignals.OtelTracesRow;
+type OtelLogsRow = denormalizedSignals.OtelLogsRow;
+type OtelMetricsRow = denormalizedSignals.OtelMetricsRow;
+type MetricsDiscoveryResult = datasource.MetricsDiscoveryResult;
+type DiscoveredMetric = datasource.DiscoveredMetric;
+type DiscoveredMetricAttributes = datasource.DiscoveredMetricAttributes;
+/** Options for KopaiClient constructor */
+interface KopaiClientOptions {
+  /** Base URL for the Kopai API */
+  baseUrl: string;
+  /** Bearer token for authentication */
+  token?: string;
+  /** Additional headers to include in requests */
+  headers?: Record<string, string>;
+  /** Custom fetch implementation (defaults to global fetch) */
+  fetch?: typeof fetch;
+  /** Default timeout in milliseconds (default: 30000) */
+  timeout?: number;
+}
+/** Options for individual requests */
+interface RequestOptions {
+  /** AbortSignal for cancellation */
+  signal?: AbortSignal;
+  /** Request-specific timeout in milliseconds */
+  timeout?: number;
+}
+/** Paginated search result */
+interface SearchResult<T> {
+  /** Array of items */
+  data: T[];
+  /** Cursor for next page, null if no more pages */
+  nextCursor: string | null;
+}
+//#endregion
+//#region src/client.d.ts
+declare class KopaiClient {
+  private readonly baseUrl;
+  private readonly fetchFn;
+  private readonly defaultTimeout;
+  private readonly baseHeaders;
+  constructor(options: KopaiClientOptions);
+  /**
+   * Get all spans for a specific trace by ID.
+   */
+  getTrace(traceId: string, opts?: RequestOptions): Promise<OtelTracesRow[]>;
+  /**
+   * Search traces with auto-pagination.
+   * Yields individual trace rows.
+   */
+  searchTraces(filter: Omit<TracesDataFilter, "cursor">, opts?: RequestOptions): AsyncIterable<OtelTracesRow>;
+  /**
+   * Search traces for a single page.
+   * Use this for manual pagination.
+   */
+  searchTracesPage(filter: TracesDataFilter, opts?: RequestOptions): Promise<SearchResult<OtelTracesRow>>;
+  /**
+   * Search logs with auto-pagination.
+   * Yields individual log rows.
+   */
+  searchLogs(filter: Omit<LogsDataFilter, "cursor">, opts?: RequestOptions): AsyncIterable<OtelLogsRow>;
+  /**
+   * Search logs for a single page.
+   * Use this for manual pagination.
+   */
+  searchLogsPage(filter: LogsDataFilter, opts?: RequestOptions): Promise<SearchResult<OtelLogsRow>>;
+  /**
+   * Search metrics with auto-pagination.
+   * Yields individual metric rows.
+   */
+  searchMetrics(filter: Omit<MetricsDataFilter, "cursor">, opts?: RequestOptions): AsyncIterable<OtelMetricsRow>;
+  /**
+   * Search metrics for a single page.
+   * Use this for manual pagination.
+   */
+  searchMetricsPage(filter: MetricsDataFilter, opts?: RequestOptions): Promise<SearchResult<OtelMetricsRow>>;
+  /**
+   * Discover available metrics and their attributes.
+   */
+  discoverMetrics(opts?: RequestOptions): Promise<MetricsDiscoveryResult>;
+}
+//#endregion
+//#region src/errors.d.ts
+/**
+ * Base error for Kopai API errors (non-2xx responses).
+ * Follows RFC 7807 Problem Details format.
+ */
+declare class KopaiError extends Error {
+  /** Error code from problem type */
+  code: string;
+  /** HTTP status code */
+  status: number;
+  /** URI identifying the problem type */
+  type: string;
+  /** Human-readable explanation */
+  detail?: string;
+  constructor(options: {
+    message: string;
+    code: string;
+    status: number;
+    type: string;
+    detail?: string;
+  });
+}
+/**
+ * Network-level errors (connection failed, DNS resolution, etc.)
+ */
+declare class KopaiNetworkError extends Error {
+  /** Original error that caused this */
+  cause?: Error;
+  constructor(message: string, cause?: Error);
+}
+/**
+ * Request timeout errors
+ */
+declare class KopaiTimeoutError extends Error {
+  /** Timeout duration in milliseconds */
+  timeout: number;
+  constructor(timeout: number);
+}
+/**
+ * Response validation errors (Zod schema validation failed)
+ */
+declare class KopaiValidationError extends Error {
+  /** Original Zod error */
+  zodError: ZodError;
+  constructor(zodError: ZodError);
+}
+//#endregion
+export { type DiscoveredMetric, type DiscoveredMetricAttributes, KopaiClient, type KopaiClientOptions, KopaiError, KopaiNetworkError, KopaiTimeoutError, KopaiValidationError, type LogsDataFilter, type MetricsDataFilter, type MetricsDiscoveryResult, type OtelLogsRow, type OtelMetricsRow, type OtelTracesRow, type RequestOptions, type SearchResult, type TracesDataFilter };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/types.ts","../src/client.ts","../src/errors.ts"],"mappings":";;;;KAUY,gBAAA,GAAmB,iBAAA,CAAkB,gBAAA;AAAA,KACrC,cAAA,GAAiB,iBAAA,CAAkB,cAAA;AAAA,KACnC,iBAAA,GAAoB,iBAAA,CAAkB,iBAAA;AAAA,KAEtC,aAAA,GAAgB,mBAAA,CAAoB,aAAA;AAAA,KACpC,WAAA,GAAc,mBAAA,CAAoB,WAAA;AAAA,KAClC,cAAA,GAAiB,mBAAA,CAAoB,cAAA;AAAA,KAErC,sBAAA,GAAyB,UAAA,CAAW,sBAAA;AAAA,KACpC,gBAAA,GAAmB,UAAA,CAAW,gBAAA;AAAA,KAC9B,0BAAA,GAA6B,UAAA,CAAW,0BAAA;;UAGnC,kBAAA;EAXY;EAa3B,OAAA;EAb8B;EAe9B,KAAA;EAbU;EAeV,OAAA,GAAU,MAAA;;EAEV,KAAA,UAAe,KAAA;EAjB4C;EAmB3D,OAAA;AAAA;;UAIe,cAAA;EAtBwC;EAwBvD,MAAA,GAAS,WAAA;EAvBe;EAyBxB,OAAA;AAAA;;UAIe,YAAA;EA3BiB;EA6BhC,IAAA,EAAM,CAAA;EA7B6B;EA+BnC,UAAA;AAAA;;;cCWW,WAAA;EAAA,iBACM,OAAA;EAAA,iBACA,OAAA;EAAA,iBACA,cAAA;EAAA,iBACA,WAAA;cAEL,OAAA,EAAS,kBAAA;EDxDQ;;AAC/B;ECwEQ,QAAA,CACJ,OAAA,UACA,IAAA,GAAO,cAAA,GACN,OAAA,CAAQ,aAAA;;;;AD1Eb;ECyFE,YAAA,CACE,MAAA,EAAQ,IAAA,CAAK,gBAAA,aACb,IAAA,GAAO,cAAA,GACN,aAAA,CAAc,aAAA;;;;AD1FnB;ECsGQ,gBAAA,CACJ,MAAA,EAAQ,gBAAA,EACR,IAAA,GAAO,cAAA,GACN,OAAA,CAAQ,YAAA,CAAa,aAAA;;;;ADxG1B;EC2HE,UAAA,CACE,MAAA,EAAQ,IAAA,CAAK,cAAA,aACb,IAAA,GAAO,cAAA,GACN,aAAA,CAAc,WAAA;;;;AD7HnB;ECyIQ,cAAA,CACJ,MAAA,EAAQ,cAAA,EACR,IAAA,GAAO,cAAA,GACN,OAAA,CAAQ,YAAA,CAAa,WAAA;;;;AD1I1B;EC6JE,aAAA,CACE,MAAA,EAAQ,IAAA,CAAK,iBAAA,aACb,IAAA,GAAO,cAAA,GACN,aAAA,CAAc,cAAA;;;;AD/JnB;EC2KQ,iBAAA,CACJ,MAAA,EAAQ,iBAAA,EACR,IAAA,GAAO,cAAA,GACN,OAAA,CAAQ,YAAA,CAAa,cAAA;;;;EAkBlB,eAAA,CACJ,IAAA,GAAO,cAAA,GACN,OAAA,CAAQ,sBAAA;AAAA;;;;;;AD3Mb;cEJa,UAAA,SAAmB,KAAA;;EAE9B,IAAA;EFE+D;EEA/D,MAAA;EFCwB;EECxB,IAAA;EFD2B;EEG3B,MAAA;cAEY,OAAA;IACV,OAAA;IACA,IAAA;IACA,MAAA;IACA,IAAA;IACA,MAAA;EAAA;AAAA;;;AFNJ;cEoBa,iBAAA,SAA0B,KAAA;;EAErC,KAAA,GAAQ,KAAA;cAEI,OAAA,UAAiB,KAAA,GAAQ,KAAA;AAAA;;;;cAU1B,iBAAA,SAA0B,KAAA;EF/B3B;EEiCV,OAAA;cAEY,OAAA;AAAA;;AFlCd;;cE4Ca,oBAAA,SAA6B,KAAA;EF5CX;EE8C7B,QAAA,EAAU,QAAA;cAEE,QAAA,EAAU,QAAA;AAAA"}

package/dist/index.js

@@ -0,0 +1,305 @@
+import { dataFilterSchemas, denormalizedSignals } from "@kopai/core";
+import z from "zod";
+
+//#region src/errors.ts
+/**
+* Base error for Kopai API errors (non-2xx responses).
+* Follows RFC 7807 Problem Details format.
+*/
+var KopaiError = class extends Error {
+	/** Error code from problem type */
+	code;
+	/** HTTP status code */
+	status;
+	/** URI identifying the problem type */
+	type;
+	/** Human-readable explanation */
+	detail;
+	constructor(options) {
+		super(options.message);
+		this.name = "KopaiError";
+		this.code = options.code;
+		this.status = options.status;
+		this.type = options.type;
+		this.detail = options.detail;
+	}
+};
+/**
+* Network-level errors (connection failed, DNS resolution, etc.)
+*/
+var KopaiNetworkError = class extends Error {
+	/** Original error that caused this */
+	cause;
+	constructor(message, cause) {
+		super(message);
+		this.name = "KopaiNetworkError";
+		this.cause = cause;
+	}
+};
+/**
+* Request timeout errors
+*/
+var KopaiTimeoutError = class extends Error {
+	/** Timeout duration in milliseconds */
+	timeout;
+	constructor(timeout) {
+		super(`Request timed out after ${timeout}ms`);
+		this.name = "KopaiTimeoutError";
+		this.timeout = timeout;
+	}
+};
+/**
+* Response validation errors (Zod schema validation failed)
+*/
+var KopaiValidationError = class extends Error {
+	/** Original Zod error */
+	zodError;
+	constructor(zodError) {
+		super(`Response validation failed: ${zodError.message}`);
+		this.name = "KopaiValidationError";
+		this.zodError = zodError;
+	}
+};
+
+//#endregion
+//#region src/request.ts
+const DEFAULT_TIMEOUT$1 = 3e4;
+/**
+* Internal fetch wrapper with timeout, signal, and Zod validation.
+*/
+async function request(url, schema, options) {
+	const { method = "GET", body, headers = {}, baseHeaders = {}, signal, timeout, fetchFn, defaultTimeout } = options;
+	const effectiveTimeout = timeout ?? defaultTimeout ?? DEFAULT_TIMEOUT$1;
+	const timeoutController = new AbortController();
+	const timeoutId = setTimeout(() => timeoutController.abort(), effectiveTimeout);
+	const combinedSignal = signal ? AbortSignal.any([signal, timeoutController.signal]) : timeoutController.signal;
+	try {
+		const response = await fetchFn(url, {
+			method,
+			headers: {
+				"Content-Type": "application/json",
+				...baseHeaders,
+				...headers
+			},
+			body: body ? JSON.stringify(body) : void 0,
+			signal: combinedSignal
+		});
+		clearTimeout(timeoutId);
+		if (!response.ok) await handleErrorResponse(response);
+		const data = await response.json();
+		const result = schema.safeParse(data);
+		if (!result.success) throw new KopaiValidationError(result.error);
+		return result.data;
+	} catch (error) {
+		clearTimeout(timeoutId);
+		if (error instanceof KopaiError || error instanceof KopaiValidationError || error instanceof KopaiTimeoutError || error instanceof KopaiNetworkError) throw error;
+		if (error instanceof DOMException && error.name === "AbortError") {
+			if (timeoutController.signal.aborted) throw new KopaiTimeoutError(effectiveTimeout);
+			throw error;
+		}
+		if (error instanceof TypeError) throw new KopaiNetworkError(error.message || "Network request failed", error);
+		throw error;
+	}
+}
+async function handleErrorResponse(response) {
+	let body;
+	try {
+		body = await response.json();
+	} catch {
+		body = null;
+	}
+	if (body && typeof body === "object") {
+		const problem = body;
+		throw new KopaiError({
+			message: problem.title || problem.message || `HTTP ${response.status}`,
+			code: problem.code || `HTTP_${response.status}`,
+			status: response.status,
+			type: problem.type || `about:blank`,
+			detail: problem.detail
+		});
+	}
+	throw new KopaiError({
+		message: `HTTP ${response.status}`,
+		code: `HTTP_${response.status}`,
+		status: response.status,
+		type: "about:blank"
+	});
+}
+
+//#endregion
+//#region src/pagination.ts
+/**
+* Creates an async iterator that auto-paginates through results.
+* Yields individual items from each page.
+*/
+async function* paginate(fetcher, signal) {
+	let cursor;
+	do {
+		signal?.throwIfAborted();
+		const result = await fetcher(cursor, signal);
+		for (const item of result.data) yield item;
+		cursor = result.nextCursor ?? void 0;
+	} while (cursor);
+}
+
+//#endregion
+//#region src/client.ts
+const DEFAULT_TIMEOUT = 3e4;
+const tracesResponseSchema = z.object({
+	data: z.array(denormalizedSignals.otelTracesSchema),
+	nextCursor: z.string().nullable()
+});
+const logsResponseSchema = z.object({
+	data: z.array(denormalizedSignals.otelLogsSchema),
+	nextCursor: z.string().nullable()
+});
+const metricsResponseSchema = z.object({
+	data: z.array(denormalizedSignals.otelMetricsSchema),
+	nextCursor: z.string().nullable()
+});
+const metricsDiscoverySchema = z.object({ metrics: z.array(z.object({
+	name: z.string(),
+	type: z.enum([
+		"Gauge",
+		"Sum",
+		"Histogram",
+		"ExponentialHistogram",
+		"Summary"
+	]),
+	unit: z.string().optional(),
+	description: z.string().optional(),
+	attributes: z.object({
+		values: z.record(z.string(), z.array(z.string())),
+		_truncated: z.boolean().optional()
+	}),
+	resourceAttributes: z.object({
+		values: z.record(z.string(), z.array(z.string())),
+		_truncated: z.boolean().optional()
+	})
+})) });
+var KopaiClient = class {
+	baseUrl;
+	fetchFn;
+	defaultTimeout;
+	baseHeaders;
+	constructor(options) {
+		this.baseUrl = options.baseUrl.replace(/\/$/, "");
+		this.fetchFn = options.fetch ?? fetch;
+		this.defaultTimeout = options.timeout ?? DEFAULT_TIMEOUT;
+		this.baseHeaders = { ...options.headers };
+		if (options.token) this.baseHeaders["Authorization"] = `Bearer ${options.token}`;
+	}
+	/**
+	* Get all spans for a specific trace by ID.
+	*/
+	async getTrace(traceId, opts) {
+		const schema = z.array(denormalizedSignals.otelTracesSchema);
+		return request(`${this.baseUrl}/traces/${traceId}`, schema, {
+			method: "GET",
+			...opts,
+			baseHeaders: this.baseHeaders,
+			fetchFn: this.fetchFn,
+			defaultTimeout: this.defaultTimeout
+		});
+	}
+	/**
+	* Search traces with auto-pagination.
+	* Yields individual trace rows.
+	*/
+	searchTraces(filter, opts) {
+		return paginate((cursor, signal) => this.searchTracesPage({
+			...filter,
+			cursor
+		}, {
+			...opts,
+			signal
+		}), opts?.signal);
+	}
+	/**
+	* Search traces for a single page.
+	* Use this for manual pagination.
+	*/
+	async searchTracesPage(filter, opts) {
+		const validatedFilter = dataFilterSchemas.tracesDataFilterSchema.parse(filter);
+		return request(`${this.baseUrl}/traces/search`, tracesResponseSchema, {
+			method: "POST",
+			body: validatedFilter,
+			...opts,
+			baseHeaders: this.baseHeaders,
+			fetchFn: this.fetchFn,
+			defaultTimeout: this.defaultTimeout
+		});
+	}
+	/**
+	* Search logs with auto-pagination.
+	* Yields individual log rows.
+	*/
+	searchLogs(filter, opts) {
+		return paginate((cursor, signal) => this.searchLogsPage({
+			...filter,
+			cursor
+		}, {
+			...opts,
+			signal
+		}), opts?.signal);
+	}
+	/**
+	* Search logs for a single page.
+	* Use this for manual pagination.
+	*/
+	async searchLogsPage(filter, opts) {
+		const validatedFilter = dataFilterSchemas.logsDataFilterSchema.parse(filter);
+		return request(`${this.baseUrl}/logs/search`, logsResponseSchema, {
+			method: "POST",
+			body: validatedFilter,
+			...opts,
+			baseHeaders: this.baseHeaders,
+			fetchFn: this.fetchFn,
+			defaultTimeout: this.defaultTimeout
+		});
+	}
+	/**
+	* Search metrics with auto-pagination.
+	* Yields individual metric rows.
+	*/
+	searchMetrics(filter, opts) {
+		return paginate((cursor, signal) => this.searchMetricsPage({
+			...filter,
+			cursor
+		}, {
+			...opts,
+			signal
+		}), opts?.signal);
+	}
+	/**
+	* Search metrics for a single page.
+	* Use this for manual pagination.
+	*/
+	async searchMetricsPage(filter, opts) {
+		const validatedFilter = dataFilterSchemas.metricsDataFilterSchema.parse(filter);
+		return request(`${this.baseUrl}/metrics/search`, metricsResponseSchema, {
+			method: "POST",
+			body: validatedFilter,
+			...opts,
+			baseHeaders: this.baseHeaders,
+			fetchFn: this.fetchFn,
+			defaultTimeout: this.defaultTimeout
+		});
+	}
+	/**
+	* Discover available metrics and their attributes.
+	*/
+	async discoverMetrics(opts) {
+		return request(`${this.baseUrl}/metrics/discover`, metricsDiscoverySchema, {
+			method: "GET",
+			...opts,
+			baseHeaders: this.baseHeaders,
+			fetchFn: this.fetchFn,
+			defaultTimeout: this.defaultTimeout
+		});
+	}
+};
+
+//#endregion
+export { KopaiClient, KopaiError, KopaiNetworkError, KopaiTimeoutError, KopaiValidationError };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["DEFAULT_TIMEOUT"],"sources":["../src/errors.ts","../src/request.ts","../src/pagination.ts","../src/client.ts"],"sourcesContent":["import type { ZodError } from \"zod\";\n\n/**\n * Base error for Kopai API errors (non-2xx responses).\n * Follows RFC 7807 Problem Details format.\n */\nexport class KopaiError extends Error {\n  /** Error code from problem type */\n  code: string;\n  /** HTTP status code */\n  status: number;\n  /** URI identifying the problem type */\n  type: string;\n  /** Human-readable explanation */\n  detail?: string;\n\n  constructor(options: {\n    message: string;\n    code: string;\n    status: number;\n    type: string;\n    detail?: string;\n  }) {\n    super(options.message);\n    this.name = \"KopaiError\";\n    this.code = options.code;\n    this.status = options.status;\n    this.type = options.type;\n    this.detail = options.detail;\n  }\n}\n\n/**\n * Network-level errors (connection failed, DNS resolution, etc.)\n */\nexport class KopaiNetworkError extends Error {\n  /** Original error that caused this */\n  cause?: Error;\n\n  constructor(message: string, cause?: Error) {\n    super(message);\n    this.name = \"KopaiNetworkError\";\n    this.cause = cause;\n  }\n}\n\n/**\n * Request timeout errors\n */\nexport class KopaiTimeoutError extends Error {\n  /** Timeout duration in milliseconds */\n  timeout: number;\n\n  constructor(timeout: number) {\n    super(`Request timed out after ${timeout}ms`);\n    this.name = \"KopaiTimeoutError\";\n    this.timeout = timeout;\n  }\n}\n\n/**\n * Response validation errors (Zod schema validation failed)\n */\nexport class KopaiValidationError extends Error {\n  /** Original Zod error */\n  zodError: ZodError;\n\n  constructor(zodError: ZodError) {\n    super(`Response validation failed: ${zodError.message}`);\n    this.name = \"KopaiValidationError\";\n    this.zodError = zodError;\n  }\n}\n","import type { ZodType } from \"zod\";\nimport {\n  KopaiError,\n  KopaiNetworkError,\n  KopaiTimeoutError,\n  KopaiValidationError,\n} from \"./errors.js\";\nimport type { RequestOptions } from \"./types.js\";\n\nconst DEFAULT_TIMEOUT = 30_000;\n\ninterface FetchOptions extends RequestOptions {\n  method?: \"GET\" | \"POST\";\n  body?: unknown;\n  headers?: Record<string, string>;\n  baseHeaders?: Record<string, string>;\n  fetchFn: typeof fetch;\n  defaultTimeout: number;\n}\n\n/**\n * Internal fetch wrapper with timeout, signal, and Zod validation.\n */\nexport async function request<T>(\n  url: string,\n  schema: ZodType<T>,\n  options: FetchOptions\n): Promise<T> {\n  const {\n    method = \"GET\",\n    body,\n    headers = {},\n    baseHeaders = {},\n    signal,\n    timeout,\n    fetchFn,\n    defaultTimeout,\n  } = options;\n\n  const effectiveTimeout = timeout ?? defaultTimeout ?? DEFAULT_TIMEOUT;\n\n  // Create timeout controller\n  const timeoutController = new AbortController();\n  const timeoutId = setTimeout(\n    () => timeoutController.abort(),\n    effectiveTimeout\n  );\n\n  // Combine signals if user provided one\n  const combinedSignal = signal\n    ? AbortSignal.any([signal, timeoutController.signal])\n    : timeoutController.signal;\n\n  try {\n    const response = await fetchFn(url, {\n      method,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...baseHeaders,\n        ...headers,\n      },\n      body: body ? JSON.stringify(body) : undefined,\n      signal: combinedSignal,\n    });\n\n    clearTimeout(timeoutId);\n\n    if (!response.ok) {\n      await handleErrorResponse(response);\n    }\n\n    const data = await response.json();\n\n    // Validate response with Zod schema\n    const result = schema.safeParse(data);\n    if (!result.success) {\n      throw new KopaiValidationError(result.error);\n    }\n\n    return result.data;\n  } catch (error) {\n    clearTimeout(timeoutId);\n\n    // Re-throw our errors\n    if (\n      error instanceof KopaiError ||\n      error instanceof KopaiValidationError ||\n      error instanceof KopaiTimeoutError ||\n      error instanceof KopaiNetworkError\n    ) {\n      throw error;\n    }\n\n    // Handle abort\n    if (error instanceof DOMException && error.name === \"AbortError\") {\n      // Check if it was our timeout or user cancellation\n      if (timeoutController.signal.aborted) {\n        throw new KopaiTimeoutError(effectiveTimeout);\n      }\n      // User cancelled\n      throw error;\n    }\n\n    // Network errors\n    if (error instanceof TypeError) {\n      throw new KopaiNetworkError(\n        error.message || \"Network request failed\",\n        error\n      );\n    }\n\n    throw error;\n  }\n}\n\nasync function handleErrorResponse(response: Response): Promise<never> {\n  let body: unknown;\n  try {\n    body = await response.json();\n  } catch {\n    body = null;\n  }\n\n  // Try to parse as RFC 7807 Problem Details\n  if (body && typeof body === \"object\") {\n    const problem = body as Record<string, unknown>;\n    throw new KopaiError({\n      message:\n        (problem.title as string) ||\n        (problem.message as string) ||\n        `HTTP ${response.status}`,\n      code: (problem.code as string) || `HTTP_${response.status}`,\n      status: response.status,\n      type: (problem.type as string) || `about:blank`,\n      detail: problem.detail as string | undefined,\n    });\n  }\n\n  throw new KopaiError({\n    message: `HTTP ${response.status}`,\n    code: `HTTP_${response.status}`,\n    status: response.status,\n    type: \"about:blank\",\n  });\n}\n","import type { SearchResult } from \"./types.js\";\n\ntype PageFetcher<T> = (\n  cursor: string | undefined,\n  signal?: AbortSignal\n) => Promise<SearchResult<T>>;\n\n/**\n * Creates an async iterator that auto-paginates through results.\n * Yields individual items from each page.\n */\nexport async function* paginate<T>(\n  fetcher: PageFetcher<T>,\n  signal?: AbortSignal\n): AsyncGenerator<T, void, undefined> {\n  let cursor: string | undefined;\n\n  do {\n    signal?.throwIfAborted();\n\n    const result = await fetcher(cursor, signal);\n\n    for (const item of result.data) {\n      yield item;\n    }\n\n    cursor = result.nextCursor ?? undefined;\n  } while (cursor);\n}\n","import { dataFilterSchemas, denormalizedSignals } from \"@kopai/core\";\nimport z from \"zod\";\nimport { request } from \"./request.js\";\nimport { paginate } from \"./pagination.js\";\nimport type {\n  KopaiClientOptions,\n  RequestOptions,\n  SearchResult,\n  TracesDataFilter,\n  LogsDataFilter,\n  MetricsDataFilter,\n  OtelTracesRow,\n  OtelLogsRow,\n  OtelMetricsRow,\n  MetricsDiscoveryResult,\n} from \"./types.js\";\n\nconst DEFAULT_TIMEOUT = 30_000;\n\n// Response schemas\nconst tracesResponseSchema = z.object({\n  data: z.array(denormalizedSignals.otelTracesSchema),\n  nextCursor: z.string().nullable(),\n});\n\nconst logsResponseSchema = z.object({\n  data: z.array(denormalizedSignals.otelLogsSchema),\n  nextCursor: z.string().nullable(),\n});\n\nconst metricsResponseSchema = z.object({\n  data: z.array(denormalizedSignals.otelMetricsSchema),\n  nextCursor: z.string().nullable(),\n});\n\nconst metricsDiscoverySchema = z.object({\n  metrics: z.array(\n    z.object({\n      name: z.string(),\n      type: z.enum([\n        \"Gauge\",\n        \"Sum\",\n        \"Histogram\",\n        \"ExponentialHistogram\",\n        \"Summary\",\n      ]),\n      unit: z.string().optional(),\n      description: z.string().optional(),\n      attributes: z.object({\n        values: z.record(z.string(), z.array(z.string())),\n        _truncated: z.boolean().optional(),\n      }),\n      resourceAttributes: z.object({\n        values: z.record(z.string(), z.array(z.string())),\n        _truncated: z.boolean().optional(),\n      }),\n    })\n  ),\n});\n\nexport class KopaiClient {\n  private readonly baseUrl: string;\n  private readonly fetchFn: typeof fetch;\n  private readonly defaultTimeout: number;\n  private readonly baseHeaders: Record<string, string>;\n\n  constructor(options: KopaiClientOptions) {\n    this.baseUrl = options.baseUrl.replace(/\\/$/, \"\"); // Remove trailing slash\n    this.fetchFn = options.fetch ?? fetch;\n    this.defaultTimeout = options.timeout ?? DEFAULT_TIMEOUT;\n\n    this.baseHeaders = {\n      ...options.headers,\n    };\n\n    if (options.token) {\n      this.baseHeaders[\"Authorization\"] = `Bearer ${options.token}`;\n    }\n  }\n\n  /**\n   * Get all spans for a specific trace by ID.\n   */\n  async getTrace(\n    traceId: string,\n    opts?: RequestOptions\n  ): Promise<OtelTracesRow[]> {\n    const schema = z.array(denormalizedSignals.otelTracesSchema);\n    return request(`${this.baseUrl}/traces/${traceId}`, schema, {\n      method: \"GET\",\n      ...opts,\n      baseHeaders: this.baseHeaders,\n      fetchFn: this.fetchFn,\n      defaultTimeout: this.defaultTimeout,\n    });\n  }\n\n  /**\n   * Search traces with auto-pagination.\n   * Yields individual trace rows.\n   */\n  searchTraces(\n    filter: Omit<TracesDataFilter, \"cursor\">,\n    opts?: RequestOptions\n  ): AsyncIterable<OtelTracesRow> {\n    return paginate(\n      (cursor, signal) =>\n        this.searchTracesPage({ ...filter, cursor }, { ...opts, signal }),\n      opts?.signal\n    );\n  }\n\n  /**\n   * Search traces for a single page.\n   * Use this for manual pagination.\n   */\n  async searchTracesPage(\n    filter: TracesDataFilter,\n    opts?: RequestOptions\n  ): Promise<SearchResult<OtelTracesRow>> {\n    // Validate filter\n    const validatedFilter =\n      dataFilterSchemas.tracesDataFilterSchema.parse(filter);\n\n    return request(`${this.baseUrl}/traces/search`, tracesResponseSchema, {\n      method: \"POST\",\n      body: validatedFilter,\n      ...opts,\n      baseHeaders: this.baseHeaders,\n      fetchFn: this.fetchFn,\n      defaultTimeout: this.defaultTimeout,\n    });\n  }\n\n  /**\n   * Search logs with auto-pagination.\n   * Yields individual log rows.\n   */\n  searchLogs(\n    filter: Omit<LogsDataFilter, \"cursor\">,\n    opts?: RequestOptions\n  ): AsyncIterable<OtelLogsRow> {\n    return paginate(\n      (cursor, signal) =>\n        this.searchLogsPage({ ...filter, cursor }, { ...opts, signal }),\n      opts?.signal\n    );\n  }\n\n  /**\n   * Search logs for a single page.\n   * Use this for manual pagination.\n   */\n  async searchLogsPage(\n    filter: LogsDataFilter,\n    opts?: RequestOptions\n  ): Promise<SearchResult<OtelLogsRow>> {\n    // Validate filter\n    const validatedFilter =\n      dataFilterSchemas.logsDataFilterSchema.parse(filter);\n\n    return request(`${this.baseUrl}/logs/search`, logsResponseSchema, {\n      method: \"POST\",\n      body: validatedFilter,\n      ...opts,\n      baseHeaders: this.baseHeaders,\n      fetchFn: this.fetchFn,\n      defaultTimeout: this.defaultTimeout,\n    });\n  }\n\n  /**\n   * Search metrics with auto-pagination.\n   * Yields individual metric rows.\n   */\n  searchMetrics(\n    filter: Omit<MetricsDataFilter, \"cursor\">,\n    opts?: RequestOptions\n  ): AsyncIterable<OtelMetricsRow> {\n    return paginate(\n      (cursor, signal) =>\n        this.searchMetricsPage({ ...filter, cursor }, { ...opts, signal }),\n      opts?.signal\n    );\n  }\n\n  /**\n   * Search metrics for a single page.\n   * Use this for manual pagination.\n   */\n  async searchMetricsPage(\n    filter: MetricsDataFilter,\n    opts?: RequestOptions\n  ): Promise<SearchResult<OtelMetricsRow>> {\n    // Validate filter\n    const validatedFilter =\n      dataFilterSchemas.metricsDataFilterSchema.parse(filter);\n\n    return request(`${this.baseUrl}/metrics/search`, metricsResponseSchema, {\n      method: \"POST\",\n      body: validatedFilter,\n      ...opts,\n      baseHeaders: this.baseHeaders,\n      fetchFn: this.fetchFn,\n      defaultTimeout: this.defaultTimeout,\n    });\n  }\n\n  /**\n   * Discover available metrics and their attributes.\n   */\n  async discoverMetrics(\n    opts?: RequestOptions\n  ): Promise<MetricsDiscoveryResult> {\n    return request(`${this.baseUrl}/metrics/discover`, metricsDiscoverySchema, {\n      method: \"GET\",\n      ...opts,\n      baseHeaders: this.baseHeaders,\n      fetchFn: this.fetchFn,\n      defaultTimeout: this.defaultTimeout,\n    });\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@kopai/sdk",
+  "version": "0.0.0",
+  "license": "Apache-2.0",
+  "author": "Vladimir Adamic",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kopai-app/kopai-mono.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/kopai-app/kopai-mono/tree/main/packages/sdk#readme",
+  "bugs": {
+    "url": "https://github.com/kopai-app/kopai-mono/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "zod": "^4.3.6",
+    "@kopai/core": "0.0.0"
+  },
+  "devDependencies": {
+    "msw": "^2.8.4",
+    "tsdown": "^0.20.1",
+    "@kopai/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "lint": "eslint src",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}