@coval/sdk 0.1.0

package/README.md

@@ -0,0 +1,176 @@
+# @coval/sdk
+
+Typed TypeScript client for the [Coval](https://coval.dev) evaluation platform API.
+
+The bulk of this SDK is **generated** from Coval's public OpenAPI specs (the
+same ones that power [docs.coval.dev/api-reference](https://docs.coval.dev/api-reference)).
+A small hand-written layer adds auth, retries with backoff, pagination
+iteration, and typed errors so the generated client is ergonomic for
+production use.
+
+## Install
+
+```bash
+npm install @coval/sdk
+```
+
+Requires Node 18+.
+
+## Quick start
+
+```ts
+import { CovalClient } from '@coval/sdk';
+
+const coval = new CovalClient({ apiKey: process.env.COVAL_API_KEY! });
+
+// List agents
+const { agents } = await coval.agents.listAgents({ pageSize: 25 });
+
+// Submit a production conversation for evaluation
+await coval.conversations.submitConversation({
+  covalConversationsAPISubmitConversationRequest: {
+    agent_id: 'my-agent-id',
+    external_conversation_id: 'call-2026-05-11-abc',
+    occurred_at: new Date(),
+    transcript: [
+      { role: 'agent', content: 'Hi, thanks for calling.' },
+      { role: 'user', content: "I'd like to update my account." },
+    ],
+  },
+});
+```
+
+## What the wrapper adds
+
+### Auth — `x-api-key` (lowercase)
+
+Coval's gateway is case-sensitive about the API-key header. Uppercase
+`X-API-Key` returns `Missing API Key`. The `CovalClient` always sends
+lowercase `x-api-key`, so you don't have to think about it.
+
+### Retries with exponential backoff
+
+The client retries automatically on `408`, `429`, and `5xx` responses, plus
+network errors. Defaults: 3 attempts, 200ms base delay with jitter, 5s cap.
+`Retry-After` headers (both seconds and HTTP-date) are respected.
+
+```ts
+const coval = new CovalClient({
+  apiKey: process.env.COVAL_API_KEY!,
+  retry: { maxAttempts: 5, baseDelayMs: 500, maxDelayMs: 10_000 },
+});
+
+// Disable retries entirely:
+const coval2 = new CovalClient({ apiKey, retry: false });
+```
+
+### Typed errors
+
+Every non-2xx HTTP response becomes a `CovalApiError` after retries are
+exhausted. Network failures become `CovalNetworkError`. Both extend `Error`,
+so plain `try/catch` works.
+
+```ts
+import { CovalApiError } from '@coval/sdk';
+
+try {
+  await coval.agents.getAgent({ agentId: 'unknown' });
+} catch (err) {
+  if (err instanceof CovalApiError) {
+    console.error(err.status, err.code, err.message, err.requestId);
+  }
+}
+```
+
+### Pagination iterator
+
+List endpoints return a single page plus a `next_page_token`. The `paginate`
+helper turns that into an async iterator so you don't have to manage tokens.
+
+```ts
+import { paginate, collectAll } from '@coval/sdk';
+
+for await (const agent of paginate({
+  fetchPage: (pageToken) => coval.agents.listAgents({ pageToken, pageSize: 50 }),
+  items: (page) => page.agents,
+  nextToken: (page) => page.next_page_token,
+})) {
+  console.log(agent.id, agent.display_name);
+}
+
+// Or collect everything into an array:
+const all = await collectAll({
+  fetchPage: (pageToken) => coval.simulations.listSimulations({ pageToken }),
+  items: (p) => p.simulations,
+  nextToken: (p) => p.next_page_token,
+});
+```
+
+## Customization
+
+### Override base URL (staging, self-host)
+
+```ts
+const coval = new CovalClient({
+  apiKey,
+  baseUrl: 'https://staging.api.coval.dev',
+});
+```
+
+### Plug in custom middleware
+
+```ts
+const coval = new CovalClient({
+  apiKey,
+  middleware: [
+    {
+      async pre({ url, init }) {
+        console.log('→', init.method, url);
+        return undefined;
+      },
+    },
+  ],
+});
+```
+
+### Override fetch (e.g., undici with keep-alive)
+
+```ts
+import { fetch as undiciFetch } from 'undici';
+
+const coval = new CovalClient({ apiKey, fetch: undiciFetch });
+```
+
+## Examples
+
+Runnable in this repo. Set `COVAL_API_KEY` (and `COVAL_AGENT_ID` for the
+submit example) and run:
+
+```bash
+npm run example:list-agents
+npm run example:submit-conversation
+```
+
+## Versioning
+
+The generated surface tracks the underlying Coval API. Spec changes that
+break the generated client increment the **minor** version. Hand-written
+wrapper changes that break the public TypeScript API also increment the
+**minor** version. Bug fixes increment the **patch** version.
+
+## Regenerating
+
+If you want to regenerate the client locally:
+
+```bash
+# From the repo root, with the docs repo checked out as a sibling:
+node scripts/bundle-spec.mjs
+bash scripts/generate-sdks.sh
+```
+
+A weekly CI job (`.github/workflows/regenerate-sdks.yml`) does this
+automatically and opens a PR if the generated output has drifted.
+
+## License
+
+MIT.

package/dist/CovalClient.d.ts

@@ -0,0 +1,40 @@
+import { type RetryOptions } from './retry.js';
+import { AgentsApi, APIKeysApi, AudioApi, Configuration, ConversationsApi, DashboardsApi, type FetchAPI, type Middleware, MetricOutputsApi, MetricsApi, MonitorEventsApi, MonitorsApi, MutationsApi, PersonasApi, ReviewAnnotationsApi, ReviewProjectsApi, RunsApi, RunTemplatesApi, ScheduledRunsApi, SimulationsApi, TemplatesApi, TestCasesApi, TestSetsApi, WidgetsApi } from './generated/index.js';
+export interface CovalClientOptions {
+    /** Coval API key. Required. Sent as `x-api-key` (lowercase). */
+    apiKey: string;
+    /** Base URL. Defaults to https://api.coval.dev. */
+    baseUrl?: string;
+    /** Retry configuration. Defaults to 3 attempts, 200ms base, 5s cap. */
+    retry?: RetryOptions | false;
+    /** Additional middlewares to attach (run after auth). */
+    middleware?: Middleware[];
+    /** Override the global fetch (e.g., for tests, undici-with-keepalive, etc). */
+    fetch?: FetchAPI;
+}
+export declare class CovalClient {
+    readonly agents: AgentsApi;
+    readonly apiKeys: APIKeysApi;
+    readonly audio: AudioApi;
+    readonly conversations: ConversationsApi;
+    readonly dashboards: DashboardsApi;
+    readonly metrics: MetricsApi;
+    readonly metricOutputs: MetricOutputsApi;
+    readonly monitors: MonitorsApi;
+    readonly monitorEvents: MonitorEventsApi;
+    readonly mutations: MutationsApi;
+    readonly personas: PersonasApi;
+    readonly reviewAnnotations: ReviewAnnotationsApi;
+    readonly reviewProjects: ReviewProjectsApi;
+    readonly runs: RunsApi;
+    readonly runTemplates: RunTemplatesApi;
+    readonly scheduledRuns: ScheduledRunsApi;
+    readonly simulations: SimulationsApi;
+    readonly templates: TemplatesApi;
+    readonly testCases: TestCasesApi;
+    readonly testSets: TestSetsApi;
+    readonly widgets: WidgetsApi;
+    readonly configuration: Configuration;
+    constructor(options: CovalClientOptions);
+}
+//# sourceMappingURL=CovalClient.d.ts.map

package/dist/CovalClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CovalClient.d.ts","sourceRoot":"","sources":["../src/CovalClient.ts"],"names":[],"mappings":"AAcA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,OAAO,EACP,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,UAAU,EACX,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,KAAK,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;IAC7B,yDAAyD;IACzD,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IAC1B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAID,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;IACjD,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;gBAE1B,OAAO,EAAE,kBAAkB;CA6CxC"}

package/dist/CovalClient.js

@@ -0,0 +1,124 @@
+// CovalClient — the entry point for the Coval TypeScript SDK.
+//
+// Wraps the generated openapi-fetch client with:
+//   - x-api-key auth (lowercase header — gateway is case-sensitive)
+//   - exponential-backoff retry on 408/429/5xx and on network errors
+//   - typed CovalApiError raised for non-2xx after retries are exhausted
+//   - a default base URL (https://api.coval.dev) — override for staging
+//
+// Each API surface from the generated client (AgentsApi, ConversationsApi,
+// SimulationsApi, …) is constructed eagerly and exposed as a property so
+// usage reads as `client.agents.listAgents({})`.
+import { apiKeyAuthMiddleware } from './auth.js';
+import { CovalApiError, parseErrorResponse } from './errors.js';
+import { createRetryingFetch } from './retry.js';
+import { AgentsApi, APIKeysApi, AudioApi, Configuration, ConversationsApi, DashboardsApi, MetricOutputsApi, MetricsApi, MonitorEventsApi, MonitorsApi, MutationsApi, PersonasApi, ReviewAnnotationsApi, ReviewProjectsApi, RunsApi, RunTemplatesApi, ScheduledRunsApi, SimulationsApi, TemplatesApi, TestCasesApi, TestSetsApi, WidgetsApi, } from './generated/index.js';
+const DEFAULT_BASE_URL = 'https://api.coval.dev';
+export class CovalClient {
+    agents;
+    apiKeys;
+    audio;
+    conversations;
+    dashboards;
+    metrics;
+    metricOutputs;
+    monitors;
+    monitorEvents;
+    mutations;
+    personas;
+    reviewAnnotations;
+    reviewProjects;
+    runs;
+    runTemplates;
+    scheduledRuns;
+    simulations;
+    templates;
+    testCases;
+    testSets;
+    widgets;
+    configuration;
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new Error('CovalClient: apiKey is required');
+        }
+        const innerFetch = options.fetch ?? globalThis.fetch;
+        const fetchApi = options.retry === false
+            ? innerFetch
+            : createRetryingFetch(options.retry ?? {}, { fetch: innerFetch });
+        const middleware = [
+            apiKeyAuthMiddleware({ apiKey: options.apiKey }),
+            errorMiddleware(),
+            ...(options.middleware ?? []),
+        ];
+        this.configuration = new Configuration({
+            basePath: options.baseUrl ?? DEFAULT_BASE_URL,
+            fetchApi,
+            middleware,
+        });
+        this.agents = new AgentsApi(this.configuration);
+        this.apiKeys = new APIKeysApi(this.configuration);
+        this.audio = new AudioApi(this.configuration);
+        this.conversations = new ConversationsApi(this.configuration);
+        this.dashboards = new DashboardsApi(this.configuration);
+        this.metrics = new MetricsApi(this.configuration);
+        this.metricOutputs = new MetricOutputsApi(this.configuration);
+        this.monitors = new MonitorsApi(this.configuration);
+        this.monitorEvents = new MonitorEventsApi(this.configuration);
+        this.mutations = new MutationsApi(this.configuration);
+        this.personas = new PersonasApi(this.configuration);
+        this.reviewAnnotations = new ReviewAnnotationsApi(this.configuration);
+        this.reviewProjects = new ReviewProjectsApi(this.configuration);
+        this.runs = new RunsApi(this.configuration);
+        this.runTemplates = new RunTemplatesApi(this.configuration);
+        this.scheduledRuns = new ScheduledRunsApi(this.configuration);
+        this.simulations = new SimulationsApi(this.configuration);
+        this.templates = new TemplatesApi(this.configuration);
+        this.testCases = new TestCasesApi(this.configuration);
+        this.testSets = new TestSetsApi(this.configuration);
+        this.widgets = new WidgetsApi(this.configuration);
+    }
+}
+function errorMiddleware() {
+    return {
+        async post(context) {
+            const { response } = context;
+            if (response.ok)
+                return;
+            const cloned = response.clone();
+            const body = await parseErrorResponse(cloned);
+            const requestId = response.headers.get('x-request-id') ??
+                response.headers.get('x-amzn-requestid') ??
+                getErrorField(body, 'request_id') ??
+                undefined;
+            const errorMessage = getErrorField(body, 'message');
+            const message = errorMessage ||
+                response.statusText ||
+                `Coval API error ${response.status}`;
+            throw new CovalApiError({
+                status: response.status,
+                message: String(message),
+                url: context.url,
+                method: (context.init.method ?? 'GET').toUpperCase(),
+                body,
+                code: getErrorField(body, 'code'),
+                requestId,
+            });
+        },
+    };
+}
+function getErrorField(body, field) {
+    if (!isRecord(body))
+        return undefined;
+    const direct = body[field];
+    if (typeof direct === 'string')
+        return direct;
+    const nested = body.error;
+    if (isRecord(nested) && typeof nested[field] === 'string') {
+        return nested[field];
+    }
+    return undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+//# sourceMappingURL=CovalClient.js.map

package/dist/CovalClient.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,6 @@
+import type { Middleware } from './generated/runtime.js';
+export interface ApiKeyAuthOptions {
+    apiKey: string;
+}
+export declare function apiKeyAuthMiddleware(options: ApiKeyAuthOptions): Middleware;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,wBAAwB,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAe3E"}

package/dist/auth.js

@@ -0,0 +1,23 @@
+// Auth middleware for the generated openapi-fetch client.
+//
+// Coval's API requires the header `x-api-key`. The header name is
+// case-sensitive on the gateway — uppercase `X-API-Key` is rejected with
+// "Missing API Key". We always lower-case it here so callers don't have to
+// know about that quirk.
+export function apiKeyAuthMiddleware(options) {
+    const { apiKey } = options;
+    if (!apiKey) {
+        throw new Error('apiKey is required');
+    }
+    return {
+        async pre(context) {
+            const headers = new Headers(context.init.headers);
+            headers.set('x-api-key', apiKey);
+            return {
+                url: context.url,
+                init: { ...context.init, headers },
+            };
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,EAAE;AACF,kEAAkE;AAClE,yEAAyE;AACzE,2EAA2E;AAC3E,yBAAyB;AAQzB,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,OAAuB;YAC/B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACjC,OAAO;gBACL,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE;aACnC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,37 @@
+export interface CovalApiErrorBody {
+    message?: string;
+    code?: string;
+    request_id?: string;
+    details?: unknown;
+}
+export declare class CovalApiError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    readonly requestId: string | undefined;
+    readonly body: CovalApiErrorBody | string | undefined;
+    readonly url: string;
+    readonly method: string;
+    constructor(args: {
+        status: number;
+        message: string;
+        url: string;
+        method: string;
+        body?: CovalApiErrorBody | string;
+        code?: string;
+        requestId?: string;
+    });
+}
+export declare class CovalNetworkError extends Error {
+    readonly url: string;
+    readonly method: string;
+    readonly attempts: number;
+    constructor(args: {
+        message: string;
+        url: string;
+        method: string;
+        attempts: number;
+        cause?: unknown;
+    });
+}
+export declare function parseErrorResponse(response: Response): Promise<CovalApiErrorBody | string | undefined>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CAUF;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAOtG;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAAC,CAW5G"}

package/dist/errors.js

@@ -0,0 +1,50 @@
+// Typed error classes for the Coval SDK.
+//
+// All non-2xx HTTP responses are turned into a CovalApiError so callers can
+// distinguish API-level failures from network/transport failures (which raise
+// CovalNetworkError instead). Both extend Error and preserve a `cause`
+// chain for ergonomic try/catch.
+export class CovalApiError extends Error {
+    status;
+    code;
+    requestId;
+    body;
+    url;
+    method;
+    constructor(args) {
+        super(args.message);
+        this.name = 'CovalApiError';
+        this.status = args.status;
+        this.url = args.url;
+        this.method = args.method;
+        this.body = args.body;
+        this.code = args.code;
+        this.requestId = args.requestId;
+    }
+}
+export class CovalNetworkError extends Error {
+    url;
+    method;
+    attempts;
+    constructor(args) {
+        super(args.message, { cause: args.cause });
+        this.name = 'CovalNetworkError';
+        this.url = args.url;
+        this.method = args.method;
+        this.attempts = args.attempts;
+    }
+}
+export async function parseErrorResponse(response) {
+    const contentType = response.headers.get('content-type') ?? '';
+    try {
+        if (contentType.includes('application/json')) {
+            return (await response.json());
+        }
+        const text = await response.text();
+        return text.length > 0 ? text : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,uEAAuE;AACvE,iCAAiC;AASjC,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,MAAM,CAAS;IACf,IAAI,CAAqB;IACzB,SAAS,CAAqB;IAC9B,IAAI,CAAyC;IAC7C,GAAG,CAAS;IACZ,MAAM,CAAS;IAExB,YAAY,IAQX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,GAAG,CAAS;IACZ,MAAM,CAAS;IACf,QAAQ,CAAS;IAE1B,YAAY,IAAyF;QACnG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAkB;IACzD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAC/D,IAAI,CAAC;QACH,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC7C,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;QACtD,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}