ainvoker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AInvoker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,69 @@
+# @ainvoker/sdk
+
+Official TypeScript/JavaScript SDK for the AInvoker AI gateway.
+
+## Install
+
+```bash
+npm install ainvoker
+```
+
+Requires Node.js 18+ (native `fetch`).
+
+## Quick start
+
+```ts
+import { Ainvoker, isAinvokerError } from "ainvoker"
+
+const ai = new Ainvoker({
+  apiKey: process.env.AINVOKER_API_KEY!,
+  // optional — defaults to http://localhost:3000
+  // baseUrl: "https://api.example.com",
+})
+
+try {
+  const result = await ai.text.chat({
+    model: "openai/gpt-4o-mini",
+    messages: [{ role: "user", content: "Hello" }],
+  })
+  console.log(result.message.content)
+} catch (error) {
+  if (isAinvokerError(error)) {
+    console.error(error.status, error.code, error.message)
+  } else {
+    throw error
+  }
+}
+```
+
+## Local smoke
+
+With the API running locally:
+
+1. Copy `.env.example` → `.env` and set `AINVOKER_API_KEY`
+2. Run:
+
+```bash
+npm run smoke
+```
+
+Optional env: `AINVOKER_BASE_URL`, `AINVOKER_MODEL`.
+
+## Development
+
+```bash
+npm install
+npm test
+npm run build
+```
+
+## Publishing
+
+Version is semver (`0.1.0` while the API surface is early). Before publish:
+
+```bash
+npm run prepublishOnly   # typecheck + test + build
+npm publish              # requires npm login + @ainvoker org access
+```
+
+`publishConfig.access` is `public` so the scoped package can be published without a paid org private default.

package/dist/index.cjs

@@ -0,0 +1,138 @@
+'use strict';
+
+// src/errors.ts
+var AinvokerError = class extends Error {
+  status;
+  code;
+  /** Parsed response body when available (error envelope or raw JSON). */
+  body;
+  constructor(status, code, message, body = void 0) {
+    super(message);
+    this.name = "AinvokerError";
+    this.status = status;
+    this.code = code;
+    this.body = body;
+  }
+};
+function isAinvokerError(error) {
+  return error instanceof AinvokerError;
+}
+
+// src/http.ts
+function isRecord(value) {
+  return value !== null && typeof value === "object";
+}
+function parseErrorPayload(json) {
+  if (!isRecord(json) || !isRecord(json.error)) {
+    return null;
+  }
+  const { code, message } = json.error;
+  if (typeof code !== "string" || typeof message !== "string") {
+    return null;
+  }
+  return { code, message };
+}
+function hasDataEnvelope(json) {
+  return isRecord(json) && "data" in json;
+}
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+  }
+  /**
+   * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.
+   */
+  async post(path, body) {
+    const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          Accept: "application/json"
+        },
+        body: JSON.stringify(body)
+      });
+    } catch (cause) {
+      const message = cause instanceof Error ? cause.message : "Network request failed";
+      throw new AinvokerError(0, "NETWORK_ERROR", message);
+    }
+    const text = await response.text();
+    let json = void 0;
+    if (text.length > 0) {
+      try {
+        json = JSON.parse(text);
+      } catch {
+        throw new AinvokerError(
+          response.status,
+          "INVALID_RESPONSE",
+          "Response body was not valid JSON",
+          text
+        );
+      }
+    }
+    if (!response.ok) {
+      const parsed = parseErrorPayload(json);
+      throw new AinvokerError(
+        response.status,
+        parsed?.code ?? "HTTP_ERROR",
+        parsed?.message ?? `Request failed with status ${response.status}`,
+        json
+      );
+    }
+    if (!hasDataEnvelope(json)) {
+      throw new AinvokerError(
+        response.status,
+        "INVALID_RESPONSE",
+        "Response missing data envelope",
+        json
+      );
+    }
+    return json.data;
+  }
+};
+
+// src/resources/text.ts
+var TextResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Text chat completion via the AInvoker gateway (`POST /v1/text/chat`).
+   *
+   * Authenticate with a project API key. `model` must be a `provider/model`
+   * slug (e.g. `"openai/gpt-4o-mini"` or `"gemini/gemini-2.5-flash"`).
+   */
+  chat(params) {
+    return this.http.post("/v1/text/chat", params);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "http://localhost:3000";
+var Ainvoker = class {
+  /** Text modality (`/v1/text/...`). */
+  text;
+  constructor(options) {
+    if (!options.apiKey || options.apiKey.trim().length === 0) {
+      throw new Error("Ainvoker: apiKey is required");
+    }
+    const http = new HttpClient({
+      apiKey: options.apiKey,
+      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL
+    });
+    this.text = new TextResource(http);
+  }
+};
+
+exports.Ainvoker = Ainvoker;
+exports.AinvokerError = AinvokerError;
+exports.isAinvokerError = isAinvokerError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/resources/text.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * Known AInvoker API / SDK error codes.\r\n * Unknown server codes remain assignable via the open string union.\r\n */\r\nexport type AinvokerErrorCode =\r\n  | \"UNAUTHORIZED\"\r\n  | \"FORBIDDEN\"\r\n  | \"NOT_FOUND\"\r\n  | \"VALIDATION_ERROR\"\r\n  | \"CONFLICT\"\r\n  | \"UPSTREAM_ERROR\"\r\n  | \"INTERNAL_ERROR\"\r\n  | \"NETWORK_ERROR\"\r\n  | \"INVALID_RESPONSE\"\r\n  | \"HTTP_ERROR\"\r\n  | (string & {})\r\n\r\n/**\r\n * Error thrown when the AInvoker API returns a non-success response\r\n * or the response body cannot be parsed as expected.\r\n */\r\nexport class AinvokerError extends Error {\r\n  readonly status: number\r\n  readonly code: AinvokerErrorCode\r\n  /** Parsed response body when available (error envelope or raw JSON). */\r\n  readonly body: unknown\r\n\r\n  constructor(\r\n    status: number,\r\n    code: AinvokerErrorCode,\r\n    message: string,\r\n    body: unknown = undefined,\r\n  ) {\r\n    super(message)\r\n    this.name = \"AinvokerError\"\r\n    this.status = status\r\n    this.code = code\r\n    this.body = body\r\n  }\r\n}\r\n\r\n/** Type guard for {@link AinvokerError}. */\r\nexport function isAinvokerError(error: unknown): error is AinvokerError {\r\n  return error instanceof AinvokerError\r\n}\r\n","import { AinvokerError } from \"./errors.js\"\r\nimport type { AinvokerErrorCode } from \"./errors.js\"\r\nimport type { DataEnvelope } from \"./types.js\"\r\n\r\nexport interface HttpClientOptions {\r\n  apiKey: string\r\n  baseUrl: string\r\n}\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n  return value !== null && typeof value === \"object\"\r\n}\r\n\r\nfunction parseErrorPayload(json: unknown): { code: AinvokerErrorCode; message: string } | null {\r\n  if (!isRecord(json) || !isRecord(json.error)) {\r\n    return null\r\n  }\r\n  const { code, message } = json.error\r\n  if (typeof code !== \"string\" || typeof message !== \"string\") {\r\n    return null\r\n  }\r\n  return { code, message }\r\n}\r\n\r\nfunction hasDataEnvelope(json: unknown): json is DataEnvelope<unknown> {\r\n  return isRecord(json) && \"data\" in json\r\n}\r\n\r\nexport class HttpClient {\r\n  private readonly apiKey: string\r\n  private readonly baseUrl: string\r\n\r\n  constructor(options: HttpClientOptions) {\r\n    this.apiKey = options.apiKey\r\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\")\r\n  }\r\n\r\n  /**\r\n   * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.\r\n   */\r\n  async post<T>(path: string, body: unknown): Promise<T> {\r\n    const url = `${this.baseUrl}${path.startsWith(\"/\") ? path : `/${path}`}`\r\n\r\n    let response: Response\r\n    try {\r\n      response = await fetch(url, {\r\n        method: \"POST\",\r\n        headers: {\r\n          Authorization: `Bearer ${this.apiKey}`,\r\n          \"Content-Type\": \"application/json\",\r\n          Accept: \"application/json\",\r\n        },\r\n        body: JSON.stringify(body),\r\n      })\r\n    } catch (cause) {\r\n      const message = cause instanceof Error ? cause.message : \"Network request failed\"\r\n      throw new AinvokerError(0, \"NETWORK_ERROR\", message)\r\n    }\r\n\r\n    const text = await response.text()\r\n    let json: unknown = undefined\r\n    if (text.length > 0) {\r\n      try {\r\n        json = JSON.parse(text) as unknown\r\n      } catch {\r\n        throw new AinvokerError(\r\n          response.status,\r\n          \"INVALID_RESPONSE\",\r\n          \"Response body was not valid JSON\",\r\n          text,\r\n        )\r\n      }\r\n    }\r\n\r\n    if (!response.ok) {\r\n      const parsed = parseErrorPayload(json)\r\n      throw new AinvokerError(\r\n        response.status,\r\n        parsed?.code ?? \"HTTP_ERROR\",\r\n        parsed?.message ?? `Request failed with status ${response.status}`,\r\n        json,\r\n      )\r\n    }\r\n\r\n    if (!hasDataEnvelope(json)) {\r\n      throw new AinvokerError(\r\n        response.status,\r\n        \"INVALID_RESPONSE\",\r\n        \"Response missing data envelope\",\r\n        json,\r\n      )\r\n    }\r\n\r\n    return json.data as T\r\n  }\r\n}\r\n","import type { HttpClient } from \"../http.js\"\r\nimport type { TextChatParams, TextChatResult } from \"../types.js\"\r\n\r\n/**\r\n * Text modality methods (`/v1/text/...`).\r\n */\r\nexport class TextResource {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Text chat completion via the AInvoker gateway (`POST /v1/text/chat`).\r\n   *\r\n   * Authenticate with a project API key. `model` must be a `provider/model`\r\n   * slug (e.g. `\"openai/gpt-4o-mini\"` or `\"gemini/gemini-2.5-flash\"`).\r\n   */\r\n  chat(params: TextChatParams): Promise<TextChatResult> {\r\n    return this.http.post<TextChatResult>(\"/v1/text/chat\", params)\r\n  }\r\n}\r\n","import { HttpClient } from \"./http.js\"\r\nimport { TextResource } from \"./resources/text.js\"\r\nimport type { AinvokerOptions } from \"./types.js\"\r\n\r\nconst DEFAULT_BASE_URL = \"http://localhost:3000\"\r\n\r\n/**\r\n * Official AInvoker SDK client.\r\n *\r\n * Use modality namespaces such as {@link Ainvoker.text} for gateway calls.\r\n */\r\nexport class Ainvoker {\r\n  /** Text modality (`/v1/text/...`). */\r\n  readonly text: TextResource\r\n\r\n  constructor(options: AinvokerOptions) {\r\n    if (!options.apiKey || options.apiKey.trim().length === 0) {\r\n      throw new Error(\"Ainvoker: apiKey is required\")\r\n    }\r\n\r\n    const http = new HttpClient({\r\n      apiKey: options.apiKey,\r\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\r\n    })\r\n\r\n    this.text = new TextResource(http)\r\n  }\r\n}\r\n"]}

package/dist/index.d.cts

@@ -0,0 +1,114 @@
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: HttpClientOptions);
+    /**
+     * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.
+     */
+    post<T>(path: string, body: unknown): Promise<T>;
+}
+
+/**
+ * Client configuration for {@link Ainvoker}.
+ */
+interface AinvokerOptions {
+    /**
+     * Project API key (`ain_…`).
+     * Sent as `Authorization: Bearer <apiKey>`.
+     */
+    apiKey: string;
+    /**
+     * API host. Defaults to `http://localhost:3000`.
+     * Override for staging/production or a custom deployment.
+     */
+    baseUrl?: string;
+}
+/**
+ * A single chat turn.
+ */
+interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+/**
+ * Parameters for {@link TextResource.chat}.
+ */
+interface TextChatParams {
+    /**
+     * Provider model slug, e.g. `"openai/gpt-4o-mini"` or `"gemini/gemini-2.5-flash"`.
+     */
+    model: string;
+    messages: ChatMessage[];
+    /** Sampling temperature (0–2). */
+    temperature?: number;
+    /** Maximum tokens to generate. */
+    maxTokens?: number;
+}
+/**
+ * Token usage reported by the gateway (may be null).
+ */
+interface ChatUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+/**
+ * Successful text chat result (API `{ data }` unwrapped).
+ */
+interface TextChatResult {
+    id: string;
+    model: string;
+    message: ChatMessage;
+    usage: ChatUsage | null;
+}
+
+/**
+ * Text modality methods (`/v1/text/...`).
+ */
+declare class TextResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Text chat completion via the AInvoker gateway (`POST /v1/text/chat`).
+     *
+     * Authenticate with a project API key. `model` must be a `provider/model`
+     * slug (e.g. `"openai/gpt-4o-mini"` or `"gemini/gemini-2.5-flash"`).
+     */
+    chat(params: TextChatParams): Promise<TextChatResult>;
+}
+
+/**
+ * Official AInvoker SDK client.
+ *
+ * Use modality namespaces such as {@link Ainvoker.text} for gateway calls.
+ */
+declare class Ainvoker {
+    /** Text modality (`/v1/text/...`). */
+    readonly text: TextResource;
+    constructor(options: AinvokerOptions);
+}
+
+/**
+ * Known AInvoker API / SDK error codes.
+ * Unknown server codes remain assignable via the open string union.
+ */
+type AinvokerErrorCode = "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION_ERROR" | "CONFLICT" | "UPSTREAM_ERROR" | "INTERNAL_ERROR" | "NETWORK_ERROR" | "INVALID_RESPONSE" | "HTTP_ERROR" | (string & {});
+/**
+ * Error thrown when the AInvoker API returns a non-success response
+ * or the response body cannot be parsed as expected.
+ */
+declare class AinvokerError extends Error {
+    readonly status: number;
+    readonly code: AinvokerErrorCode;
+    /** Parsed response body when available (error envelope or raw JSON). */
+    readonly body: unknown;
+    constructor(status: number, code: AinvokerErrorCode, message: string, body?: unknown);
+}
+/** Type guard for {@link AinvokerError}. */
+declare function isAinvokerError(error: unknown): error is AinvokerError;
+
+export { Ainvoker, AinvokerError, type AinvokerErrorCode, type AinvokerOptions, type ChatMessage, type ChatUsage, type TextChatParams, type TextChatResult, isAinvokerError };

package/dist/index.d.ts

@@ -0,0 +1,114 @@
+interface HttpClientOptions {
+    apiKey: string;
+    baseUrl: string;
+}
+declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: HttpClientOptions);
+    /**
+     * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.
+     */
+    post<T>(path: string, body: unknown): Promise<T>;
+}
+
+/**
+ * Client configuration for {@link Ainvoker}.
+ */
+interface AinvokerOptions {
+    /**
+     * Project API key (`ain_…`).
+     * Sent as `Authorization: Bearer <apiKey>`.
+     */
+    apiKey: string;
+    /**
+     * API host. Defaults to `http://localhost:3000`.
+     * Override for staging/production or a custom deployment.
+     */
+    baseUrl?: string;
+}
+/**
+ * A single chat turn.
+ */
+interface ChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+/**
+ * Parameters for {@link TextResource.chat}.
+ */
+interface TextChatParams {
+    /**
+     * Provider model slug, e.g. `"openai/gpt-4o-mini"` or `"gemini/gemini-2.5-flash"`.
+     */
+    model: string;
+    messages: ChatMessage[];
+    /** Sampling temperature (0–2). */
+    temperature?: number;
+    /** Maximum tokens to generate. */
+    maxTokens?: number;
+}
+/**
+ * Token usage reported by the gateway (may be null).
+ */
+interface ChatUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+}
+/**
+ * Successful text chat result (API `{ data }` unwrapped).
+ */
+interface TextChatResult {
+    id: string;
+    model: string;
+    message: ChatMessage;
+    usage: ChatUsage | null;
+}
+
+/**
+ * Text modality methods (`/v1/text/...`).
+ */
+declare class TextResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Text chat completion via the AInvoker gateway (`POST /v1/text/chat`).
+     *
+     * Authenticate with a project API key. `model` must be a `provider/model`
+     * slug (e.g. `"openai/gpt-4o-mini"` or `"gemini/gemini-2.5-flash"`).
+     */
+    chat(params: TextChatParams): Promise<TextChatResult>;
+}
+
+/**
+ * Official AInvoker SDK client.
+ *
+ * Use modality namespaces such as {@link Ainvoker.text} for gateway calls.
+ */
+declare class Ainvoker {
+    /** Text modality (`/v1/text/...`). */
+    readonly text: TextResource;
+    constructor(options: AinvokerOptions);
+}
+
+/**
+ * Known AInvoker API / SDK error codes.
+ * Unknown server codes remain assignable via the open string union.
+ */
+type AinvokerErrorCode = "UNAUTHORIZED" | "FORBIDDEN" | "NOT_FOUND" | "VALIDATION_ERROR" | "CONFLICT" | "UPSTREAM_ERROR" | "INTERNAL_ERROR" | "NETWORK_ERROR" | "INVALID_RESPONSE" | "HTTP_ERROR" | (string & {});
+/**
+ * Error thrown when the AInvoker API returns a non-success response
+ * or the response body cannot be parsed as expected.
+ */
+declare class AinvokerError extends Error {
+    readonly status: number;
+    readonly code: AinvokerErrorCode;
+    /** Parsed response body when available (error envelope or raw JSON). */
+    readonly body: unknown;
+    constructor(status: number, code: AinvokerErrorCode, message: string, body?: unknown);
+}
+/** Type guard for {@link AinvokerError}. */
+declare function isAinvokerError(error: unknown): error is AinvokerError;
+
+export { Ainvoker, AinvokerError, type AinvokerErrorCode, type AinvokerOptions, type ChatMessage, type ChatUsage, type TextChatParams, type TextChatResult, isAinvokerError };

package/dist/index.js

@@ -0,0 +1,134 @@
+// src/errors.ts
+var AinvokerError = class extends Error {
+  status;
+  code;
+  /** Parsed response body when available (error envelope or raw JSON). */
+  body;
+  constructor(status, code, message, body = void 0) {
+    super(message);
+    this.name = "AinvokerError";
+    this.status = status;
+    this.code = code;
+    this.body = body;
+  }
+};
+function isAinvokerError(error) {
+  return error instanceof AinvokerError;
+}
+
+// src/http.ts
+function isRecord(value) {
+  return value !== null && typeof value === "object";
+}
+function parseErrorPayload(json) {
+  if (!isRecord(json) || !isRecord(json.error)) {
+    return null;
+  }
+  const { code, message } = json.error;
+  if (typeof code !== "string" || typeof message !== "string") {
+    return null;
+  }
+  return { code, message };
+}
+function hasDataEnvelope(json) {
+  return isRecord(json) && "data" in json;
+}
+var HttpClient = class {
+  apiKey;
+  baseUrl;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+  }
+  /**
+   * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.
+   */
+  async post(path, body) {
+    const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          Accept: "application/json"
+        },
+        body: JSON.stringify(body)
+      });
+    } catch (cause) {
+      const message = cause instanceof Error ? cause.message : "Network request failed";
+      throw new AinvokerError(0, "NETWORK_ERROR", message);
+    }
+    const text = await response.text();
+    let json = void 0;
+    if (text.length > 0) {
+      try {
+        json = JSON.parse(text);
+      } catch {
+        throw new AinvokerError(
+          response.status,
+          "INVALID_RESPONSE",
+          "Response body was not valid JSON",
+          text
+        );
+      }
+    }
+    if (!response.ok) {
+      const parsed = parseErrorPayload(json);
+      throw new AinvokerError(
+        response.status,
+        parsed?.code ?? "HTTP_ERROR",
+        parsed?.message ?? `Request failed with status ${response.status}`,
+        json
+      );
+    }
+    if (!hasDataEnvelope(json)) {
+      throw new AinvokerError(
+        response.status,
+        "INVALID_RESPONSE",
+        "Response missing data envelope",
+        json
+      );
+    }
+    return json.data;
+  }
+};
+
+// src/resources/text.ts
+var TextResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Text chat completion via the AInvoker gateway (`POST /v1/text/chat`).
+   *
+   * Authenticate with a project API key. `model` must be a `provider/model`
+   * slug (e.g. `"openai/gpt-4o-mini"` or `"gemini/gemini-2.5-flash"`).
+   */
+  chat(params) {
+    return this.http.post("/v1/text/chat", params);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "http://localhost:3000";
+var Ainvoker = class {
+  /** Text modality (`/v1/text/...`). */
+  text;
+  constructor(options) {
+    if (!options.apiKey || options.apiKey.trim().length === 0) {
+      throw new Error("Ainvoker: apiKey is required");
+    }
+    const http = new HttpClient({
+      apiKey: options.apiKey,
+      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL
+    });
+    this.text = new TextResource(http);
+  }
+};
+
+export { Ainvoker, AinvokerError, isAinvokerError };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/resources/text.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * Known AInvoker API / SDK error codes.\r\n * Unknown server codes remain assignable via the open string union.\r\n */\r\nexport type AinvokerErrorCode =\r\n  | \"UNAUTHORIZED\"\r\n  | \"FORBIDDEN\"\r\n  | \"NOT_FOUND\"\r\n  | \"VALIDATION_ERROR\"\r\n  | \"CONFLICT\"\r\n  | \"UPSTREAM_ERROR\"\r\n  | \"INTERNAL_ERROR\"\r\n  | \"NETWORK_ERROR\"\r\n  | \"INVALID_RESPONSE\"\r\n  | \"HTTP_ERROR\"\r\n  | (string & {})\r\n\r\n/**\r\n * Error thrown when the AInvoker API returns a non-success response\r\n * or the response body cannot be parsed as expected.\r\n */\r\nexport class AinvokerError extends Error {\r\n  readonly status: number\r\n  readonly code: AinvokerErrorCode\r\n  /** Parsed response body when available (error envelope or raw JSON). */\r\n  readonly body: unknown\r\n\r\n  constructor(\r\n    status: number,\r\n    code: AinvokerErrorCode,\r\n    message: string,\r\n    body: unknown = undefined,\r\n  ) {\r\n    super(message)\r\n    this.name = \"AinvokerError\"\r\n    this.status = status\r\n    this.code = code\r\n    this.body = body\r\n  }\r\n}\r\n\r\n/** Type guard for {@link AinvokerError}. */\r\nexport function isAinvokerError(error: unknown): error is AinvokerError {\r\n  return error instanceof AinvokerError\r\n}\r\n","import { AinvokerError } from \"./errors.js\"\r\nimport type { AinvokerErrorCode } from \"./errors.js\"\r\nimport type { DataEnvelope } from \"./types.js\"\r\n\r\nexport interface HttpClientOptions {\r\n  apiKey: string\r\n  baseUrl: string\r\n}\r\n\r\nfunction isRecord(value: unknown): value is Record<string, unknown> {\r\n  return value !== null && typeof value === \"object\"\r\n}\r\n\r\nfunction parseErrorPayload(json: unknown): { code: AinvokerErrorCode; message: string } | null {\r\n  if (!isRecord(json) || !isRecord(json.error)) {\r\n    return null\r\n  }\r\n  const { code, message } = json.error\r\n  if (typeof code !== \"string\" || typeof message !== \"string\") {\r\n    return null\r\n  }\r\n  return { code, message }\r\n}\r\n\r\nfunction hasDataEnvelope(json: unknown): json is DataEnvelope<unknown> {\r\n  return isRecord(json) && \"data\" in json\r\n}\r\n\r\nexport class HttpClient {\r\n  private readonly apiKey: string\r\n  private readonly baseUrl: string\r\n\r\n  constructor(options: HttpClientOptions) {\r\n    this.apiKey = options.apiKey\r\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, \"\")\r\n  }\r\n\r\n  /**\r\n   * POST JSON to a path under `baseUrl`. Unwraps `{ data: T }` on success.\r\n   */\r\n  async post<T>(path: string, body: unknown): Promise<T> {\r\n    const url = `${this.baseUrl}${path.startsWith(\"/\") ? path : `/${path}`}`\r\n\r\n    let response: Response\r\n    try {\r\n      response = await fetch(url, {\r\n        method: \"POST\",\r\n        headers: {\r\n          Authorization: `Bearer ${this.apiKey}`,\r\n          \"Content-Type\": \"application/json\",\r\n          Accept: \"application/json\",\r\n        },\r\n        body: JSON.stringify(body),\r\n      })\r\n    } catch (cause) {\r\n      const message = cause instanceof Error ? cause.message : \"Network request failed\"\r\n      throw new AinvokerError(0, \"NETWORK_ERROR\", message)\r\n    }\r\n\r\n    const text = await response.text()\r\n    let json: unknown = undefined\r\n    if (text.length > 0) {\r\n      try {\r\n        json = JSON.parse(text) as unknown\r\n      } catch {\r\n        throw new AinvokerError(\r\n          response.status,\r\n          \"INVALID_RESPONSE\",\r\n          \"Response body was not valid JSON\",\r\n          text,\r\n        )\r\n      }\r\n    }\r\n\r\n    if (!response.ok) {\r\n      const parsed = parseErrorPayload(json)\r\n      throw new AinvokerError(\r\n        response.status,\r\n        parsed?.code ?? \"HTTP_ERROR\",\r\n        parsed?.message ?? `Request failed with status ${response.status}`,\r\n        json,\r\n      )\r\n    }\r\n\r\n    if (!hasDataEnvelope(json)) {\r\n      throw new AinvokerError(\r\n        response.status,\r\n        \"INVALID_RESPONSE\",\r\n        \"Response missing data envelope\",\r\n        json,\r\n      )\r\n    }\r\n\r\n    return json.data as T\r\n  }\r\n}\r\n","import type { HttpClient } from \"../http.js\"\r\nimport type { TextChatParams, TextChatResult } from \"../types.js\"\r\n\r\n/**\r\n * Text modality methods (`/v1/text/...`).\r\n */\r\nexport class TextResource {\r\n  constructor(private readonly http: HttpClient) {}\r\n\r\n  /**\r\n   * Text chat completion via the AInvoker gateway (`POST /v1/text/chat`).\r\n   *\r\n   * Authenticate with a project API key. `model` must be a `provider/model`\r\n   * slug (e.g. `\"openai/gpt-4o-mini\"` or `\"gemini/gemini-2.5-flash\"`).\r\n   */\r\n  chat(params: TextChatParams): Promise<TextChatResult> {\r\n    return this.http.post<TextChatResult>(\"/v1/text/chat\", params)\r\n  }\r\n}\r\n","import { HttpClient } from \"./http.js\"\r\nimport { TextResource } from \"./resources/text.js\"\r\nimport type { AinvokerOptions } from \"./types.js\"\r\n\r\nconst DEFAULT_BASE_URL = \"http://localhost:3000\"\r\n\r\n/**\r\n * Official AInvoker SDK client.\r\n *\r\n * Use modality namespaces such as {@link Ainvoker.text} for gateway calls.\r\n */\r\nexport class Ainvoker {\r\n  /** Text modality (`/v1/text/...`). */\r\n  readonly text: TextResource\r\n\r\n  constructor(options: AinvokerOptions) {\r\n    if (!options.apiKey || options.apiKey.trim().length === 0) {\r\n      throw new Error(\"Ainvoker: apiKey is required\")\r\n    }\r\n\r\n    const http = new HttpClient({\r\n      apiKey: options.apiKey,\r\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\r\n    })\r\n\r\n    this.text = new TextResource(http)\r\n  }\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "ainvoker",
+  "version": "0.1.0",
+  "description": "Official TypeScript/JavaScript SDK for the AInvoker AI gateway",
+  "license": "MIT",
+  "author": "AInvoker",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "ainvoker",
+    "ai",
+    "sdk",
+    "llm",
+    "gateway",
+    "openai",
+    "gemini"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "smoke": "tsx examples/smoke.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "dotenv": "^17.4.2",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  }
+}