@artemis-studio/client 2026.10.4

package/README.md

@@ -0,0 +1,21 @@
+# @artemis-studio/client
+
+A typed client for the [Artemis Studio](https://github.com/sudoitir/artemis-studio) API. Its types are
+generated from the OpenAPI document of the same release, so version `2026.9.3` of the client describes
+Studio `2026.09.3`.
+
+```ts
+import { createStudioClient, ProblemError } from '@artemis-studio/client';
+
+const studio = createStudioClient({ baseUrl: 'https://studio.example.com', token: process.env.STUDIO_TOKEN! });
+
+try {
+  const { data } = await studio.GET('/api/v1/clusters');
+} catch (error) {
+  // Every non-2xx answer is an RFC 9457 problem; `type` is a stable URI.
+  if (error instanceof ProblemError) console.error(error.status, error.type, error.message);
+}
+```
+
+Requests are made with [openapi-fetch](https://openapi-ts.dev/openapi-fetch/), so its options and
+middleware apply.

package/index.d.ts

@@ -0,0 +1,22 @@
+import { type Client } from 'openapi-fetch';
+import type { paths } from './schema.js';
+export type { components, operations, paths } from './schema.js';
+/** An RFC 9457 `application/problem+json` answer. `type` is one of Studio's stable problem URIs. */
+export declare class ProblemError extends Error {
+    readonly status: number;
+    readonly type: string;
+    readonly title: string;
+    /** The whole body: a problem may carry more members (field errors, a limit) than these. */
+    readonly problem: Record<string, unknown>;
+    constructor(status: number, problem: Record<string, unknown>);
+}
+export interface StudioClientOptions {
+    /** Where Studio is served, for example `https://studio.example.com`. */
+    baseUrl: string;
+    /** An API token; sent as `Authorization: Bearer <token>`. */
+    token: string;
+    /** A replacement for the global `fetch`, for a proxy or a test. */
+    fetch?: (request: Request) => Promise<Response>;
+}
+/** A typed client for the Studio API: `client.GET('/api/v1/clusters')`, and so on. */
+export declare function createStudioClient({ baseUrl, token, fetch }: StudioClientOptions): Client<paths>;

package/index.js

@@ -0,0 +1,35 @@
+import createClient, {} from 'openapi-fetch';
+/** An RFC 9457 `application/problem+json` answer. `type` is one of Studio's stable problem URIs. */
+export class ProblemError extends Error {
+    status;
+    type;
+    title;
+    /** The whole body: a problem may carry more members (field errors, a limit) than these. */
+    problem;
+    constructor(status, problem) {
+        super(problem.detail ?? problem.title ?? `Request failed (${status})`);
+        this.name = 'ProblemError';
+        this.status = status;
+        this.type = problem.type ?? 'about:blank';
+        this.title = problem.title ?? 'Error';
+        this.problem = problem;
+    }
+}
+/** Sends the token, and turns every non-2xx `problem+json` answer into a thrown {@link ProblemError}. */
+const studio = (token) => ({
+    onRequest({ request }) {
+        request.headers.set('Authorization', `Bearer ${token}`);
+        return request;
+    },
+    async onResponse({ response }) {
+        if (response.ok || !response.headers.get('content-type')?.includes('application/problem+json'))
+            return undefined;
+        throw new ProblemError(response.status, (await response.json()));
+    },
+});
+/** A typed client for the Studio API: `client.GET('/api/v1/clusters')`, and so on. */
+export function createStudioClient({ baseUrl, token, fetch }) {
+    const client = createClient({ baseUrl, fetch });
+    client.use(studio(token));
+    return client;
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@artemis-studio/client",
+  "version": "2026.10.4",
+  "description": "A typed TypeScript client for the Artemis Studio API, generated from its OpenAPI document.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sudoitir/artemis-studio.git",
+    "directory": "web/packages/client"
+  },
+  "homepage": "https://sudoitir.github.io/artemis-studio/",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "schema.d.ts",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "openapi-fetch": "0.17.0"
+  }
+}