@axemere/gateway 0.1.8 → 0.1.10

package/README.md

@@ -41,7 +41,7 @@ console.log(result.metering?.cost_usd); // "0.000042"
 ## Links
 
 - [Axemere AI Gateway](https://axemere.ai)
-- [Documentation](https://axemere.ai/docs)
+- [Documentation](https://axemere.ai/docs/sdks/typescript)
 - [GitHub](https://github.com/Axemere-LLC/axemere-node)
 
 ## License

package/dist/headers.d.ts

@@ -0,0 +1,14 @@
+import { AiGatewayConfig } from "./config";
+/** Placeholder API key passed to provider SDKs that require a non-empty key. The gateway ignores it. */
+export declare const PLACEHOLDER_API_KEY = "axemere-proxy-managed";
+/**
+ * Builds the standard Axemere AI Gateway request headers for proxy-mode requests.
+ *
+ * @param config - Gateway connection and attribution settings.
+ * @param opts.targetHost - Upstream provider hostname (e.g. `"api.openai.com"`).
+ *   Required in proxy mode so the gateway knows where to forward the request.
+ * @returns A `Record<string, string>` of HTTP headers to merge into the outgoing request.
+ */
+export declare function aiGatewayHeaders(config: AiGatewayConfig, opts?: {
+    targetHost?: string;
+}): Record<string, string>;

package/dist/headers.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLACEHOLDER_API_KEY = void 0;
+exports.aiGatewayHeaders = aiGatewayHeaders;
+/** Placeholder API key passed to provider SDKs that require a non-empty key. The gateway ignores it. */
+exports.PLACEHOLDER_API_KEY = "axemere-proxy-managed";
+/**
+ * Builds the standard Axemere AI Gateway request headers for proxy-mode requests.
+ *
+ * @param config - Gateway connection and attribution settings.
+ * @param opts.targetHost - Upstream provider hostname (e.g. `"api.openai.com"`).
+ *   Required in proxy mode so the gateway knows where to forward the request.
+ * @returns A `Record<string, string>` of HTTP headers to merge into the outgoing request.
+ */
+function aiGatewayHeaders(config, opts = {}) {
+    const headers = {};
+    if (config.gateway_token) {
+        headers["Authorization"] = `Bearer ${config.gateway_token}`;
+    }
+    if (opts.targetHost) {
+        headers["X-MVGC-Target-Host"] = opts.targetHost;
+    }
+    if (config.workload_id) {
+        headers["X-MVGC-Workload-ID"] = config.workload_id;
+    }
+    if (config.project_id) {
+        headers["X-MVGC-Project-ID"] = config.project_id;
+    }
+    if (config.account_id) {
+        headers["X-MVGC-Account-ID"] = config.account_id;
+    }
+    if (config.customer_id) {
+        headers["X-MVGC-Customer-ID"] = config.customer_id;
+    }
+    if (config.labels && Object.keys(config.labels).length > 0) {
+        headers["X-MVGC-Labels"] = JSON.stringify(config.labels);
+    }
+    if (config.provider_api_key) {
+        headers["X-MVGC-Provider-API-Key"] = config.provider_api_key;
+    }
+    return headers;
+}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { AiGatewayConfig } from "./config";
 export type { AiGatewayOptions } from "./config";
+export { PLACEHOLDER_API_KEY, aiGatewayHeaders } from "./headers";
 export { AiGatewayClient } from "./client";
 export { GatewayError, PolicyDeniedError, QuotaExceededError, GatewayTimeoutError } from "./errors";
 export { PROVIDER_ROUTES } from "./providers";

package/dist/index.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROVIDER_ROUTES = exports.GatewayTimeoutError = exports.QuotaExceededError = exports.PolicyDeniedError = exports.GatewayError = exports.AiGatewayClient = exports.AiGatewayConfig = void 0;
+exports.PROVIDER_ROUTES = exports.GatewayTimeoutError = exports.QuotaExceededError = exports.PolicyDeniedError = exports.GatewayError = exports.AiGatewayClient = exports.aiGatewayHeaders = exports.PLACEHOLDER_API_KEY = exports.AiGatewayConfig = void 0;
 var config_1 = require("./config");
 Object.defineProperty(exports, "AiGatewayConfig", { enumerable: true, get: function () { return config_1.AiGatewayConfig; } });
+var headers_1 = require("./headers");
+Object.defineProperty(exports, "PLACEHOLDER_API_KEY", { enumerable: true, get: function () { return headers_1.PLACEHOLDER_API_KEY; } });
+Object.defineProperty(exports, "aiGatewayHeaders", { enumerable: true, get: function () { return headers_1.aiGatewayHeaders; } });
 var client_1 = require("./client");
 Object.defineProperty(exports, "AiGatewayClient", { enumerable: true, get: function () { return client_1.AiGatewayClient; } });
 var errors_1 = require("./errors");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axemere/gateway",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Axemere AI Gateway SDK — core client, config, and proxy URL builder",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",