arcane-sdk 0.1.0

package/dist/index.js

@@ -0,0 +1,377 @@
+"use strict";
+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 __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Arcan: () => Arcan,
+  ArcanApiError: () => ArcanApiError,
+  ArcanNotFoundError: () => ArcanNotFoundError,
+  ArcanUnauthorizedError: () => ArcanUnauthorizedError,
+  ArcaneClient: () => ArcaneClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_axios = __toESM(require("axios"));
+var import_axios_retry = __toESM(require("axios-retry"));
+
+// src/errors.ts
+var ArcanApiError = class _ArcanApiError extends Error {
+  constructor(message, statusCode, requestId, cause) {
+    super(message);
+    this.statusCode = statusCode;
+    this.requestId = requestId;
+    this.cause = cause;
+    this.name = "ArcanApiError";
+    Object.setPrototypeOf(this, _ArcanApiError.prototype);
+  }
+  static fromAxiosError(err) {
+    const status = err.response?.status;
+    const message = err.response?.data?.message ?? err.message ?? err.response?.statusText ?? "Unknown API error";
+    const requestId = err.response?.headers?.["x-request-id"];
+    return new _ArcanApiError(message, status, requestId, err);
+  }
+};
+var ArcanNotFoundError = class extends ArcanApiError {
+  constructor(message, requestId) {
+    super(message, 404, requestId);
+    this.name = "ArcanNotFoundError";
+  }
+};
+var ArcanUnauthorizedError = class extends ArcanApiError {
+  constructor(message, requestId) {
+    super(message, 401, requestId);
+    this.name = "ArcanUnauthorizedError";
+  }
+};
+
+// src/client.ts
+var ArcaneClient = class {
+  http;
+  constructor(config) {
+    const { baseUrl, apiKey, maxRetries = 3, timeout = 3e4 } = config;
+    const base = baseUrl.replace(/\/$/, "");
+    this.http = import_axios.default.create({
+      baseURL: base,
+      timeout,
+      auth: {
+        username: "api-key",
+        password: apiKey
+      },
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+    (0, import_axios_retry.default)(this.http, {
+      retries: maxRetries,
+      retryCondition: (err) => {
+        const status = err.response?.status;
+        if (status && status >= 500 && status < 600) return true;
+        if (err.code === "ECONNRESET" || err.code === "ETIMEDOUT") return true;
+        return false;
+      },
+      retryDelay: import_axios_retry.default.exponentialDelay
+    });
+  }
+  getHttp() {
+    return this.http;
+  }
+  async get(path, params) {
+    const res = await this.http.get(path, { params });
+    return res.data;
+  }
+  async post(path, body) {
+    const res = await this.http.post(path, body);
+    return res.data;
+  }
+  handleError(err) {
+    if (import_axios.default.isAxiosError(err)) {
+      throw ArcanApiError.fromAxiosError(err);
+    }
+    throw err;
+  }
+};
+
+// src/resources/prompts.ts
+var PromptsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    const res = await this.client.get("/api/public/prompts");
+    return res.data;
+  }
+  async get(promptIdentifier) {
+    const res = await this.client.get(
+      `/api/public/prompts/${encodeURIComponent(promptIdentifier)}`
+    );
+    return res.data;
+  }
+  async listVersions(promptIdentifier) {
+    const res = await this.client.get(
+      `/api/public/prompts/${encodeURIComponent(promptIdentifier)}/versions`
+    );
+    return res.data;
+  }
+  async getLatestVersion(promptIdentifier) {
+    const res = await this.client.get(
+      `/api/public/prompts/${encodeURIComponent(promptIdentifier)}/latest`
+    );
+    return res.data;
+  }
+};
+
+// src/resources/datasources.ts
+var DatasourcesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/api/public/datasources");
+  }
+};
+
+// src/resources/traces.ts
+var TracesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async search(datasourceId, params) {
+    return this.client.post(
+      `/api/public/datasources/${datasourceId}/traces/search`,
+      params ?? {}
+    );
+  }
+  async get(datasourceId, traceId) {
+    return this.client.get(
+      `/api/public/datasources/${datasourceId}/traces/${encodeURIComponent(traceId)}`
+    );
+  }
+  async getAttributeNames(datasourceId) {
+    return this.client.get(
+      `/api/public/datasources/${datasourceId}/traces/attributes`
+    );
+  }
+  async getAttributeValues(datasourceId, attributeName) {
+    return this.client.get(
+      `/api/public/datasources/${datasourceId}/traces/attributes/${encodeURIComponent(attributeName)}/values`
+    );
+  }
+};
+
+// src/resources/datasets.ts
+var DatasetsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/api/public/datasets");
+  }
+  async get(datasetId, params) {
+    const query = {};
+    if (params?.page) query.page = params.page;
+    if (params?.limit) query.limit = params.limit;
+    if (params?.search) query.search = params.search;
+    if (params?.sortBy) query.sortBy = params.sortBy;
+    if (params?.sortOrder) query.sortOrder = params.sortOrder;
+    return this.client.get(
+      `/api/public/datasets/${datasetId}`,
+      Object.keys(query).length > 0 ? query : void 0
+    );
+  }
+  async *listRowsPaginated(datasetId, options) {
+    const pageSize = options?.pageSize ?? 20;
+    let page = 1;
+    let hasNext = true;
+    while (hasNext) {
+      const res = await this.get(datasetId, { page, limit: pageSize });
+      for (const row of res.data) {
+        yield row;
+      }
+      hasNext = res.pagination.hasNextPage;
+      page++;
+    }
+  }
+  async addRow(datasetId, params) {
+    return this.client.post(
+      `/api/public/datasets/${datasetId}/rows`,
+      params
+    );
+  }
+};
+
+// src/resources/entities.ts
+var EntitiesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/api/public/entities");
+  }
+  async get(entityId) {
+    return this.client.get(`/api/public/entities/${entityId}`);
+  }
+};
+
+// src/resources/evaluations.ts
+var EvaluationsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/api/public/evaluations");
+  }
+  async get(evaluationId) {
+    return this.client.get(`/api/public/evaluations/${evaluationId}`);
+  }
+  async getExperimentScores(evaluationId, experimentId) {
+    return this.client.get(
+      `/api/public/evaluations/${evaluationId}/experiments/${experimentId}/scores`
+    );
+  }
+  async create(params) {
+    return this.client.post("/api/public/evaluations", params);
+  }
+  async createResult(evaluationId, params) {
+    return this.client.post(
+      `/api/public/evaluations/${evaluationId}/results`,
+      params
+    );
+  }
+  async listPendingScoreResults(evaluationId, scoreId, options = {}) {
+    const params = {};
+    if (options.experimentId) params.experimentId = options.experimentId;
+    if (options.page != null) params.page = options.page;
+    if (options.limit != null) params.limit = options.limit;
+    return this.client.get(
+      `/api/public/evaluations/${evaluationId}/scores/${scoreId}/pending-results`,
+      params
+    );
+  }
+  async *listPendingScoreResultsIterator(evaluationId, scoreId, options = {}) {
+    const limit = options.limit ?? 100;
+    let page = 1;
+    let hasNext = true;
+    while (hasNext) {
+      const res = await this.listPendingScoreResults(evaluationId, scoreId, {
+        ...options,
+        page,
+        limit
+      });
+      for (const item of res.data) {
+        yield item;
+      }
+      hasNext = res.pagination.hasNextPage;
+      page++;
+    }
+  }
+  async importScoreResults(evaluationId, scoreId, results) {
+    return this.client.post(
+      `/api/public/evaluations/${evaluationId}/scores/${scoreId}/import-results`,
+      { results }
+    );
+  }
+};
+
+// src/resources/experiments.ts
+var ExperimentsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/api/public/experiments");
+  }
+  async get(experimentId) {
+    return this.client.get(`/api/public/experiments/${experimentId}`);
+  }
+  async listResults(experimentId, params) {
+    const query = {};
+    if (params?.page) query.page = params.page;
+    if (params?.limit) query.limit = params.limit;
+    if (params?.search) query.search = params.search;
+    if (params?.sortBy) query.sortBy = params.sortBy;
+    if (params?.sortOrder) query.sortOrder = params.sortOrder;
+    return this.client.get(
+      `/api/public/experiments/${experimentId}/results`,
+      Object.keys(query).length > 0 ? query : void 0
+    );
+  }
+  async *listResultsPaginated(experimentId, options) {
+    const pageSize = options?.pageSize ?? 20;
+    let page = 1;
+    let hasNext = true;
+    while (hasNext) {
+      const res = await this.listResults(experimentId, { page, limit: pageSize });
+      for (const item of res.data) {
+        yield item;
+      }
+      hasNext = res.pagination.hasNextPage;
+      page++;
+    }
+  }
+  async create(params) {
+    return this.client.post("/api/public/experiments", params);
+  }
+  async createResult(experimentId, params) {
+    return this.client.post(
+      `/api/public/experiments/${experimentId}/results`,
+      params
+    );
+  }
+};
+
+// src/index.ts
+var Arcan = class extends ArcaneClient {
+  prompts;
+  datasources;
+  traces;
+  datasets;
+  entities;
+  evaluations;
+  experiments;
+  constructor(config) {
+    super(config);
+    this.prompts = new PromptsResource(this);
+    this.datasources = new DatasourcesResource(this);
+    this.traces = new TracesResource(this);
+    this.datasets = new DatasetsResource(this);
+    this.entities = new EntitiesResource(this);
+    this.evaluations = new EvaluationsResource(this);
+    this.experiments = new ExperimentsResource(this);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Arcan,
+  ArcanApiError,
+  ArcanNotFoundError,
+  ArcanUnauthorizedError,
+  ArcaneClient
+});

package/dist/index.mjs

@@ -0,0 +1,336 @@
+// src/client.ts
+import axios from "axios";
+import axiosRetry from "axios-retry";
+
+// src/errors.ts
+var ArcanApiError = class _ArcanApiError extends Error {
+  constructor(message, statusCode, requestId, cause) {
+    super(message);
+    this.statusCode = statusCode;
+    this.requestId = requestId;
+    this.cause = cause;
+    this.name = "ArcanApiError";
+    Object.setPrototypeOf(this, _ArcanApiError.prototype);
+  }
+  static fromAxiosError(err) {
+    const status = err.response?.status;
+    const message = err.response?.data?.message ?? err.message ?? err.response?.statusText ?? "Unknown API error";
+    const requestId = err.response?.headers?.["x-request-id"];
+    return new _ArcanApiError(message, status, requestId, err);
+  }
+};
+var ArcanNotFoundError = class extends ArcanApiError {
+  constructor(message, requestId) {
+    super(message, 404, requestId);
+    this.name = "ArcanNotFoundError";
+  }
+};
+var ArcanUnauthorizedError = class extends ArcanApiError {
+  constructor(message, requestId) {
+    super(message, 401, requestId);
+    this.name = "ArcanUnauthorizedError";
+  }
+};
+
+// src/client.ts
+var ArcaneClient = class {
+  http;
+  constructor(config) {
+    const { baseUrl, apiKey, maxRetries = 3, timeout = 3e4 } = config;
+    const base = baseUrl.replace(/\/$/, "");
+    this.http = axios.create({
+      baseURL: base,
+      timeout,
+      auth: {
+        username: "api-key",
+        password: apiKey
+      },
+      headers: {
+        "Content-Type": "application/json"
+      }
+    });
+    axiosRetry(this.http, {
+      retries: maxRetries,
+      retryCondition: (err) => {
+        const status = err.response?.status;
+        if (status && status >= 500 && status < 600) return true;
+        if (err.code === "ECONNRESET" || err.code === "ETIMEDOUT") return true;
+        return false;
+      },
+      retryDelay: axiosRetry.exponentialDelay
+    });
+  }
+  getHttp() {
+    return this.http;
+  }
+  async get(path, params) {
+    const res = await this.http.get(path, { params });
+    return res.data;
+  }
+  async post(path, body) {
+    const res = await this.http.post(path, body);
+    return res.data;
+  }
+  handleError(err) {
+    if (axios.isAxiosError(err)) {
+      throw ArcanApiError.fromAxiosError(err);
+    }
+    throw err;
+  }
+};
+
+// src/resources/prompts.ts
+var PromptsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    const res = await this.client.get("/api/public/prompts");
+    return res.data;
+  }
+  async get(promptIdentifier) {
+    const res = await this.client.get(
+      `/api/public/prompts/${encodeURIComponent(promptIdentifier)}`
+    );
+    return res.data;
+  }
+  async listVersions(promptIdentifier) {
+    const res = await this.client.get(
+      `/api/public/prompts/${encodeURIComponent(promptIdentifier)}/versions`
+    );
+    return res.data;
+  }
+  async getLatestVersion(promptIdentifier) {
+    const res = await this.client.get(
+      `/api/public/prompts/${encodeURIComponent(promptIdentifier)}/latest`
+    );
+    return res.data;
+  }
+};
+
+// src/resources/datasources.ts
+var DatasourcesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/api/public/datasources");
+  }
+};
+
+// src/resources/traces.ts
+var TracesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async search(datasourceId, params) {
+    return this.client.post(
+      `/api/public/datasources/${datasourceId}/traces/search`,
+      params ?? {}
+    );
+  }
+  async get(datasourceId, traceId) {
+    return this.client.get(
+      `/api/public/datasources/${datasourceId}/traces/${encodeURIComponent(traceId)}`
+    );
+  }
+  async getAttributeNames(datasourceId) {
+    return this.client.get(
+      `/api/public/datasources/${datasourceId}/traces/attributes`
+    );
+  }
+  async getAttributeValues(datasourceId, attributeName) {
+    return this.client.get(
+      `/api/public/datasources/${datasourceId}/traces/attributes/${encodeURIComponent(attributeName)}/values`
+    );
+  }
+};
+
+// src/resources/datasets.ts
+var DatasetsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/api/public/datasets");
+  }
+  async get(datasetId, params) {
+    const query = {};
+    if (params?.page) query.page = params.page;
+    if (params?.limit) query.limit = params.limit;
+    if (params?.search) query.search = params.search;
+    if (params?.sortBy) query.sortBy = params.sortBy;
+    if (params?.sortOrder) query.sortOrder = params.sortOrder;
+    return this.client.get(
+      `/api/public/datasets/${datasetId}`,
+      Object.keys(query).length > 0 ? query : void 0
+    );
+  }
+  async *listRowsPaginated(datasetId, options) {
+    const pageSize = options?.pageSize ?? 20;
+    let page = 1;
+    let hasNext = true;
+    while (hasNext) {
+      const res = await this.get(datasetId, { page, limit: pageSize });
+      for (const row of res.data) {
+        yield row;
+      }
+      hasNext = res.pagination.hasNextPage;
+      page++;
+    }
+  }
+  async addRow(datasetId, params) {
+    return this.client.post(
+      `/api/public/datasets/${datasetId}/rows`,
+      params
+    );
+  }
+};
+
+// src/resources/entities.ts
+var EntitiesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/api/public/entities");
+  }
+  async get(entityId) {
+    return this.client.get(`/api/public/entities/${entityId}`);
+  }
+};
+
+// src/resources/evaluations.ts
+var EvaluationsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/api/public/evaluations");
+  }
+  async get(evaluationId) {
+    return this.client.get(`/api/public/evaluations/${evaluationId}`);
+  }
+  async getExperimentScores(evaluationId, experimentId) {
+    return this.client.get(
+      `/api/public/evaluations/${evaluationId}/experiments/${experimentId}/scores`
+    );
+  }
+  async create(params) {
+    return this.client.post("/api/public/evaluations", params);
+  }
+  async createResult(evaluationId, params) {
+    return this.client.post(
+      `/api/public/evaluations/${evaluationId}/results`,
+      params
+    );
+  }
+  async listPendingScoreResults(evaluationId, scoreId, options = {}) {
+    const params = {};
+    if (options.experimentId) params.experimentId = options.experimentId;
+    if (options.page != null) params.page = options.page;
+    if (options.limit != null) params.limit = options.limit;
+    return this.client.get(
+      `/api/public/evaluations/${evaluationId}/scores/${scoreId}/pending-results`,
+      params
+    );
+  }
+  async *listPendingScoreResultsIterator(evaluationId, scoreId, options = {}) {
+    const limit = options.limit ?? 100;
+    let page = 1;
+    let hasNext = true;
+    while (hasNext) {
+      const res = await this.listPendingScoreResults(evaluationId, scoreId, {
+        ...options,
+        page,
+        limit
+      });
+      for (const item of res.data) {
+        yield item;
+      }
+      hasNext = res.pagination.hasNextPage;
+      page++;
+    }
+  }
+  async importScoreResults(evaluationId, scoreId, results) {
+    return this.client.post(
+      `/api/public/evaluations/${evaluationId}/scores/${scoreId}/import-results`,
+      { results }
+    );
+  }
+};
+
+// src/resources/experiments.ts
+var ExperimentsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.get("/api/public/experiments");
+  }
+  async get(experimentId) {
+    return this.client.get(`/api/public/experiments/${experimentId}`);
+  }
+  async listResults(experimentId, params) {
+    const query = {};
+    if (params?.page) query.page = params.page;
+    if (params?.limit) query.limit = params.limit;
+    if (params?.search) query.search = params.search;
+    if (params?.sortBy) query.sortBy = params.sortBy;
+    if (params?.sortOrder) query.sortOrder = params.sortOrder;
+    return this.client.get(
+      `/api/public/experiments/${experimentId}/results`,
+      Object.keys(query).length > 0 ? query : void 0
+    );
+  }
+  async *listResultsPaginated(experimentId, options) {
+    const pageSize = options?.pageSize ?? 20;
+    let page = 1;
+    let hasNext = true;
+    while (hasNext) {
+      const res = await this.listResults(experimentId, { page, limit: pageSize });
+      for (const item of res.data) {
+        yield item;
+      }
+      hasNext = res.pagination.hasNextPage;
+      page++;
+    }
+  }
+  async create(params) {
+    return this.client.post("/api/public/experiments", params);
+  }
+  async createResult(experimentId, params) {
+    return this.client.post(
+      `/api/public/experiments/${experimentId}/results`,
+      params
+    );
+  }
+};
+
+// src/index.ts
+var Arcan = class extends ArcaneClient {
+  prompts;
+  datasources;
+  traces;
+  datasets;
+  entities;
+  evaluations;
+  experiments;
+  constructor(config) {
+    super(config);
+    this.prompts = new PromptsResource(this);
+    this.datasources = new DatasourcesResource(this);
+    this.traces = new TracesResource(this);
+    this.datasets = new DatasetsResource(this);
+    this.entities = new EntitiesResource(this);
+    this.evaluations = new EvaluationsResource(this);
+    this.experiments = new ExperimentsResource(this);
+  }
+};
+export {
+  Arcan,
+  ArcanApiError,
+  ArcanNotFoundError,
+  ArcanUnauthorizedError,
+  ArcaneClient
+};