@axemere/gateway-openai 0.1.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Axemere LLC
+
+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,46 @@
+# @axemere/gateway-openai
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
+
+Drop-in OpenAI client factory for the [Axemere AI Gateway](https://axemere.ai).
+
+Returns a standard `OpenAI` instance pre-configured to route through the gateway. All existing OpenAI code works unchanged — the gateway adds cost controls, policy enforcement, and an append-only audit ledger to every call.
+
+## Install
+
+```bash
+npm install @axemere/gateway-openai
+```
+
+## Usage
+
+```typescript
+import { openaiClient } from "@axemere/gateway-openai";
+
+const client = openaiClient(); // reads AXEMERE_GATEWAY_URL + AXEMERE_GATEWAY_TOKEN
+
+const response = await client.chat.completions.create({
+  model: "gpt-4o-mini",
+  messages: [{ role: "user", content: "Hello" }],
+});
+console.log(response.choices[0].message.content);
+```
+
+Streaming works exactly as it does with the standard `openai` package.
+
+## Configuration
+
+| Env var | Description |
+|---------|-------------|
+| `AXEMERE_GATEWAY_URL` | Gateway base URL, e.g. `http://localhost:7080` |
+| `AXEMERE_GATEWAY_TOKEN` | Gateway token issued by the gateway |
+
+## Links
+
+- [Axemere AI Gateway](https://axemere.ai)
+- [Documentation](https://axemere.ai/docs)
+- [GitHub](https://github.com/Axemere-LLC/axemere-node)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import OpenAI from "openai";
+import { AiGatewayConfig } from "@axemere/gateway";
+export { AiGatewayConfig };
+/**
+ * Creates an OpenAI client pre-configured to route through the Axemere AI Gateway.
+ *
+ * The returned client is a standard OpenAI instance — use it exactly as you would
+ * the official openai package. All requests are proxied through the gateway, which
+ * applies policy, budgets, and records usage.
+ *
+ * @param config - AiGatewayConfig instance (reads env vars if omitted).
+ * @param options - Additional OpenAI constructor options (merged after gateway defaults).
+ */
+export declare function openaiClient(config?: AiGatewayConfig, options?: ConstructorParameters<typeof OpenAI>[0]): OpenAI;

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiGatewayConfig = void 0;
+exports.openaiClient = openaiClient;
+const openai_1 = __importDefault(require("openai"));
+const gateway_1 = require("@axemere/gateway");
+Object.defineProperty(exports, "AiGatewayConfig", { enumerable: true, get: function () { return gateway_1.AiGatewayConfig; } });
+/**
+ * Creates an OpenAI client pre-configured to route through the Axemere AI Gateway.
+ *
+ * The returned client is a standard OpenAI instance — use it exactly as you would
+ * the official openai package. All requests are proxied through the gateway, which
+ * applies policy, budgets, and records usage.
+ *
+ * @param config - AiGatewayConfig instance (reads env vars if omitted).
+ * @param options - Additional OpenAI constructor options (merged after gateway defaults).
+ */
+function openaiClient(config, options) {
+    const cfg = config ?? new gateway_1.AiGatewayConfig();
+    return new openai_1.default({
+        baseURL: cfg.proxyUrl("openai") + "v1/",
+        apiKey: cfg.gateway_token || "axemere-gateway",
+        ...options,
+    });
+}

package/dist/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.test.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const openai_1 = __importDefault(require("openai"));
+const gateway_1 = require("@axemere/gateway");
+const index_1 = require("./index");
+describe("openaiClient()", () => {
+    it("returns an OpenAI instance", () => {
+        const cfg = new gateway_1.AiGatewayConfig({ gateway_url: "http://localhost:7080" });
+        const client = (0, index_1.openaiClient)(cfg);
+        expect(client).toBeInstanceOf(openai_1.default);
+    });
+    it("uses proxyUrl(openai) + v1/ as baseURL", () => {
+        const cfg = new gateway_1.AiGatewayConfig({
+            gateway_url: "http://localhost:7080",
+            gateway_token: "tok_test",
+            project_id: "",
+            account_id: "",
+            customer_id: "",
+        });
+        const client = (0, index_1.openaiClient)(cfg);
+        // OpenAI stores the resolved baseURL on the instance
+        expect(client.baseURL).toBe("http://localhost:7080/proxy/openai/k/tok_test/v1/");
+    });
+    it("falls back to sentinel apiKey when gateway_token is empty", () => {
+        const cfg = new gateway_1.AiGatewayConfig({ gateway_url: "http://localhost:7080", gateway_token: "" });
+        const client = (0, index_1.openaiClient)(cfg);
+        expect(client.apiKey).toBe("axemere-gateway");
+    });
+    it("uses gateway_token as apiKey when set", () => {
+        const cfg = new gateway_1.AiGatewayConfig({
+            gateway_url: "http://localhost:7080",
+            gateway_token: "my_token",
+        });
+        const client = (0, index_1.openaiClient)(cfg);
+        expect(client.apiKey).toBe("my_token");
+    });
+    it("constructs with default config when no config passed", () => {
+        delete process.env["AXEMERE_GATEWAY_URL"];
+        delete process.env["AXEMERE_GATEWAY_TOKEN"];
+        expect(() => (0, index_1.openaiClient)()).not.toThrow();
+    });
+    it("merges extra options after gateway defaults", () => {
+        const cfg = new gateway_1.AiGatewayConfig({ gateway_url: "http://localhost:7080" });
+        const client = (0, index_1.openaiClient)(cfg, { maxRetries: 0, timeout: 5000 });
+        expect(client.maxRetries).toBe(0);
+    });
+});

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@axemere/gateway-openai",
+  "version": "0.1.6",
+  "description": "Axemere AI Gateway SDK — OpenAI drop-in wrapper",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Axemere-LLC/axemere-node.git",
+    "directory": "packages/gateway-openai"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "openai": "^4.0.0",
+    "@axemere/gateway": "0.1.6"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0",
+    "@types/jest": "^29.0.0",
+    "jest": "^29.0.0",
+    "ts-jest": "^29.0.0"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "transform": {
+      "^.+\\.tsx?$": [
+        "ts-jest",
+        {
+          "useESM": false
+        }
+      ]
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "jest"
+  }
+}