@openrouter/sdk 0.0.0-beta.8 → 0.0.1-beta.0

package/src/sdk/chat.ts

@@ -2,14 +2,13 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { chatSend, SendAcceptEnum } from "../funcs/chatSend.js";
+import { chatSend } from "../funcs/chatSend.js";
+import { EventStream } from "../lib/event-streams.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
-export { SendAcceptEnum } from "../funcs/chatSend.js";
-
 export class Chat extends ClientSDK {
   /**
    * Create a chat completion
@@ -18,9 +17,21 @@ export class Chat extends ClientSDK {
    * Sends a request for a model response for the given chat conversation. Supports both streaming and non-streaming modes.
    */
   async send(
-    request?: models.ChatGenerationParams | undefined,
-    options?: RequestOptions & { acceptHeaderOverride?: SendAcceptEnum },
-  ): Promise<operations.PostChatCompletionsResponse> {
+    request: models.ChatGenerationParams & { stream?: false | undefined },
+    options?: RequestOptions,
+  ): Promise<models.ChatResponse>;
+  async send(
+    request: models.ChatGenerationParams & { stream: true },
+    options?: RequestOptions,
+  ): Promise<EventStream<models.ChatStreamingResponseChunk>>;
+  async send(
+    request: models.ChatGenerationParams,
+    options?: RequestOptions,
+  ): Promise<operations.SendChatCompletionRequestResponse>;
+  async send(
+    request: models.ChatGenerationParams,
+    options?: RequestOptions,
+  ): Promise<operations.SendChatCompletionRequestResponse> {
     return unwrapAsync(chatSend(
       this,
       request,

package/src/sdk/completions.ts

@@ -2,17 +2,11 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import {
-  completionsCreate,
-  CreateAcceptEnum,
-} from "../funcs/completionsCreate.js";
+import { completionsGenerate } from "../funcs/completionsGenerate.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
-import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
-export { CreateAcceptEnum } from "../funcs/completionsCreate.js";
-
 export class Completions extends ClientSDK {
   /**
    * Create a completion
@@ -20,11 +14,11 @@ export class Completions extends ClientSDK {
    * @remarks
    * Creates a completion for the provided prompt and parameters. Supports both streaming and non-streaming modes.
    */
-  async create(
-    request?: models.CompletionCreateParams | undefined,
-    options?: RequestOptions & { acceptHeaderOverride?: CreateAcceptEnum },
-  ): Promise<operations.PostCompletionsResponse> {
-    return unwrapAsync(completionsCreate(
+  async generate(
+    request: models.CompletionCreateParams,
+    options?: RequestOptions,
+  ): Promise<models.CompletionResponse> {
+    return unwrapAsync(completionsGenerate(
       this,
       request,
       options,

package/src/sdk/credits.ts

@@ -2,14 +2,17 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import { creditsCreateCoinbaseCharge } from "../funcs/creditsCreateCoinbaseCharge.js";
 import { creditsGetCredits } from "../funcs/creditsGetCredits.js";
-import { creditsPostCreditsCoinbase } from "../funcs/creditsPostCreditsCoinbase.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class Credits extends ClientSDK {
   /**
+   * Get remaining credits
+   *
+   * @remarks
    * Get total credits purchased and used for the authenticated user
    */
   async getCredits(
@@ -22,14 +25,17 @@ export class Credits extends ClientSDK {
   }
 
   /**
+   * Create a Coinbase charge for crypto payment
+   *
+   * @remarks
    * Create a Coinbase charge for crypto payment
    */
-  async postCreditsCoinbase(
-    security: operations.PostCreditsCoinbaseSecurity,
-    request?: operations.PostCreditsCoinbaseRequest | undefined,
+  async createCoinbaseCharge(
+    security: operations.CreateCoinbaseChargeSecurity,
+    request: operations.CreateCoinbaseChargeRequest,
     options?: RequestOptions,
-  ): Promise<operations.PostCreditsCoinbaseResponse> {
-    return unwrapAsync(creditsPostCreditsCoinbase(
+  ): Promise<operations.CreateCoinbaseChargeResponse> {
+    return unwrapAsync(creditsCreateCoinbaseCharge(
       this,
       security,
       request,

package/src/sdk/endpoints.ts

@@ -2,8 +2,8 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { endpointsGetEndpointsZdr } from "../funcs/endpointsGetEndpointsZdr.js";
-import { endpointsGetModelsAuthorSlugEndpoints } from "../funcs/endpointsGetModelsAuthorSlugEndpoints.js";
+import { endpointsList } from "../funcs/endpointsList.js";
+import { endpointsListZdrEndpoints } from "../funcs/endpointsListZdrEndpoints.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
@@ -12,11 +12,11 @@ export class Endpoints extends ClientSDK {
   /**
    * List all endpoints for a model
    */
-  async getModelsAuthorSlugEndpoints(
-    request: operations.GetModelsAuthorSlugEndpointsRequestRequest,
+  async list(
+    request: operations.ListEndpointsRequest,
     options?: RequestOptions,
-  ): Promise<operations.GetModelsAuthorSlugEndpointsResponse> {
-    return unwrapAsync(endpointsGetModelsAuthorSlugEndpoints(
+  ): Promise<operations.ListEndpointsResponse> {
+    return unwrapAsync(endpointsList(
       this,
       request,
       options,
@@ -26,10 +26,10 @@ export class Endpoints extends ClientSDK {
   /**
    * Preview the impact of ZDR on the available endpoints
    */
-  async getEndpointsZdr(
+  async listZdrEndpoints(
     options?: RequestOptions,
-  ): Promise<operations.GetEndpointsZdrResponse> {
-    return unwrapAsync(endpointsGetEndpointsZdr(
+  ): Promise<operations.ListEndpointsZdrResponse> {
+    return unwrapAsync(endpointsListZdrEndpoints(
       this,
       options,
     ));

package/src/sdk/models.ts

@@ -2,26 +2,21 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import {
-  GetModelsAcceptEnum,
-  modelsGetModels,
-} from "../funcs/modelsGetModels.js";
-import { modelsGetModelsCount } from "../funcs/modelsGetModelsCount.js";
-import { modelsGetModelsUser } from "../funcs/modelsGetModelsUser.js";
+import { modelsGetModels } from "../funcs/modelsGetModels.js";
+import { modelsListModelsCount } from "../funcs/modelsListModelsCount.js";
+import { modelsListModelsUser } from "../funcs/modelsListModelsUser.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
-export { GetModelsAcceptEnum } from "../funcs/modelsGetModels.js";
-
 export class Models extends ClientSDK {
   /**
    * Get total count of available models
    */
-  async getModelsCount(
+  async listModelsCount(
     options?: RequestOptions,
-  ): Promise<operations.GetModelsCountResponse> {
-    return unwrapAsync(modelsGetModelsCount(
+  ): Promise<operations.ListModelsCountResponse> {
+    return unwrapAsync(modelsListModelsCount(
       this,
       options,
     ));
@@ -31,8 +26,8 @@ export class Models extends ClientSDK {
    * List all models and their properties
    */
   async getModels(
-    request?: operations.GetModelsRequestRequest | undefined,
-    options?: RequestOptions & { acceptHeaderOverride?: GetModelsAcceptEnum },
+    request?: operations.GetModelsRequest | undefined,
+    options?: RequestOptions,
   ): Promise<operations.GetModelsResponse> {
     return unwrapAsync(modelsGetModels(
       this,
@@ -44,11 +39,11 @@ export class Models extends ClientSDK {
   /**
    * List models filtered by user provider preferences
    */
-  async getModelsUser(
-    security: operations.GetModelsUserSecurity,
+  async listModelsUser(
+    security: operations.ListModelsUserSecurity,
     options?: RequestOptions,
-  ): Promise<operations.GetModelsUserResponse> {
-    return unwrapAsync(modelsGetModelsUser(
+  ): Promise<operations.ListModelsUserResponse> {
+    return unwrapAsync(modelsListModelsUser(
       this,
       security,
       options,

package/src/sdk/parameters.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { parametersGetParameters } from "../funcs/parametersGetParameters.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class ParametersT extends ClientSDK {
+  /**
+   * Get a model's supported parameters and data about which are most popular
+   */
+  async getParameters(
+    security: operations.GetParametersSecurity,
+    request: operations.GetParametersRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetParametersResponse> {
+    return unwrapAsync(parametersGetParameters(
+      this,
+      security,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/providers.ts

@@ -2,19 +2,19 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { providersGetProviders } from "../funcs/providersGetProviders.js";
+import { providersList } from "../funcs/providersList.js";
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "../models/operations/index.js";
 import { unwrapAsync } from "../types/fp.js";
 
 export class Providers extends ClientSDK {
   /**
-   * List all available model providers
+   * List all providers
    */
-  async getProviders(
+  async list(
     options?: RequestOptions,
-  ): Promise<operations.GetProvidersResponse> {
-    return unwrapAsync(providersGetProviders(
+  ): Promise<operations.ListProvidersResponse> {
+    return unwrapAsync(providersList(
       this,
       options,
     ));

package/src/sdk/responses.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { betaResponsesSend } from "../funcs/betaResponsesSend.js";
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+
+export class Responses extends ClientSDK {
+  /**
+   * Create a response
+   *
+   * @remarks
+   * Creates a streaming or non-streaming response using OpenResponses API format
+   */
+  async send(
+    request: models.OpenResponsesRequest,
+    options?: RequestOptions,
+  ): Promise<operations.CreateApiAlphaResponsesResponse> {
+    return unwrapAsync(betaResponsesSend(
+      this,
+      request,
+      options,
+    ));
+  }
+}

package/src/sdk/sdk.ts

@@ -5,18 +5,22 @@
 import { ClientSDK } from "../lib/sdks.js";
 import { Analytics } from "./analytics.js";
 import { APIKeys } from "./apikeys.js";
+import { Beta } from "./beta.js";
 import { Chat } from "./chat.js";
 import { Completions } from "./completions.js";
 import { Credits } from "./credits.js";
-import { Embeddings } from "./embeddings.js";
 import { Endpoints } from "./endpoints.js";
 import { Generations } from "./generations.js";
-import { Model } from "./model.js";
 import { Models } from "./models.js";
-import { OAuth } from "./oauth.js";
+import { ParametersT } from "./parameters.js";
 import { Providers } from "./providers.js";
 
 export class OpenRouter extends ClientSDK {
+  private _beta?: Beta;
+  get beta(): Beta {
+    return (this._beta ??= new Beta(this._options));
+  }
+
   private _analytics?: Analytics;
   get analytics(): Analytics {
     return (this._analytics ??= new Analytics(this._options));
@@ -27,11 +31,6 @@ export class OpenRouter extends ClientSDK {
     return (this._credits ??= new Credits(this._options));
   }
 
-  private _embeddings?: Embeddings;
-  get embeddings(): Embeddings {
-    return (this._embeddings ??= new Embeddings(this._options));
-  }
-
   private _generations?: Generations;
   get generations(): Generations {
     return (this._generations ??= new Generations(this._options));
@@ -47,9 +46,9 @@ export class OpenRouter extends ClientSDK {
     return (this._endpoints ??= new Endpoints(this._options));
   }
 
-  private _model?: Model;
-  get model(): Model {
-    return (this._model ??= new Model(this._options));
+  private _parameters?: ParametersT;
+  get parameters(): ParametersT {
+    return (this._parameters ??= new ParametersT(this._options));
   }
 
   private _providers?: Providers;
@@ -62,11 +61,6 @@ export class OpenRouter extends ClientSDK {
     return (this._apiKeys ??= new APIKeys(this._options));
   }
 
-  private _oAuth?: OAuth;
-  get oAuth(): OAuth {
-    return (this._oAuth ??= new OAuth(this._options));
-  }
-
   private _chat?: Chat;
   get chat(): Chat {
     return (this._chat ??= new Chat(this._options));

package/tests/funcs/oAuthCreateAuthorizationUrl.test.ts

@@ -0,0 +1,265 @@
+import { describe, it, expect } from "vitest";
+import { OpenRouterCore } from "../../src/core";
+import { oAuthCreateAuthorizationUrl } from "../../src/funcs/oAuthCreateAuthorizationUrl";
+
+describe("oAuthCreateAuthorizationUrl", () => {
+  const createMockClient = (serverURL?: string) => {
+    return new OpenRouterCore({ serverURL });
+  };
+
+  it("should generate authorization URL with callback URL", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("callback_url")).toBe(
+        "https://example.com/callback",
+      );
+    }
+  });
+
+  it("should generate authorization URL with URL object as callback", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const callbackUrl = new URL("https://example.com/callback");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl,
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("callback_url")).toBe(
+        "https://example.com/callback",
+      );
+    }
+  });
+
+  it("should include code challenge with S256 method", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback",
+      codeChallenge: "test-code-challenge-abc123",
+      codeChallengeMethod: "S256",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("code_challenge")).toBe(
+        "test-code-challenge-abc123",
+      );
+      expect(url.searchParams.get("code_challenge_method")).toBe("S256");
+    }
+  });
+
+  it("should include code challenge with plain method", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback",
+      codeChallenge: "plain-code-challenge",
+      codeChallengeMethod: "plain",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("code_challenge")).toBe(
+        "plain-code-challenge",
+      );
+      expect(url.searchParams.get("code_challenge_method")).toBe("plain");
+    }
+  });
+
+  it("should include limit parameter when provided", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback",
+      limit: 100,
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("limit")).toBe("100");
+    }
+  });
+
+  it("should handle callback URL with query parameters", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback?state=abc123&redirect=true",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("callback_url")).toBe(
+        "https://example.com/callback?state=abc123&redirect=true",
+      );
+    }
+  });
+
+  it("should handle callback URL with special characters", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback?data=hello%20world",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("callback_url")).toBe(
+        "https://example.com/callback?data=hello%20world",
+      );
+    }
+  });
+
+  it("should return error for invalid callback URL string", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "not-a-valid-url" as any,
+    });
+
+    expect(result.ok).toBe(false);
+    if (!result.ok) {
+      expect(result.error).toBeDefined();
+    }
+  });
+
+  it("should handle callback URL with localhost", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "http://localhost:3000/callback",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("callback_url")).toBe(
+        "http://localhost:3000/callback",
+      );
+    }
+  });
+
+  it("should use default production server when no serverURL provided", () => {
+    const client = createMockClient();
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.origin).toBe("https://openrouter.ai");
+      expect(url.pathname).toBe("/auth");
+    }
+  });
+
+  it("should use custom server URL when provided", () => {
+    const client = createMockClient("https://custom.example.com/api");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.origin).toBe("https://custom.example.com");
+      expect(url.pathname).toBe("/auth");
+    }
+  });
+
+  it("should preserve all parameters with PKCE", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback?state=xyz",
+      codeChallenge: "challenge123",
+      codeChallengeMethod: "S256",
+      limit: 50,
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("callback_url")).toBe(
+        "https://example.com/callback?state=xyz",
+      );
+      expect(url.searchParams.get("code_challenge")).toBe("challenge123");
+      expect(url.searchParams.get("code_challenge_method")).toBe("S256");
+      expect(url.searchParams.get("limit")).toBe("50");
+    }
+  });
+
+  it("should handle callback URL with fragment", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback#section",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("callback_url")).toBe(
+        "https://example.com/callback#section",
+      );
+    }
+  });
+
+  it("should return error for invalid input types", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: 12345 as any,
+    });
+
+    expect(result.ok).toBe(false);
+    if (!result.ok) {
+      expect(result.error).toBeDefined();
+    }
+  });
+
+  it("should handle URL with port number in callback", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com:8443/callback",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("callback_url")).toBe(
+        "https://example.com:8443/callback",
+      );
+    }
+  });
+
+  it("should not omit limit parameter when value is 0", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback",
+      limit: 0,
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.get("limit")).toBe("0");
+    }
+  });
+
+  it("should omit limit parameter when not provided", () => {
+    const client = createMockClient("https://openrouter.ai/api/v1");
+    const result = oAuthCreateAuthorizationUrl(client, {
+      callbackUrl: "https://example.com/callback",
+    });
+
+    expect(result.ok).toBe(true);
+    if (result.ok) {
+      const url = new URL(result.value);
+      expect(url.searchParams.has("limit")).toBe(false);
+    }
+  });
+});