@kopai/api 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,225 @@
+//#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 fastify_type_provider_zod = require("fastify-type-provider-zod");
+require("fastify");
+let zod_v4 = require("zod/v4");
+let zod = require("zod");
+zod = __toESM(zod);
+
+//#region src/routes/errors.ts
+var SignalsApiError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+};
+
+//#endregion
+//#region src/routes/error-handler.ts
+function errorHandler(error, request, reply) {
+	if (isClientError(error)) return reply.status(400).send({
+		type: "https://docs.kopai.app/errors/signals-api-validation-error",
+		status: 400,
+		title: "Invalid data",
+		detail: error.message
+	});
+	request.log.error(error);
+	if (error instanceof SignalsApiError) return reply.status(500).send({
+		type: "https://docs.kopai.app/errors/signals-api-internal-error",
+		status: 500,
+		title: "Internal server error",
+		detail: error.message
+	});
+	return reply.status(500).send({
+		type: "https://docs.kopai.app/errors/signals-api-internal-error",
+		status: 500,
+		title: "Internal server error"
+	});
+}
+function isFastifyError(error) {
+	return error instanceof Error && "code" in error && typeof error.code === "string";
+}
+function isClientError(error) {
+	return isFastifyError(error) && typeof error.statusCode === "number" && error.statusCode >= 400 && error.statusCode < 500;
+}
+
+//#endregion
+//#region src/routes/error-schema-zod.ts
+const problemDetailsSchema = zod.default.object({
+	type: zod.default.url().default("about:blank").describe("URI reference identifying the problem type"),
+	status: zod.default.number().int().min(100).max(599).optional().describe("HTTP status code generated by the origin server"),
+	title: zod.default.string().optional().describe("Short human-readable summary of the problem type"),
+	detail: zod.default.string().optional().describe("Human-readable explanation specific to this occurrence"),
+	instance: zod.default.string().optional().describe("URI reference identifying this specific occurrence")
+});
+
+//#endregion
+//#region src/routes/traces.ts
+const tracesRoutes = async function(fastify, opts) {
+	fastify.route({
+		method: "GET",
+		url: "/signals/traces/:traceId",
+		schema: {
+			description: "Get all spans for a trace by traceId",
+			params: zod_v4.z.object({ traceId: zod_v4.z.string().describe("A TraceId of the trace") }),
+			response: {
+				200: zod_v4.z.array(_kopai_core.denormalizedSignals.otelTracesSchema),
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.readTracesDatasource.getTraces({ traceId: req.params.traceId });
+			res.send(result.data);
+		}
+	});
+	const searchResponseSchema = zod_v4.z.object({
+		data: zod_v4.z.array(_kopai_core.denormalizedSignals.otelTracesSchema),
+		nextCursor: zod_v4.z.string().nullable()
+	});
+	fastify.route({
+		method: "POST",
+		url: "/signals/traces/search",
+		schema: {
+			description: "Search spans matching a filter",
+			body: _kopai_core.dataFilterSchemas.tracesDataFilterSchema,
+			response: {
+				200: searchResponseSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.readTracesDatasource.getTraces(req.body);
+			res.send(result);
+		}
+	});
+};
+
+//#endregion
+//#region src/routes/logs.ts
+const logsRoutes = async function(fastify, opts) {
+	const searchResponseSchema = zod_v4.z.object({
+		data: zod_v4.z.array(_kopai_core.denormalizedSignals.otelLogsSchema),
+		nextCursor: zod_v4.z.string().nullable()
+	});
+	fastify.route({
+		method: "POST",
+		url: "/signals/logs/search",
+		schema: {
+			description: "Search logs matching a filter",
+			body: _kopai_core.dataFilterSchemas.logsDataFilterSchema,
+			response: {
+				200: searchResponseSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.readLogsDatasource.getLogs(req.body);
+			res.send(result);
+		}
+	});
+};
+
+//#endregion
+//#region src/routes/metrics.ts
+const metricsRoutes = async function(fastify, opts) {
+	const searchResponseSchema = zod_v4.z.object({
+		data: zod_v4.z.array(_kopai_core.denormalizedSignals.otelMetricsSchema),
+		nextCursor: zod_v4.z.string().nullable()
+	});
+	fastify.route({
+		method: "POST",
+		url: "/signals/metrics/search",
+		schema: {
+			description: "Search metrics matching a filter",
+			body: _kopai_core.dataFilterSchemas.metricsDataFilterSchema,
+			response: {
+				200: searchResponseSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.readMetricsDatasource.getMetrics(req.body);
+			res.send(result);
+		}
+	});
+	fastify.route({
+		method: "GET",
+		url: "/signals/metrics/discover",
+		schema: {
+			description: "Discover available metrics and their attributes",
+			response: {
+				200: metricsDiscoveryResponseSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (_req, res) => {
+			const result = await opts.readMetricsDatasource.discoverMetrics();
+			res.send(result);
+		}
+	});
+};
+const metricTypeSchema = zod_v4.z.enum([
+	"Gauge",
+	"Sum",
+	"Histogram",
+	"ExponentialHistogram",
+	"Summary"
+]);
+const discoveredAttributesSchema = zod_v4.z.object({
+	values: zod_v4.z.record(zod_v4.z.string(), zod_v4.z.array(zod_v4.z.string())).describe("Attribute key/value pairs. Max 100 values per key."),
+	_truncated: zod_v4.z.boolean().optional().describe("True if any attribute key exceeded 100 values.")
+});
+const discoveredMetricSchema = zod_v4.z.object({
+	name: zod_v4.z.string().describe("Metric name from MetricName field."),
+	type: metricTypeSchema.describe("Metric type: Gauge, Sum, Histogram, ExponentialHistogram, or Summary."),
+	unit: zod_v4.z.string().optional().describe("Metric unit from MetricUnit field."),
+	description: zod_v4.z.string().optional().describe("Metric description from MetricDescription field."),
+	attributes: discoveredAttributesSchema.describe("Data point attributes aggregated across all data points."),
+	resourceAttributes: discoveredAttributesSchema.describe("Resource attributes aggregated across all data points.")
+});
+const metricsDiscoveryResponseSchema = zod_v4.z.object({ metrics: zod_v4.z.array(discoveredMetricSchema) });
+
+//#endregion
+//#region src/index.ts
+const signalsRoutes = async function(fastify, opts) {
+	fastify.setValidatorCompiler(fastify_type_provider_zod.validatorCompiler);
+	fastify.setSerializerCompiler(fastify_type_provider_zod.serializerCompiler);
+	fastify.setErrorHandler(errorHandler);
+	fastify.register(tracesRoutes, { readTracesDatasource: opts.readTelemetryDatasource });
+	fastify.register(logsRoutes, { readLogsDatasource: opts.readTelemetryDatasource });
+	fastify.register(metricsRoutes, { readMetricsDatasource: opts.readTelemetryDatasource });
+};
+
+//#endregion
+exports.signalsRoutes = signalsRoutes;

package/dist/index.d.cts

@@ -0,0 +1,10 @@
+import { FastifyPluginAsyncZod } from "fastify-type-provider-zod";
+import { datasource } from "@kopai/core";
+
+//#region src/index.d.ts
+declare const signalsRoutes: FastifyPluginAsyncZod<{
+  readTelemetryDatasource: datasource.ReadTelemetryDatasource;
+}>;
+//#endregion
+export { signalsRoutes };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;cAWa,aAAA,EAAe,qBAAA;EAC1B,uBAAA,EAAyB,UAAA,CAAW,uBAAA;AAAA"}

package/dist/index.d.mts

@@ -0,0 +1,10 @@
+import { datasource } from "@kopai/core";
+import { FastifyPluginAsyncZod } from "fastify-type-provider-zod";
+
+//#region src/index.d.ts
+declare const signalsRoutes: FastifyPluginAsyncZod<{
+  readTelemetryDatasource: datasource.ReadTelemetryDatasource;
+}>;
+//#endregion
+export { signalsRoutes };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;cAWa,aAAA,EAAe,qBAAA;EAC1B,uBAAA,EAAyB,UAAA,CAAW,uBAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,198 @@
+import { dataFilterSchemas, denormalizedSignals } from "@kopai/core";
+import { serializerCompiler, validatorCompiler } from "fastify-type-provider-zod";
+import "fastify";
+import { z } from "zod/v4";
+import z$1 from "zod";
+
+//#region src/routes/errors.ts
+var SignalsApiError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		Object.setPrototypeOf(this, new.target.prototype);
+	}
+};
+
+//#endregion
+//#region src/routes/error-handler.ts
+function errorHandler(error, request, reply) {
+	if (isClientError(error)) return reply.status(400).send({
+		type: "https://docs.kopai.app/errors/signals-api-validation-error",
+		status: 400,
+		title: "Invalid data",
+		detail: error.message
+	});
+	request.log.error(error);
+	if (error instanceof SignalsApiError) return reply.status(500).send({
+		type: "https://docs.kopai.app/errors/signals-api-internal-error",
+		status: 500,
+		title: "Internal server error",
+		detail: error.message
+	});
+	return reply.status(500).send({
+		type: "https://docs.kopai.app/errors/signals-api-internal-error",
+		status: 500,
+		title: "Internal server error"
+	});
+}
+function isFastifyError(error) {
+	return error instanceof Error && "code" in error && typeof error.code === "string";
+}
+function isClientError(error) {
+	return isFastifyError(error) && typeof error.statusCode === "number" && error.statusCode >= 400 && error.statusCode < 500;
+}
+
+//#endregion
+//#region src/routes/error-schema-zod.ts
+const problemDetailsSchema = z$1.object({
+	type: z$1.url().default("about:blank").describe("URI reference identifying the problem type"),
+	status: z$1.number().int().min(100).max(599).optional().describe("HTTP status code generated by the origin server"),
+	title: z$1.string().optional().describe("Short human-readable summary of the problem type"),
+	detail: z$1.string().optional().describe("Human-readable explanation specific to this occurrence"),
+	instance: z$1.string().optional().describe("URI reference identifying this specific occurrence")
+});
+
+//#endregion
+//#region src/routes/traces.ts
+const tracesRoutes = async function(fastify, opts) {
+	fastify.route({
+		method: "GET",
+		url: "/signals/traces/:traceId",
+		schema: {
+			description: "Get all spans for a trace by traceId",
+			params: z.object({ traceId: z.string().describe("A TraceId of the trace") }),
+			response: {
+				200: z.array(denormalizedSignals.otelTracesSchema),
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.readTracesDatasource.getTraces({ traceId: req.params.traceId });
+			res.send(result.data);
+		}
+	});
+	const searchResponseSchema = z.object({
+		data: z.array(denormalizedSignals.otelTracesSchema),
+		nextCursor: z.string().nullable()
+	});
+	fastify.route({
+		method: "POST",
+		url: "/signals/traces/search",
+		schema: {
+			description: "Search spans matching a filter",
+			body: dataFilterSchemas.tracesDataFilterSchema,
+			response: {
+				200: searchResponseSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.readTracesDatasource.getTraces(req.body);
+			res.send(result);
+		}
+	});
+};
+
+//#endregion
+//#region src/routes/logs.ts
+const logsRoutes = async function(fastify, opts) {
+	const searchResponseSchema = z.object({
+		data: z.array(denormalizedSignals.otelLogsSchema),
+		nextCursor: z.string().nullable()
+	});
+	fastify.route({
+		method: "POST",
+		url: "/signals/logs/search",
+		schema: {
+			description: "Search logs matching a filter",
+			body: dataFilterSchemas.logsDataFilterSchema,
+			response: {
+				200: searchResponseSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.readLogsDatasource.getLogs(req.body);
+			res.send(result);
+		}
+	});
+};
+
+//#endregion
+//#region src/routes/metrics.ts
+const metricsRoutes = async function(fastify, opts) {
+	const searchResponseSchema = z.object({
+		data: z.array(denormalizedSignals.otelMetricsSchema),
+		nextCursor: z.string().nullable()
+	});
+	fastify.route({
+		method: "POST",
+		url: "/signals/metrics/search",
+		schema: {
+			description: "Search metrics matching a filter",
+			body: dataFilterSchemas.metricsDataFilterSchema,
+			response: {
+				200: searchResponseSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (req, res) => {
+			const result = await opts.readMetricsDatasource.getMetrics(req.body);
+			res.send(result);
+		}
+	});
+	fastify.route({
+		method: "GET",
+		url: "/signals/metrics/discover",
+		schema: {
+			description: "Discover available metrics and their attributes",
+			response: {
+				200: metricsDiscoveryResponseSchema,
+				"4xx": problemDetailsSchema,
+				"5xx": problemDetailsSchema
+			}
+		},
+		handler: async (_req, res) => {
+			const result = await opts.readMetricsDatasource.discoverMetrics();
+			res.send(result);
+		}
+	});
+};
+const metricTypeSchema = z.enum([
+	"Gauge",
+	"Sum",
+	"Histogram",
+	"ExponentialHistogram",
+	"Summary"
+]);
+const discoveredAttributesSchema = z.object({
+	values: z.record(z.string(), z.array(z.string())).describe("Attribute key/value pairs. Max 100 values per key."),
+	_truncated: z.boolean().optional().describe("True if any attribute key exceeded 100 values.")
+});
+const discoveredMetricSchema = z.object({
+	name: z.string().describe("Metric name from MetricName field."),
+	type: metricTypeSchema.describe("Metric type: Gauge, Sum, Histogram, ExponentialHistogram, or Summary."),
+	unit: z.string().optional().describe("Metric unit from MetricUnit field."),
+	description: z.string().optional().describe("Metric description from MetricDescription field."),
+	attributes: discoveredAttributesSchema.describe("Data point attributes aggregated across all data points."),
+	resourceAttributes: discoveredAttributesSchema.describe("Resource attributes aggregated across all data points.")
+});
+const metricsDiscoveryResponseSchema = z.object({ metrics: z.array(discoveredMetricSchema) });
+
+//#endregion
+//#region src/index.ts
+const signalsRoutes = async function(fastify, opts) {
+	fastify.setValidatorCompiler(validatorCompiler);
+	fastify.setSerializerCompiler(serializerCompiler);
+	fastify.setErrorHandler(errorHandler);
+	fastify.register(tracesRoutes, { readTracesDatasource: opts.readTelemetryDatasource });
+	fastify.register(logsRoutes, { readLogsDatasource: opts.readTelemetryDatasource });
+	fastify.register(metricsRoutes, { readMetricsDatasource: opts.readTelemetryDatasource });
+};
+
+//#endregion
+export { signalsRoutes };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["z"],"sources":["../src/routes/errors.ts","../src/routes/error-handler.ts","../src/routes/error-schema-zod.ts","../src/routes/traces.ts","../src/routes/logs.ts","../src/routes/metrics.ts","../src/index.ts"],"sourcesContent":["export abstract class SignalsApiError extends Error {\n  abstract readonly code: string;\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import {\n  type FastifyError,\n  type FastifyReply,\n  type FastifyRequest,\n} from \"fastify\";\nimport { SignalsApiError } from \"./errors.js\";\nimport type { SignalsApiErrorResponse } from \"./error-schema-zod.js\";\nexport function errorHandler(\n  error: FastifyError | Error | string,\n  request: FastifyRequest,\n  reply: FastifyReply\n) {\n  if (isClientError(error)) {\n    return reply.status(400).send({\n      // https://datatracker.ietf.org/doc/html/rfc9457\n      //      HTTP/1.1 422 Unprocessable Content\n      //      Content-Type: application/problem+json\n      //      Content-Language: en\n      //\n      //      {\n      //       \"type\": \"https://example.net/validation-error\",\n      //       \"title\": \"Your request is not valid.\",\n      //       \"errors\": [\n      //                   {\n      //                     \"detail\": \"must be a positive integer\",\n      //                     \"pointer\": \"#/age\"\n      //                   },\n      //                   {\n      //                     \"detail\": \"must be 'green', 'red' or 'blue'\",\n      //                     \"pointer\": \"#/profile/color\"\n      //                   }\n      //                ]\n      //      }\n      type: \"https://docs.kopai.app/errors/signals-api-validation-error\", // TODO: document error\n      status: 400,\n      title: \"Invalid data\",\n      detail: error.message,\n    } satisfies SignalsApiErrorResponse);\n  }\n\n  request.log.error(error);\n  if (error instanceof SignalsApiError) {\n    return reply.status(500).send({\n      type: \"https://docs.kopai.app/errors/signals-api-internal-error\", // TODO: document error\n      status: 500,\n      title: \"Internal server error\",\n      detail: error.message,\n    } satisfies SignalsApiErrorResponse);\n  }\n\n  return reply.status(500).send({\n    type: \"https://docs.kopai.app/errors/signals-api-internal-error\", // TODO: document error\n    status: 500,\n    title: \"Internal server error\",\n  } satisfies SignalsApiErrorResponse);\n}\n\nfunction isFastifyError(error: unknown): error is FastifyError {\n  return (\n    error instanceof Error &&\n    \"code\" in error &&\n    typeof (error as FastifyError).code === \"string\"\n  );\n}\n\nfunction isClientError(error: unknown): error is FastifyError {\n  return (\n    isFastifyError(error) &&\n    typeof error.statusCode === \"number\" &&\n    error.statusCode >= 400 &&\n    error.statusCode < 500\n  );\n}\n","import z from \"zod\";\n\nexport const problemDetailsSchema = z.object({\n  type: z\n    .url()\n    .default(\"about:blank\")\n    .describe(\"URI reference identifying the problem type\"),\n  status: z\n    .number()\n    .int()\n    .min(100)\n    .max(599)\n    .optional()\n    .describe(\"HTTP status code generated by the origin server\"),\n  title: z\n    .string()\n    .optional()\n    .describe(\"Short human-readable summary of the problem type\"),\n  detail: z\n    .string()\n    .optional()\n    .describe(\"Human-readable explanation specific to this occurrence\"),\n  instance: z\n    .string()\n    .optional()\n    .describe(\"URI reference identifying this specific occurrence\"),\n});\n\nexport type SignalsApiErrorResponse = z.infer<typeof problemDetailsSchema>;\n","import { z } from \"zod/v4\";\nimport type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport {\n  dataFilterSchemas,\n  denormalizedSignals,\n  type datasource,\n} from \"@kopai/core\";\nimport { problemDetailsSchema } from \"./error-schema-zod.js\";\n\nexport const tracesRoutes: FastifyPluginAsyncZod<{\n  readTracesDatasource: datasource.ReadTracesDatasource;\n}> = async function (fastify, opts) {\n  fastify.route({\n    method: \"GET\",\n    url: \"/signals/traces/:traceId\",\n    schema: {\n      description: \"Get all spans for a trace by traceId\",\n      params: z.object({\n        traceId: z.string().describe(\"A TraceId of the trace\"),\n      }),\n      response: {\n        200: z.array(denormalizedSignals.otelTracesSchema),\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readTracesDatasource.getTraces({\n        traceId: req.params.traceId,\n      });\n      res.send(result.data);\n    },\n  });\n\n  const searchResponseSchema = z.object({\n    data: z.array(denormalizedSignals.otelTracesSchema),\n    nextCursor: z.string().nullable(),\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/signals/traces/search\",\n    schema: {\n      description: \"Search spans matching a filter\",\n      body: dataFilterSchemas.tracesDataFilterSchema,\n      response: {\n        200: searchResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readTracesDatasource.getTraces(req.body);\n      res.send(result);\n    },\n  });\n};\n","import { z } from \"zod/v4\";\nimport type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport {\n  dataFilterSchemas,\n  denormalizedSignals,\n  type datasource,\n} from \"@kopai/core\";\nimport { problemDetailsSchema } from \"./error-schema-zod.js\";\n\nexport const logsRoutes: FastifyPluginAsyncZod<{\n  readLogsDatasource: datasource.ReadLogsDatasource;\n}> = async function (fastify, opts) {\n  const searchResponseSchema = z.object({\n    data: z.array(denormalizedSignals.otelLogsSchema),\n    nextCursor: z.string().nullable(),\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/signals/logs/search\",\n    schema: {\n      description: \"Search logs matching a filter\",\n      body: dataFilterSchemas.logsDataFilterSchema,\n      response: {\n        200: searchResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readLogsDatasource.getLogs(req.body);\n      res.send(result);\n    },\n  });\n};\n","import { z } from \"zod/v4\";\nimport type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport {\n  dataFilterSchemas,\n  denormalizedSignals,\n  type datasource,\n} from \"@kopai/core\";\nimport { problemDetailsSchema } from \"./error-schema-zod.js\";\n\nexport const metricsRoutes: FastifyPluginAsyncZod<{\n  readMetricsDatasource: datasource.ReadMetricsDatasource;\n}> = async function (fastify, opts) {\n  const searchResponseSchema = z.object({\n    data: z.array(denormalizedSignals.otelMetricsSchema),\n    nextCursor: z.string().nullable(),\n  });\n\n  fastify.route({\n    method: \"POST\",\n    url: \"/signals/metrics/search\",\n    schema: {\n      description: \"Search metrics matching a filter\",\n      body: dataFilterSchemas.metricsDataFilterSchema,\n      response: {\n        200: searchResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (req, res) => {\n      const result = await opts.readMetricsDatasource.getMetrics(req.body);\n      res.send(result);\n    },\n  });\n\n  fastify.route({\n    method: \"GET\",\n    url: \"/signals/metrics/discover\",\n    schema: {\n      description: \"Discover available metrics and their attributes\",\n      response: {\n        200: metricsDiscoveryResponseSchema,\n        \"4xx\": problemDetailsSchema,\n        \"5xx\": problemDetailsSchema,\n      },\n    },\n    handler: async (_req, res) => {\n      const result = await opts.readMetricsDatasource.discoverMetrics();\n      res.send(result);\n    },\n  });\n};\n\nconst metricTypeSchema = z.enum([\n  \"Gauge\",\n  \"Sum\",\n  \"Histogram\",\n  \"ExponentialHistogram\",\n  \"Summary\",\n]);\n\nconst discoveredAttributesSchema = z.object({\n  values: z\n    .record(z.string(), z.array(z.string()))\n    .describe(\"Attribute key/value pairs. Max 100 values per key.\"),\n  _truncated: z\n    .boolean()\n    .optional()\n    .describe(\"True if any attribute key exceeded 100 values.\"),\n});\n\nconst discoveredMetricSchema = z.object({\n  name: z.string().describe(\"Metric name from MetricName field.\"),\n  type: metricTypeSchema.describe(\n    \"Metric type: Gauge, Sum, Histogram, ExponentialHistogram, or Summary.\"\n  ),\n  unit: z.string().optional().describe(\"Metric unit from MetricUnit field.\"),\n  description: z\n    .string()\n    .optional()\n    .describe(\"Metric description from MetricDescription field.\"),\n  attributes: discoveredAttributesSchema.describe(\n    \"Data point attributes aggregated across all data points.\"\n  ),\n  resourceAttributes: discoveredAttributesSchema.describe(\n    \"Resource attributes aggregated across all data points.\"\n  ),\n});\n\nconst metricsDiscoveryResponseSchema = z.object({\n  metrics: z.array(discoveredMetricSchema),\n});\n","import type { FastifyPluginAsyncZod } from \"fastify-type-provider-zod\";\nimport { type datasource } from \"@kopai/core\";\nimport {\n  serializerCompiler,\n  validatorCompiler,\n} from \"fastify-type-provider-zod\";\nimport { errorHandler } from \"./routes/error-handler.js\";\nimport { tracesRoutes } from \"./routes/traces.js\";\nimport { logsRoutes } from \"./routes/logs.js\";\nimport { metricsRoutes } from \"./routes/metrics.js\";\n\nexport const signalsRoutes: FastifyPluginAsyncZod<{\n  readTelemetryDatasource: datasource.ReadTelemetryDatasource;\n}> = async function (fastify, opts) {\n  fastify.setValidatorCompiler(validatorCompiler);\n  fastify.setSerializerCompiler(serializerCompiler);\n  fastify.setErrorHandler(errorHandler);\n\n  fastify.register(tracesRoutes, {\n    readTracesDatasource: opts.readTelemetryDatasource,\n  });\n\n  fastify.register(logsRoutes, {\n    readLogsDatasource: opts.readTelemetryDatasource,\n  });\n\n  fastify.register(metricsRoutes, {\n    readMetricsDatasource: opts.readTelemetryDatasource,\n  });\n};\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@kopai/api",
+  "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/api"
+  },
+  "homepage": "https://github.com/kopai-app/kopai-mono/tree/main/packages/api#readme",
+  "bugs": {
+    "url": "https://github.com/kopai-app/kopai-mono/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "fastify": "^5.0.0",
+    "zod": "^4.0.0"
+  },
+  "dependencies": {
+    "fastify-type-provider-zod": "^6.1.0",
+    "@kopai/core": "0.0.0"
+  },
+  "devDependencies": {
+    "@fastify/swagger": "^9.6.1",
+    "@fastify/swagger-ui": "^5.2.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"
+  }
+}