@simo-online/sdk 3.0.0

package/README.md

@@ -0,0 +1,143 @@
+# @simo-online/sdk — SIMOSphere AI TypeScript SDK
+
+Official TypeScript / JavaScript client for the [SIMOSphere AI gateway](https://api.simosphereai.com).
+
+- OpenAI-compatible `chat.completions` (sync + streaming)
+- Tenant admin: API keys, usage, credits, files
+- Zero runtime dependencies — uses native `fetch` (Node 18.17+ / modern browsers)
+- Typed end-to-end against the published OpenAPI 3.1 spec
+
+## Install
+
+```bash
+npm install @simo-online/sdk
+# or
+pnpm add @simo-online/sdk
+# or
+yarn add @simo-online/sdk
+```
+
+## Quickstart
+
+```ts
+import { SimoClient } from '@simo-online/sdk';
+
+const simo = new SimoClient({ apiKey: process.env.SIMO_API_KEY! });
+
+// 1. Chat completion (OpenAI-compatible)
+const chat = await simo.chat.completions.create({
+  model: 'apertus-8b-eu',
+  messages: [
+    { role: 'system', content: 'Du bist ein hilfreicher Assistent.' },
+    { role: 'user', content: 'Was ist Datensouveraenitaet?' },
+  ],
+});
+console.log(chat.choices[0].message.content);
+
+// 2. Streaming
+for await (const chunk of simo.chat.completions.createStream({
+  model: 'apertus-8b-eu',
+  messages: [{ role: 'user', content: 'Schreibe ein Haiku ueber Souveraenitaet.' }],
+})) {
+  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
+}
+
+// 3. List models
+const models = await simo.models.list();
+console.log(models.data.map((m) => m.id));
+
+// 4. Manage API keys
+const key = await simo.keys.create({ name: 'ci-pipeline', scopes: ['chat:write'] });
+console.log('New key (shown once):', key.token);
+
+// 5. Check credit balance
+const credit = await simo.credits.balance();
+console.log(`Balance: ${credit.balance_eur} EUR`);
+
+// 6. Usage summary
+const usage = await simo.usage.summary({ from: '2026-05-01', to: '2026-05-31' });
+console.log(`${usage.total_requests} requests · ${usage.total_input_tokens + usage.total_output_tokens} tokens`);
+```
+
+## Configuration
+
+| Option           | Default                              | Notes                                          |
+| ---------------- | ------------------------------------ | ---------------------------------------------- |
+| `apiKey`         | (required)                           | Issued via dashboard or `simo keys create`     |
+| `baseUrl`        | `https://api.simosphereai.com`       | Use `sandbox.api.simosphereai.com` for testing |
+| `timeoutMs`      | `60000`                              | Per-request timeout                            |
+| `fetch`          | `globalThis.fetch`                   | Pass `undici` or `node-fetch` if needed        |
+| `defaultHeaders` | `{}`                                 | Merged into every request                      |
+
+## Error handling
+
+```ts
+import { SimoClient, SimoApiError } from '@simo-online/sdk';
+
+try {
+  await simo.chat.completions.create({ model: 'x', messages: [] });
+} catch (err) {
+  if (err instanceof SimoApiError) {
+    console.error(err.status, err.body?.error?.type, err.body?.error?.message);
+    console.error('Request ID for support:', err.requestId);
+  } else {
+    throw err;
+  }
+}
+```
+
+## Idempotency
+
+Pass `idempotencyKey` on any mutating call to dedupe retries server-side:
+
+```ts
+await simo.keys.create(
+  { name: 'webhook-2026-05-25' },
+  { idempotencyKey: 'create-webhook-key-once' },
+);
+```
+
+## Cancellation
+
+```ts
+const controller = new AbortController();
+setTimeout(() => controller.abort(), 5000);
+
+await simo.chat.completions.create(
+  { model: 'apertus-8b-eu', messages: [{ role: 'user', content: '...' }] },
+  { signal: controller.signal },
+);
+```
+
+## OpenAI SDK migration
+
+```diff
+- import OpenAI from 'openai';
+- const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
++ import { SimoClient } from '@simo-online/sdk';
++ const client = new SimoClient({ apiKey: process.env.SIMO_API_KEY });
+
+  const chat = await client.chat.completions.create({
+-   model: 'gpt-4o-mini',
++   model: 'apertus-8b-eu',
+    messages: [{ role: 'user', content: 'Hello' }],
+  });
+```
+
+## Versioning & stability
+
+- Follows [Semantic Versioning](https://semver.org/).
+- Tracks the gateway's published `2026-05-18` API contract; method names mirror the OpenAI SDK so familiar code ports cleanly.
+- `SIMOSphere` (capital) is a back-compat alias for the 0.0.x preview SDK and will be removed in 0.3.0.
+
+## Links
+
+- Gateway docs: <https://onboarding.simosphereai.com/llms-full.txt>
+- OpenAPI spec: <https://api.simosphereai.com/openapi.json>
+- Issue tracker: <https://github.com/SIMOSphereOS/simosphere-ai-api-platform/issues>
+
+## License
+
+Business Source License 1.1 — see `LICENSE`.
+
+Engineered at SIMO GmbH · Aschaffenburg, Germany.

package/dist/client.d.ts

@@ -0,0 +1,120 @@
+import type { ApiErrorBody, ApiKey, ChatCompletion, ChatCompletionChunk, ChatCompletionRequest, CreateApiKeyRequest, CreditBalance, ModelList, RequestOptions, UploadedFile, UsageSummary } from './types.js';
+export interface SimoClientOptions {
+    /** Tenant API key issued via the dashboard or `simo keys create`. Required. */
+    apiKey: string;
+    /** Override the gateway base URL. Defaults to https://api.simosphereai.com. */
+    baseUrl?: string;
+    /** Default request timeout in milliseconds. Defaults to 60_000. */
+    timeoutMs?: number;
+    /** Custom fetch implementation (mainly for testing). */
+    fetch?: typeof fetch;
+    /** Additional headers attached to every request. */
+    defaultHeaders?: Record<string, string>;
+}
+/**
+ * Thrown for any non-2xx response. Carries the parsed OpenAI-style
+ * error envelope when the server returned one.
+ */
+export declare class SimoApiError extends Error {
+    readonly status: number;
+    readonly body: ApiErrorBody | null;
+    readonly requestId: string | null;
+    constructor(message: string, status: number, body: ApiErrorBody | null, requestId: string | null);
+}
+export declare class SimoClient {
+    readonly apiKey: string;
+    readonly baseUrl: string;
+    readonly timeoutMs: number;
+    private readonly fetchImpl;
+    private readonly defaultHeaders;
+    readonly chat: ChatNamespace;
+    readonly models: ModelsNamespace;
+    readonly files: FilesNamespace;
+    readonly keys: KeysNamespace;
+    readonly credits: CreditsNamespace;
+    readonly usage: UsageNamespace;
+    constructor(opts: SimoClientOptions);
+    /**
+     * Low-level HTTP transport. All namespaces go through here so auth,
+     * error parsing, and timeout handling stay in one place.
+     *
+     * @internal
+     */
+    request<T>(method: 'GET' | 'POST' | 'PATCH' | 'DELETE', path: string, init?: {
+        body?: unknown;
+        query?: Record<string, string | number | boolean | undefined>;
+        options?: RequestOptions;
+        contentType?: string;
+        raw?: boolean;
+    }): Promise<T>;
+    /**
+     * Server-Sent-Events streaming transport for `stream: true` chat
+     * completions. Yields parsed chunks until the gateway sends
+     * `data: [DONE]`.
+     *
+     * @internal
+     */
+    stream<T>(path: string, body: unknown, options?: RequestOptions): AsyncGenerator<T>;
+}
+declare class ChatNamespace {
+    readonly completions: ChatCompletionsNamespace;
+    constructor(client: SimoClient);
+}
+declare class ChatCompletionsNamespace {
+    private readonly client;
+    constructor(client: SimoClient);
+    /**
+     * Create a chat completion. When `stream: true`, use `createStream()`
+     * instead — this overload throws to keep the typed return safe.
+     */
+    create(body: ChatCompletionRequest & {
+        stream?: false;
+    }, options?: RequestOptions): Promise<ChatCompletion>;
+    /** Streaming variant — returns an async iterator of SSE chunks. */
+    createStream(body: ChatCompletionRequest, options?: RequestOptions): AsyncGenerator<ChatCompletionChunk>;
+}
+declare class ModelsNamespace {
+    private readonly client;
+    constructor(client: SimoClient);
+    list(options?: RequestOptions): Promise<ModelList>;
+    retrieve(id: string, options?: RequestOptions): Promise<ModelList['data'][number]>;
+}
+declare class FilesNamespace {
+    private readonly client;
+    constructor(client: SimoClient);
+    /**
+     * Upload a file. Accepts a Web `File`, a `Blob` + filename, or a
+     * Node `Buffer` / `Uint8Array` + filename.
+     */
+    upload(file: Blob | {
+        data: Uint8Array;
+        filename: string;
+        contentType?: string;
+    }, purpose?: UploadedFile['purpose'], options?: RequestOptions): Promise<UploadedFile>;
+    get(id: string, options?: RequestOptions): Promise<UploadedFile>;
+    delete(id: string, options?: RequestOptions): Promise<void>;
+}
+declare class KeysNamespace {
+    private readonly client;
+    constructor(client: SimoClient);
+    list(options?: RequestOptions): Promise<{
+        data: ApiKey[];
+    }>;
+    create(body: CreateApiKeyRequest, options?: RequestOptions): Promise<ApiKey>;
+    revoke(id: string, options?: RequestOptions): Promise<void>;
+}
+declare class CreditsNamespace {
+    private readonly client;
+    constructor(client: SimoClient);
+    balance(options?: RequestOptions): Promise<CreditBalance>;
+}
+declare class UsageNamespace {
+    private readonly client;
+    constructor(client: SimoClient);
+    summary(range?: {
+        from?: string;
+        to?: string;
+    }, options?: RequestOptions): Promise<UsageSummary>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,333 @@
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2026 SIMO GmbH, Aschaffenburg, Germany.
+//
+// SimoClient — namespaced HTTP client for the SIMOSphere AI gateway.
+//
+// Design rules:
+//   1. Single transport (`request<T>`) handles auth, headers, timeouts,
+//      idempotency keys, and structured error parsing. All resource
+//      namespaces (chat, models, files, keys, credits, usage) delegate
+//      to it so behaviour stays uniform.
+//   2. Public namespaces follow the OpenAI SDK shape where possible
+//      (`client.chat.completions.create(...)`, `client.models.list()`)
+//      so existing OpenAI-SDK code ports with a one-line swap.
+//   3. No external runtime deps. `fetch` is native on Node 18.17+ and
+//      every modern browser; we only assume the standard `Request`,
+//      `Response`, `AbortController`, `TextDecoder` surface.
+const DEFAULT_BASE_URL = 'https://api.simosphereai.com';
+const DEFAULT_TIMEOUT_MS = 60_000;
+const SDK_USER_AGENT = 'simo-online-sdk-js/0.1.0';
+/**
+ * Thrown for any non-2xx response. Carries the parsed OpenAI-style
+ * error envelope when the server returned one.
+ */
+export class SimoApiError extends Error {
+    status;
+    body;
+    requestId;
+    constructor(message, status, body, requestId) {
+        super(message);
+        this.name = 'SimoApiError';
+        this.status = status;
+        this.body = body;
+        this.requestId = requestId;
+    }
+}
+export class SimoClient {
+    apiKey;
+    baseUrl;
+    timeoutMs;
+    fetchImpl;
+    defaultHeaders;
+    chat;
+    models;
+    files;
+    keys;
+    credits;
+    usage;
+    constructor(opts) {
+        if (!opts.apiKey || typeof opts.apiKey !== 'string') {
+            throw new TypeError('SimoClient: `apiKey` is required (got: ' + typeof opts.apiKey + ')');
+        }
+        this.apiKey = opts.apiKey;
+        this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.fetchImpl = opts.fetch ?? globalThis.fetch;
+        this.defaultHeaders = opts.defaultHeaders ?? {};
+        if (typeof this.fetchImpl !== 'function') {
+            throw new TypeError('SimoClient: global `fetch` is not available. Use Node 18.17+ or pass `fetch` explicitly.');
+        }
+        this.chat = new ChatNamespace(this);
+        this.models = new ModelsNamespace(this);
+        this.files = new FilesNamespace(this);
+        this.keys = new KeysNamespace(this);
+        this.credits = new CreditsNamespace(this);
+        this.usage = new UsageNamespace(this);
+    }
+    /**
+     * Low-level HTTP transport. All namespaces go through here so auth,
+     * error parsing, and timeout handling stay in one place.
+     *
+     * @internal
+     */
+    async request(method, path, init = {}) {
+        const url = new URL(path.startsWith('/') ? path : `/${path}`, this.baseUrl + '/');
+        if (init.query) {
+            for (const [k, v] of Object.entries(init.query)) {
+                if (v === undefined)
+                    continue;
+                url.searchParams.set(k, String(v));
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            'X-API-Key': this.apiKey,
+            Accept: 'application/json',
+            'User-Agent': SDK_USER_AGENT,
+            ...this.defaultHeaders,
+            ...(init.options?.headers ?? {}),
+        };
+        if (init.body !== undefined && !init.raw) {
+            headers['Content-Type'] = init.contentType ?? 'application/json';
+        }
+        if (init.options?.idempotencyKey) {
+            headers['Idempotency-Key'] = init.options.idempotencyKey;
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), init.options?.timeoutMs ?? this.timeoutMs);
+        if (init.options?.signal) {
+            init.options.signal.addEventListener('abort', () => controller.abort(), { once: true });
+        }
+        let res;
+        try {
+            res = await this.fetchImpl(url.toString(), {
+                method,
+                headers,
+                body: init.body === undefined
+                    ? undefined
+                    : init.raw
+                        ? init.body
+                        : JSON.stringify(init.body),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        const requestId = res.headers.get('x-request-id') ?? res.headers.get('x-correlation-id');
+        if (!res.ok) {
+            let body = null;
+            try {
+                body = (await res.json());
+            }
+            catch {
+                body = null;
+            }
+            throw new SimoApiError(body?.error?.message ?? `Request failed (${res.status} ${res.statusText})`, res.status, body, requestId);
+        }
+        // 204 No Content
+        if (res.status === 204)
+            return undefined;
+        const contentType = res.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json') || contentType.includes('+json')) {
+            return (await res.json());
+        }
+        return (await res.text());
+    }
+    /**
+     * Server-Sent-Events streaming transport for `stream: true` chat
+     * completions. Yields parsed chunks until the gateway sends
+     * `data: [DONE]`.
+     *
+     * @internal
+     */
+    async *stream(path, body, options) {
+        const url = new URL(path.startsWith('/') ? path : `/${path}`, this.baseUrl + '/');
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), options?.timeoutMs ?? this.timeoutMs);
+        if (options?.signal) {
+            options.signal.addEventListener('abort', () => controller.abort(), { once: true });
+        }
+        let res;
+        try {
+            res = await this.fetchImpl(url.toString(), {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    'X-API-Key': this.apiKey,
+                    'Content-Type': 'application/json',
+                    Accept: 'text/event-stream',
+                    'User-Agent': SDK_USER_AGENT,
+                    ...this.defaultHeaders,
+                    ...(options?.headers ?? {}),
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timeout);
+            throw err;
+        }
+        if (!res.ok || !res.body) {
+            clearTimeout(timeout);
+            const parsed = await res.json().catch(() => null);
+            throw new SimoApiError(parsed?.error?.message ?? `Stream failed (${res.status})`, res.status, parsed, res.headers.get('x-request-id'));
+        }
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buf = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buf += decoder.decode(value, { stream: true });
+                const events = buf.split('\n\n');
+                buf = events.pop() ?? '';
+                for (const evt of events) {
+                    for (const line of evt.split('\n')) {
+                        if (!line.startsWith('data:'))
+                            continue;
+                        const payload = line.slice(5).trim();
+                        if (payload === '[DONE]')
+                            return;
+                        if (!payload)
+                            continue;
+                        try {
+                            yield JSON.parse(payload);
+                        }
+                        catch {
+                            // Skip malformed chunk — gateway never emits these but
+                            // proxies (Cloudflare) occasionally inject keep-alives.
+                        }
+                    }
+                }
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+            try {
+                reader.releaseLock();
+            }
+            catch {
+                /* already released */
+            }
+        }
+    }
+}
+// ─── Namespaces ─────────────────────────────────────────────────────
+class ChatNamespace {
+    completions;
+    constructor(client) {
+        this.completions = new ChatCompletionsNamespace(client);
+    }
+}
+class ChatCompletionsNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a chat completion. When `stream: true`, use `createStream()`
+     * instead — this overload throws to keep the typed return safe.
+     */
+    async create(body, options) {
+        if (body.stream) {
+            throw new TypeError('SimoClient.chat.completions.create: pass `stream: true` to createStream() instead.');
+        }
+        return this.client.request('POST', '/v1/chat/completions', {
+            body: { ...body, stream: false },
+            options,
+        });
+    }
+    /** Streaming variant — returns an async iterator of SSE chunks. */
+    createStream(body, options) {
+        return this.client.stream('/v1/chat/completions', { ...body, stream: true }, options);
+    }
+}
+class ModelsNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async list(options) {
+        return this.client.request('GET', '/v1/models', { options });
+    }
+    async retrieve(id, options) {
+        return this.client.request('GET', `/v1/models/${encodeURIComponent(id)}`, { options });
+    }
+}
+class FilesNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Upload a file. Accepts a Web `File`, a `Blob` + filename, or a
+     * Node `Buffer` / `Uint8Array` + filename.
+     */
+    async upload(file, purpose = 'user_data', options) {
+        const form = new FormData();
+        if (file instanceof Blob) {
+            form.append('file', file, file.name ?? 'upload.bin');
+        }
+        else {
+            const blob = new Blob([file.data], {
+                type: file.contentType ?? 'application/octet-stream',
+            });
+            form.append('file', blob, file.filename);
+        }
+        form.append('purpose', purpose);
+        return this.client.request('POST', '/v1/files', {
+            body: form,
+            raw: true,
+            options,
+        });
+    }
+    async get(id, options) {
+        return this.client.request('GET', `/v1/files/${encodeURIComponent(id)}`, {
+            options,
+        });
+    }
+    async delete(id, options) {
+        await this.client.request('DELETE', `/v1/files/${encodeURIComponent(id)}`, { options });
+    }
+}
+class KeysNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async list(options) {
+        return this.client.request('GET', '/admin/keys', { options });
+    }
+    async create(body, options) {
+        return this.client.request('POST', '/admin/keys', { body, options });
+    }
+    async revoke(id, options) {
+        await this.client.request('DELETE', `/admin/keys/${encodeURIComponent(id)}`, { options });
+    }
+}
+class CreditsNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async balance(options) {
+        return this.client.request('GET', '/admin/billing/status', { options });
+    }
+}
+class UsageNamespace {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async summary(range, options) {
+        return this.client.request('GET', '/admin/usage', {
+            query: range,
+            options,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { SimoClient, SimoApiError } from './client.js';
+export type { SimoClientOptions } from './client.js';
+export type { ApiErrorBody, ApiKey, ChatCompletion, ChatCompletionChoice, ChatCompletionChunk, ChatCompletionChunkChoice, ChatCompletionRequest, ChatCompletionUsage, ChatMessage, CreateApiKeyRequest, CreditBalance, ModelInfo, ModelList, RequestOptions, UploadedFile, UsageSummary, } from './types.js';
+import { SimoClient, type SimoClientOptions } from './client.js';
+import type { ChatCompletion, ChatCompletionChunk, ChatCompletionRequest, ChatMessage, ModelInfo } from './types.js';
+/** @deprecated Use {@link SimoClient} directly. */
+export declare class SIMOSphere {
+    private readonly client;
+    constructor(opts: SimoClientOptions);
+    chat(opts: {
+        model?: string;
+        messages: ChatMessage[];
+        max_tokens?: number;
+        temperature?: number;
+        tools?: ChatCompletionRequest['tools'];
+    }): Promise<ChatCompletion>;
+    stream(opts: {
+        model?: string;
+        messages: ChatMessage[];
+        max_tokens?: number;
+        temperature?: number;
+    }): AsyncGenerator<ChatCompletionChunk>;
+    ask(question: string, model?: string): Promise<string>;
+    models(): Promise<ModelInfo[]>;
+}
+export default SimoClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,YAAY,EACV,YAAY,EACZ,MAAM,EACN,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAWpB,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErH,mDAAmD;AACnD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;gBAExB,IAAI,EAAE,iBAAiB;IAI7B,IAAI,CAAC,IAAI,EAAE;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;KACxC,GAAG,OAAO,CAAC,cAAc,CAAC;IAUpB,MAAM,CAAC,IAAI,EAAE;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,cAAc,CAAC,mBAAmB,CAAC;IASjC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQtD,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;CAIrC;AAED,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2026 SIMO GmbH, Aschaffenburg, Germany.
+//
+// Public entry point for @simo-online/sdk.
+//
+// The canonical client is `SimoClient`. `SIMOSphere` is exported as a
+// deprecation alias for the 0.0.x preview SDK that lived in this
+// folder before the rename; new code should import `SimoClient`.
+export { SimoClient, SimoApiError } from './client.js';
+// ─── Back-compat alias ──────────────────────────────────────────────
+//
+// Old 0.0.x preview SDK exposed a `SIMOSphere` class with `chat()`,
+// `stream()`, `ask()`, `models()`. The new shape is `SimoClient` with
+// namespaces (`client.chat.completions.create(...)`,
+// `client.models.list()`). The thin wrapper below keeps the old
+// surface so a single-line import swap (`@simo/ai` → `@simo-online/sdk`)
+// does not break callers. Remove in v0.3.0.
+import { SimoClient } from './client.js';
+/** @deprecated Use {@link SimoClient} directly. */
+export class SIMOSphere {
+    client;
+    constructor(opts) {
+        this.client = new SimoClient(opts);
+    }
+    async chat(opts) {
+        return this.client.chat.completions.create({
+            model: opts.model ?? 'qwen/qwen3-8b',
+            messages: opts.messages,
+            max_tokens: opts.max_tokens,
+            temperature: opts.temperature,
+            tools: opts.tools,
+        });
+    }
+    async *stream(opts) {
+        yield* this.client.chat.completions.createStream({
+            model: opts.model ?? 'qwen/qwen3-8b',
+            messages: opts.messages,
+            max_tokens: opts.max_tokens,
+            temperature: opts.temperature,
+        });
+    }
+    async ask(question, model) {
+        const result = await this.chat({
+            model,
+            messages: [{ role: 'user', content: question }],
+        });
+        return result.choices[0]?.message?.content ?? '';
+    }
+    async models() {
+        const list = await this.client.models.list();
+        return list.data;
+    }
+}
+export default SimoClient;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,wDAAwD;AACxD,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,sEAAsE;AACtE,iEAAiE;AACjE,iEAAiE;AAEjE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAsBvD,uEAAuE;AACvE,EAAE;AACF,oEAAoE;AACpE,sEAAsE;AACtE,qDAAqD;AACrD,gEAAgE;AAChE,yEAAyE;AACzE,4CAA4C;AAE5C,OAAO,EAAE,UAAU,EAA0B,MAAM,aAAa,CAAC;AAGjE,mDAAmD;AACnD,MAAM,OAAO,UAAU;IACJ,MAAM,CAAa;IAEpC,YAAY,IAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAMV;QACC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACzC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,eAAe;YACpC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,IAKb;QACC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC;YAC/C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,eAAe;YACpC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,KAAc;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;YAC7B,KAAK;YACL,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;SAChD,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF;AAED,eAAe,UAAU,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,168 @@
+export interface ApiErrorBody {
+    error: {
+        message: string;
+        type: 'auth_error' | 'rate_limit' | 'validation_error' | 'invalid_request_error' | 'not_found' | 'idempotency_conflict' | 'byok_provider_missing' | 'request_error' | 'server_error';
+        code?: string;
+        param?: string | null;
+        retry_after?: number | null;
+        details?: Record<string, unknown>;
+    };
+}
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | null;
+    name?: string;
+    tool_call_id?: string;
+    tool_calls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+export interface ChatCompletionRequest {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    top_p?: number;
+    max_tokens?: number;
+    stream?: boolean;
+    stop?: string | string[];
+    presence_penalty?: number;
+    frequency_penalty?: number;
+    user?: string;
+    seed?: number;
+    response_format?: {
+        type: 'text' | 'json_object';
+    };
+    tools?: Array<{
+        type: 'function';
+        function: {
+            name: string;
+            description?: string;
+            parameters?: Record<string, unknown>;
+        };
+    }>;
+    tool_choice?: 'none' | 'auto' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+}
+export interface ChatCompletionChoice {
+    index: number;
+    message: ChatMessage;
+    finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter' | null;
+}
+export interface ChatCompletionUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+export interface ChatCompletion {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: ChatCompletionChoice[];
+    usage?: ChatCompletionUsage;
+    system_fingerprint?: string;
+}
+export interface ChatCompletionChunkChoice {
+    index: number;
+    delta: Partial<ChatMessage>;
+    finish_reason: ChatCompletionChoice['finish_reason'];
+}
+export interface ChatCompletionChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: ChatCompletionChunkChoice[];
+}
+export interface ModelInfo {
+    id: string;
+    object: 'model';
+    created: number;
+    owned_by: string;
+    /** Custom SIMO-side metadata. Optional — not all backends populate it. */
+    metadata?: {
+        region?: 'eu-central' | 'eu-west' | 'eu-north' | 'on-prem' | string;
+        sovereignty?: 'eu' | 'global';
+        pricing?: {
+            input_per_1m_tokens_eur?: number;
+            output_per_1m_tokens_eur?: number;
+        };
+        context_window?: number;
+    };
+}
+export interface ModelList {
+    object: 'list';
+    data: ModelInfo[];
+}
+export interface ApiKey {
+    id: string;
+    name: string;
+    prefix: string;
+    /** Full token, only returned at creation time. */
+    token?: string;
+    created_at: string;
+    last_used_at?: string | null;
+    revoked_at?: string | null;
+    plan?: string;
+    scopes?: string[];
+}
+export interface CreateApiKeyRequest {
+    name: string;
+    scopes?: string[];
+    expires_at?: string;
+}
+export interface UploadedFile {
+    id: string;
+    object: 'file';
+    bytes: number;
+    created_at: number;
+    filename: string;
+    purpose: 'assistants' | 'fine-tune' | 'batch' | 'user_data' | string;
+    /** Pre-signed download URL (TTL controlled by gateway). */
+    url?: string;
+}
+export interface CreditBalance {
+    /** Remaining credits, expressed in micro-EUR (1 EUR = 1_000_000). */
+    balance_micro_eur: number;
+    /** Convenience: balance in EUR as a fixed-precision string. */
+    balance_eur: string;
+    currency: 'EUR';
+    plan?: string;
+    /** ISO-8601 timestamp the balance was last reconciled with billing. */
+    last_reconciled_at?: string;
+}
+export interface UsageSummary {
+    from: string;
+    to: string;
+    total_requests: number;
+    total_input_tokens: number;
+    total_output_tokens: number;
+    total_cost_micro_eur: number;
+    by_model?: Array<{
+        model: string;
+        requests: number;
+        input_tokens: number;
+        output_tokens: number;
+        cost_micro_eur: number;
+    }>;
+}
+export interface RequestOptions {
+    /** Optional AbortSignal to cancel the request. */
+    signal?: AbortSignal;
+    /** Additional headers merged into the request. */
+    headers?: Record<string, string>;
+    /** Override the default fetch timeout (ms). */
+    timeoutMs?: number;
+    /** Idempotency-Key header value (for mutating requests). */
+    idempotencyKey?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: BUSL-1.1
+// Copyright (c) 2026 SIMO GmbH, Aschaffenburg, Germany.
+//
+// Public type surface for @simo-online/sdk. These types mirror the
+// stable subset of the OpenAPI 3.1 spec published at
+// https://api.simosphereai.com/openapi.json (version 2026-05-18).
+//
+// They are intentionally hand-written rather than codegen'd so the
+// SDK stays free of upstream-generator churn and ships with friendly
+// JSDoc. When the spec grows new shapes, extend the relevant
+// interface here and bump the SDK minor version.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,wDAAwD;AACxD,EAAE;AACF,mEAAmE;AACnE,qDAAqD;AACrD,kEAAkE;AAClE,EAAE;AACF,mEAAmE;AACnE,qEAAqE;AACrE,6DAA6D;AAC7D,iDAAiD"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@simo-online/sdk",
+  "version": "3.0.0",
+  "description": "Official TypeScript / JavaScript SDK for the SIMOSphere AI API — OpenAI-compatible chat/completions plus tenant admin (keys, usage, credits, files). Sovereign EU-hosted LLMs.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.17"
+  },
+  "license": "BUSL-1.1",
+  "author": "SIMO GmbH <info@simo-online.com>",
+  "homepage": "https://onboarding.simosphereai.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SIMOSphereOS/simosphere-ai-api-platform.git",
+    "directory": "sdk/typescript"
+  },
+  "bugs": {
+    "url": "https://github.com/SIMOSphereOS/simosphere-ai-api-platform/issues"
+  },
+  "keywords": [
+    "simo",
+    "simosphere",
+    "sdk",
+    "ai",
+    "llm",
+    "openai-compatible",
+    "european-ai",
+    "sovereign-ai",
+    "dsgvo",
+    "gdpr"
+  ],
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  }
+}