@openrouter/sdk 0.0.0-beta.38 → 0.0.0-beta.39

package/dist/esm/models/responsetextverbosity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"responsetextverbosity.d.ts","sourceRoot":"","sources":["../../../src/models/responsetextverbosity.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC;AACX,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7E,gBAAgB;AAChB,eAAO,MAAM,mCAAmC,EAAE,CAAC,CAAC,aAAa,CAC/D,OAAO,qBAAqB,CACS,CAAC;AAExC,gBAAgB;AAChB,eAAO,MAAM,oCAAoC,EAAE,CAAC,CAAC,aAAa,CAChE,OAAO,qBAAqB,CACS,CAAC;AAExC;;;GAGG;AACH,yBAAiB,sBAAsB,CAAC;IACtC,qEAAqE;IAC9D,MAAM,aAAa;;;;MAAsC,CAAC;IACjE,sEAAsE;IAC/D,MAAM,cAAc;;;;MAAuC,CAAC;CACpE"}
+{"version":3,"file":"responsetextverbosity.d.ts","sourceRoot":"","sources":["../../../src/models/responsetextverbosity.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAEL,QAAQ,EAET,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC;AACX,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE3E,gBAAgB;AAChB,eAAO,MAAM,mCAAmC,EAAE,CAAC,CAAC,OAAO,CACzD,qBAAqB,EACrB,CAAC,CAAC,UAAU,EACZ,OAAO,CAKL,CAAC;AAEL,gBAAgB;AAChB,eAAO,MAAM,oCAAoC,EAAE,CAAC,CAAC,OAAO,CAC1D,qBAAqB,EACrB,CAAC,CAAC,UAAU,EACZ,qBAAqB,CAIrB,CAAC;AAEH;;;GAGG;AACH,yBAAiB,sBAAsB,CAAC;IACtC,qEAAqE;IAC9D,MAAM,aAAa,yDAAsC,CAAC;IACjE,sEAAsE;IAC/D,MAAM,cAAc,uEAAuC,CAAC;CACpE"}

package/dist/esm/models/responsetextverbosity.js

@@ -2,15 +2,23 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 import * as z from "zod";
+import { catchUnrecognizedEnum, } from "../types/enums.js";
 export const ResponseTextVerbosity = {
     High: "high",
     Low: "low",
     Medium: "medium",
 };
 /** @internal */
-export const ResponseTextVerbosity$inboundSchema = z.nativeEnum(ResponseTextVerbosity);
+export const ResponseTextVerbosity$inboundSchema = z
+    .union([
+    z.nativeEnum(ResponseTextVerbosity),
+    z.string().transform(catchUnrecognizedEnum),
+]);
 /** @internal */
-export const ResponseTextVerbosity$outboundSchema = ResponseTextVerbosity$inboundSchema;
+export const ResponseTextVerbosity$outboundSchema = z.union([
+    z.nativeEnum(ResponseTextVerbosity),
+    z.string().and(z.custom()),
+]);
 /**
  * @internal
  * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.

package/dist/esm/models/responsetextverbosity.js.map

@@ -1 +1 @@
-{"version":3,"file":"responsetextverbosity.js","sourceRoot":"","sources":["../../../src/models/responsetextverbosity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;CACR,CAAC;AAGX,gBAAgB;AAChB,MAAM,CAAC,MAAM,mCAAmC,GAE5C,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;AAExC,gBAAgB;AAChB,MAAM,CAAC,MAAM,oCAAoC,GAE7C,mCAAmC,CAAC;AAExC;;;GAGG;AACH,MAAM,KAAW,sBAAsB,CAKtC;AALD,WAAiB,sBAAsB;IACrC,qEAAqE;IACxD,oCAAa,GAAG,mCAAmC,CAAC;IACjE,sEAAsE;IACzD,qCAAc,GAAG,oCAAoC,CAAC;AACrE,CAAC,EALgB,sBAAsB,KAAtB,sBAAsB,QAKtC"}
+{"version":3,"file":"responsetextverbosity.js","sourceRoot":"","sources":["../../../src/models/responsetextverbosity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EACL,qBAAqB,GAGtB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;CACR,CAAC;AAGX,gBAAgB;AAChB,MAAM,CAAC,MAAM,mCAAmC,GAI5C,CAAC;KACF,KAAK,CAAC;IACL,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC;IACnC,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,qBAAqB,CAAC;CAC5C,CAAC,CAAC;AAEL,gBAAgB;AAChB,MAAM,CAAC,MAAM,oCAAoC,GAI7C,CAAC,CAAC,KAAK,CAAC;IACV,CAAC,CAAC,UAAU,CAAC,qBAAqB,CAAC;IACnC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAwB,CAAC;CACjD,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,KAAW,sBAAsB,CAKtC;AALD,WAAiB,sBAAsB;IACrC,qEAAqE;IACxD,oCAAa,GAAG,mCAAmC,CAAC;IACjE,sEAAsE;IACzD,qCAAc,GAAG,oCAAoC,CAAC;AACrE,CAAC,EALgB,sBAAsB,KAAtB,sBAAsB,QAKtC"}

package/dist/esm/sdk/oauth.d.ts

@@ -1,6 +1,33 @@
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as operations from "../models/operations/index.js";
+import { CreateAuthorizationUrlRequest } from "../funcs/custom/oAuthCreateAuthorizationUrl.js";
+import { CreateSHA256CodeChallengeRequest, CreateSHA256CodeChallengeResponse } from "../funcs/custom/oAuthCreateSHA256CodeChallenge.js";
 export declare class OAuth extends ClientSDK {
+    /**
+     * Generate a OAuth2 authorization URL
+     *
+     * @remarks
+     * Generates a URL to redirect users to for authorizing your application. The
+     * URL includes the provided callback URL and, if applicable, the code
+     * challenge parameters for PKCE.
+     *
+     * @see {@link https://openrouter.ai/docs/use-cases/oauth-pkce}
+     */
+    createAuthorizationUrl(request: CreateAuthorizationUrlRequest): Promise<string>;
+    /**
+     * Generate a SHA-256 code challenge for PKCE
+     *
+     * @remarks
+     * Generates a SHA-256 code challenge and corresponding code verifier for use
+     * in the PKCE extension to OAuth2. If no code verifier is provided, a random
+     * one will be generated according to RFC 7636 (32 random bytes, base64url
+     * encoded). If a code verifier is provided, it must be 43-128 characters and
+     * contain only unreserved characters [A-Za-z0-9-._~].
+     *
+     * @see {@link https://openrouter.ai/docs/use-cases/oauth-pkce}
+     * @see {@link https://datatracker.ietf.org/doc/html/rfc7636}
+     */
+    createSHA256CodeChallenge(request?: CreateSHA256CodeChallengeRequest): Promise<CreateSHA256CodeChallengeResponse>;
     /**
      * Exchange authorization code for API key
      *

package/dist/esm/sdk/oauth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../src/sdk/oauth.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAG5D,qBAAa,KAAM,SAAQ,SAAS;IAClC;;;;;OAKG;IACG,yBAAyB,CAC7B,OAAO,EAAE,UAAU,CAAC,gCAAgC,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,iCAAiC,CAAC;IAQxD;;;;;OAKG;IACG,uBAAuB,CAC3B,OAAO,EAAE,UAAU,CAAC,8BAA8B,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,+BAA+B,CAAC;CAOvD"}
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../src/sdk/oauth.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAG5D,OAAO,EACL,6BAA6B,EAE9B,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,gCAAgC,EAChC,iCAAiC,EAElC,MAAM,mDAAmD,CAAC;AAG3D,qBAAa,KAAM,SAAQ,SAAS;IAElC;;;;;;;;;OASG;IACG,sBAAsB,CAC1B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC;IAUlB;;;;;;;;;;;;OAYG;IACG,yBAAyB,CAC7B,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,iCAAiC,CAAC;IAW7C;;;;;OAKG;IACG,yBAAyB,CAC7B,OAAO,EAAE,UAAU,CAAC,gCAAgC,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,iCAAiC,CAAC;IAQxD;;;;;OAKG;IACG,uBAAuB,CAC3B,OAAO,EAAE,UAAU,CAAC,8BAA8B,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,+BAA+B,CAAC;CAOvD"}

package/dist/esm/sdk/oauth.js

@@ -5,7 +5,50 @@ import { oAuthCreateAuthorizationCode } from "../funcs/oAuthCreateAuthorizationC
 import { oAuthExchangeAuthorizationCode } from "../funcs/oAuthExchangeAuthorizationCode.js";
 import { ClientSDK } from "../lib/sdks.js";
 import { unwrapAsync } from "../types/fp.js";
+// #region imports
+import { oAuthCreateAuthorizationUrl, } from "../funcs/custom/oAuthCreateAuthorizationUrl.js";
+import { oAuthCreateSHA256CodeChallenge, } from "../funcs/custom/oAuthCreateSHA256CodeChallenge.js";
+// #endregion imports
 export class OAuth extends ClientSDK {
+    // #region sdk-class-body
+    /**
+     * Generate a OAuth2 authorization URL
+     *
+     * @remarks
+     * Generates a URL to redirect users to for authorizing your application. The
+     * URL includes the provided callback URL and, if applicable, the code
+     * challenge parameters for PKCE.
+     *
+     * @see {@link https://openrouter.ai/docs/use-cases/oauth-pkce}
+     */
+    async createAuthorizationUrl(request) {
+        const result = oAuthCreateAuthorizationUrl(this, request);
+        if (!result.ok) {
+            throw result.error;
+        }
+        return result.value;
+    }
+    /**
+     * Generate a SHA-256 code challenge for PKCE
+     *
+     * @remarks
+     * Generates a SHA-256 code challenge and corresponding code verifier for use
+     * in the PKCE extension to OAuth2. If no code verifier is provided, a random
+     * one will be generated according to RFC 7636 (32 random bytes, base64url
+     * encoded). If a code verifier is provided, it must be 43-128 characters and
+     * contain only unreserved characters [A-Za-z0-9-._~].
+     *
+     * @see {@link https://openrouter.ai/docs/use-cases/oauth-pkce}
+     * @see {@link https://datatracker.ietf.org/doc/html/rfc7636}
+     */
+    async createSHA256CodeChallenge(request = {}) {
+        const result = await oAuthCreateSHA256CodeChallenge(request);
+        if (!result.ok) {
+            throw result.error;
+        }
+        return result.value;
+    }
+    // #endregion sdk-class-body
     /**
      * Exchange authorization code for API key
      *

package/dist/esm/sdk/oauth.js.map

@@ -1 +1 @@
-{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../../src/sdk/oauth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,OAAO,KAAM,SAAQ,SAAS;IAClC;;;;;OAKG;IACH,KAAK,CAAC,yBAAyB,CAC7B,OAAoD,EACpD,OAAwB;QAExB,OAAO,WAAW,CAAC,8BAA8B,CAC/C,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,uBAAuB,CAC3B,OAAkD,EAClD,OAAwB;QAExB,OAAO,WAAW,CAAC,4BAA4B,CAC7C,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../../src/sdk/oauth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,kBAAkB;AAClB,OAAO,EAEL,2BAA2B,GAC5B,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAGL,8BAA8B,GAC/B,MAAM,mDAAmD,CAAC;AAC3D,qBAAqB;AAErB,MAAM,OAAO,KAAM,SAAQ,SAAS;IAClC,yBAAyB;IACzB;;;;;;;;;OASG;IACH,KAAK,CAAC,sBAAsB,CAC1B,OAAsC;QAEtC,MAAM,MAAM,GAAG,2BAA2B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE1D,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,MAAM,CAAC,KAAK,CAAC;QACrB,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,yBAAyB,CAC7B,UAA4C,EAAE;QAE9C,MAAM,MAAM,GAAG,MAAM,8BAA8B,CAAC,OAAO,CAAC,CAAC;QAE7D,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,MAAM,CAAC,KAAK,CAAC;QACrB,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,4BAA4B;IAE5B;;;;;OAKG;IACH,KAAK,CAAC,yBAAyB,CAC7B,OAAoD,EACpD,OAAwB;QAExB,OAAO,WAAW,CAAC,8BAA8B,CAC/C,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,uBAAuB,CAC3B,OAAkD,EAClD,OAAwB;QAExB,OAAO,WAAW,CAAC,4BAA4B,CAC7C,IAAI,EACJ,OAAO,EACP,OAAO,CACR,CAAC,CAAC;IACL,CAAC;CACF"}

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "0.0.0-beta.38",
+  "version": "0.0.0-beta.39",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.0.0-beta.38",
+  "version": "0.0.0-beta.39",
   "author": "OpenRouter",
   "type": "module",
   "tshy": {
@@ -53,7 +53,8 @@
     "globals": "^15.14.0",
     "tshy": "^2.0.0",
     "typescript": "~5.8.3",
-    "typescript-eslint": "^8.26.0"
+    "typescript-eslint": "^8.26.0",
+    "vitest": "^3.2.4"
   },
   "dependencies": {
     "zod": "^3.20.0"

package/src/funcs/betaResponsesSend.ts

@@ -149,7 +149,7 @@ async function $do(
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
-    Accept: "application/json;q=1",
+    Accept: request?.stream ? "text/event-stream" : "application/json",
   }));
 
   const secConfig = await extractSecurity(client._options.apiKey);

package/src/funcs/chatSend.ts

@@ -148,7 +148,7 @@ async function $do(
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
-    Accept: "application/json;q=1",
+    Accept: request?.stream ? "text/event-stream" : "application/json",
   }));
 
   const secConfig = await extractSecurity(client._options.apiKey);

package/src/funcs/custom/oAuthCreateAuthorizationUrl.test.ts

@@ -0,0 +1,265 @@
+import { describe, it, expect } from "vitest";
+import { OpenRouterCore } from "../../core.js";
+import { oAuthCreateAuthorizationUrl } from "./oAuthCreateAuthorizationUrl.js";
+
+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);
+    }
+  });
+});

package/src/funcs/custom/oAuthCreateAuthorizationUrl.ts

@@ -0,0 +1,66 @@
+import z from "zod/v3";
+import { OpenRouterCore } from "../../core.js";
+import { serverURLFromOptions } from "../../lib/config.js";
+import { Result } from "../../types/fp.js";
+
+const CreateAuthorizationUrlBaseSchema = z.object({
+  callbackUrl: z.union([z.string().url(), z.instanceof(URL)]),
+  limit: z.number().optional(),
+});
+
+const CreateAuthorizationurlParamsSchema = z.union([
+  CreateAuthorizationUrlBaseSchema.extend({
+    codeChallengeMethod: z.enum(["S256", "plain"]),
+    codeChallenge: z.string(),
+  }),
+  CreateAuthorizationUrlBaseSchema,
+]);
+
+export type CreateAuthorizationUrlRequest = z.infer<
+  typeof CreateAuthorizationurlParamsSchema
+>;
+
+/**
+ * Generate a OAuth2 authorization URL
+ *
+ * @remarks
+ * Generates a URL to redirect users to for authorizing your application. The
+ * URL includes the provided callback URL and, if applicable, the code
+ * challenge parameters for PKCE.
+ *
+ * @see {@link https://openrouter.ai/docs/use-cases/oauth-pkce}
+ */
+export function oAuthCreateAuthorizationUrl(
+  client: OpenRouterCore,
+  params: CreateAuthorizationUrlRequest,
+): Result<string> {
+  const parsedParams = CreateAuthorizationurlParamsSchema.safeParse(params);
+  if (!parsedParams.success) return { ok: false, error: parsedParams.error };
+
+  const baseURL = serverURLFromOptions(client._options);
+  if (!baseURL) {
+    return { ok: false, error: new Error("No server URL configured") };
+  }
+
+  // Clone the URL to avoid mutating the original
+  const authURL = new URL("/auth", baseURL);
+
+  authURL.searchParams.set(
+    "callback_url",
+    parsedParams.data.callbackUrl.toString(),
+  );
+
+  if ("codeChallengeMethod" in parsedParams.data) {
+    authURL.searchParams.set("code_challenge", parsedParams.data.codeChallenge);
+    authURL.searchParams.set(
+      "code_challenge_method",
+      parsedParams.data.codeChallengeMethod,
+    );
+  }
+
+  if (parsedParams.data.limit !== undefined) {
+    authURL.searchParams.set("limit", parsedParams.data.limit.toString());
+  }
+
+  return { ok: true, value: authURL.toString() };
+}