@openrouter/sdk 0.0.1-beta.12 → 0.0.1-beta.16

package/esm/react-query/oAuthExchangeAuthCodeForAPIKey.d.ts

@@ -0,0 +1,23 @@
+import { MutationKey, UseMutationResult } from "@tanstack/react-query";
+import { OpenRouterCore } from "../core.js";
+import { RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { MutationHookOptions } from "./_types.js";
+export type OAuthExchangeAuthCodeForAPIKeyMutationVariables = {
+    request: operations.ExchangeAuthCodeForAPIKeyRequest;
+    options?: RequestOptions;
+};
+export type OAuthExchangeAuthCodeForAPIKeyMutationData = operations.ExchangeAuthCodeForAPIKeyResponse;
+/**
+ * Exchange authorization code for API key
+ *
+ * @remarks
+ * Exchange an authorization code from the PKCE flow for a user-controlled API key
+ */
+export declare function useOAuthExchangeAuthCodeForAPIKeyMutation(options?: MutationHookOptions<OAuthExchangeAuthCodeForAPIKeyMutationData, Error, OAuthExchangeAuthCodeForAPIKeyMutationVariables>): UseMutationResult<OAuthExchangeAuthCodeForAPIKeyMutationData, Error, OAuthExchangeAuthCodeForAPIKeyMutationVariables>;
+export declare function mutationKeyOAuthExchangeAuthCodeForAPIKey(): MutationKey;
+export declare function buildOAuthExchangeAuthCodeForAPIKeyMutation(client$: OpenRouterCore, hookOptions?: RequestOptions): {
+    mutationKey: MutationKey;
+    mutationFn: (variables: OAuthExchangeAuthCodeForAPIKeyMutationVariables) => Promise<OAuthExchangeAuthCodeForAPIKeyMutationData>;
+};
+//# sourceMappingURL=oAuthExchangeAuthCodeForAPIKey.d.ts.map

package/esm/react-query/oAuthExchangeAuthCodeForAPIKey.js

@@ -0,0 +1,42 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { useMutation, } from "@tanstack/react-query";
+import { oAuthExchangeAuthCodeForAPIKey } from "../funcs/oAuthExchangeAuthCodeForAPIKey.js";
+import { combineSignals } from "../lib/primitives.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useOpenRouterContext } from "./_context.js";
+/**
+ * Exchange authorization code for API key
+ *
+ * @remarks
+ * Exchange an authorization code from the PKCE flow for a user-controlled API key
+ */
+export function useOAuthExchangeAuthCodeForAPIKeyMutation(options) {
+    const client = useOpenRouterContext();
+    return useMutation({
+        ...buildOAuthExchangeAuthCodeForAPIKeyMutation(client, options),
+        ...options,
+    });
+}
+export function mutationKeyOAuthExchangeAuthCodeForAPIKey() {
+    return ["@openrouter/sdk", "OAuth", "exchangeAuthCodeForAPIKey"];
+}
+export function buildOAuthExchangeAuthCodeForAPIKeyMutation(client$, hookOptions) {
+    return {
+        mutationKey: mutationKeyOAuthExchangeAuthCodeForAPIKey(),
+        mutationFn: function oAuthExchangeAuthCodeForAPIKeyMutationFn({ request, options, }) {
+            const mergedOptions = {
+                ...hookOptions,
+                ...options,
+                fetchOptions: {
+                    ...hookOptions?.fetchOptions,
+                    ...options?.fetchOptions,
+                    signal: combineSignals(hookOptions?.fetchOptions?.signal, options?.fetchOptions?.signal),
+                },
+            };
+            return unwrapAsync(oAuthExchangeAuthCodeForAPIKey(client$, request, mergedOptions));
+        },
+    };
+}
+//# sourceMappingURL=oAuthExchangeAuthCodeForAPIKey.js.map

package/esm/sdk/chat.d.ts

@@ -14,7 +14,7 @@ export declare class Chat extends ClientSDK {
     }, options?: RequestOptions): Promise<models.ChatResponse>;
     send(request: models.ChatGenerationParams & {
         stream: true;
-    }, options?: RequestOptions): Promise<EventStream<models.ChatStreamingResponseChunk>>;
+    }, options?: RequestOptions): Promise<EventStream<models.ChatStreamingResponseChunkData>>;
     send(request: models.ChatGenerationParams, options?: RequestOptions): Promise<operations.SendChatCompletionRequestResponse>;
 }
 //# sourceMappingURL=chat.d.ts.map

package/esm/sdk/models.d.ts

@@ -9,7 +9,7 @@ export declare class Models extends ClientSDK {
     /**
      * List all models and their properties
      */
-    list(request?: operations.GetModelsRequest | undefined, options?: RequestOptions): Promise<operations.GetModelsResponse>;
+    list(request?: operations.GetModelsRequest | undefined, options?: RequestOptions): Promise<models.ModelsListResponse>;
     /**
      * List models filtered by user provider preferences
      */

package/esm/sdk/oauth.d.ts

@@ -0,0 +1,46 @@
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+import { CreateAuthorizationUrlRequest } from "../funcs/oAuthCreateAuthorizationUrl.js";
+import { CreateSHA256CodeChallengeResponse } from "../funcs/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(): Promise<CreateSHA256CodeChallengeResponse>;
+    /**
+     * Exchange authorization code for API key
+     *
+     * @remarks
+     * Exchange an authorization code from the PKCE flow for a user-controlled API key
+     */
+    exchangeAuthCodeForAPIKey(request: operations.ExchangeAuthCodeForAPIKeyRequest, options?: RequestOptions): Promise<operations.ExchangeAuthCodeForAPIKeyResponse>;
+    /**
+     * Create authorization code
+     *
+     * @remarks
+     * Create an authorization code for the PKCE flow to generate a user-controlled API key
+     */
+    createAuthCode(request: operations.CreateAuthKeysCodeRequest, options?: RequestOptions): Promise<operations.CreateAuthKeysCodeResponse>;
+}
+//# sourceMappingURL=oauth.d.ts.map

package/esm/sdk/oauth.js

@@ -0,0 +1,67 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { oAuthCreateAuthCode } from "../funcs/oAuthCreateAuthCode.js";
+import { oAuthExchangeAuthCodeForAPIKey } from "../funcs/oAuthExchangeAuthCodeForAPIKey.js";
+import { ClientSDK } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+// #region imports
+import { oAuthCreateAuthorizationUrl, } from "../funcs/oAuthCreateAuthorizationUrl.js";
+import { oAuthCreateSHA256CodeChallenge, } from "../funcs/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() {
+        return unwrapAsync(oAuthCreateSHA256CodeChallenge());
+    }
+    // #endregion sdk-class-body
+    /**
+     * Exchange authorization code for API key
+     *
+     * @remarks
+     * Exchange an authorization code from the PKCE flow for a user-controlled API key
+     */
+    async exchangeAuthCodeForAPIKey(request, options) {
+        return unwrapAsync(oAuthExchangeAuthCodeForAPIKey(this, request, options));
+    }
+    /**
+     * Create authorization code
+     *
+     * @remarks
+     * Create an authorization code for the PKCE flow to generate a user-controlled API key
+     */
+    async createAuthCode(request, options) {
+        return unwrapAsync(oAuthCreateAuthCode(this, request, options));
+    }
+}
+//# sourceMappingURL=oauth.js.map

package/esm/sdk/responses.d.ts

@@ -14,7 +14,7 @@ export declare class Responses extends ClientSDK {
     }, options?: RequestOptions): Promise<models.OpenResponsesNonStreamingResponse>;
     send(request: models.OpenResponsesRequest & {
         stream: true;
-    }, options?: RequestOptions): Promise<EventStream<operations.CreateApiAlphaResponsesResponseBody>>;
-    send(request: models.OpenResponsesRequest, options?: RequestOptions): Promise<operations.CreateApiAlphaResponsesResponse>;
+    }, options?: RequestOptions): Promise<EventStream<models.OpenResponsesStreamEvent>>;
+    send(request: models.OpenResponsesRequest, options?: RequestOptions): Promise<operations.CreateResponsesResponse>;
 }
 //# sourceMappingURL=responses.d.ts.map

package/esm/sdk/sdk.d.ts

@@ -8,6 +8,7 @@ import { Credits } from "./credits.js";
 import { Endpoints } from "./endpoints.js";
 import { Generations } from "./generations.js";
 import { Models } from "./models.js";
+import { OAuth } from "./oauth.js";
 import { ParametersT } from "./parameters.js";
 import { Providers } from "./providers.js";
 export declare class OpenRouter extends ClientSDK {
@@ -29,6 +30,8 @@ export declare class OpenRouter extends ClientSDK {
     get providers(): Providers;
     private _apiKeys?;
     get apiKeys(): APIKeys;
+    private _oAuth?;
+    get oAuth(): OAuth;
     private _chat?;
     get chat(): Chat;
     private _completions?;

package/esm/sdk/sdk.js

@@ -11,6 +11,7 @@ import { Credits } from "./credits.js";
 import { Endpoints } from "./endpoints.js";
 import { Generations } from "./generations.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 {
@@ -41,6 +42,9 @@ export class OpenRouter extends ClientSDK {
     get apiKeys() {
         return (this._apiKeys ?? (this._apiKeys = new APIKeys(this._options)));
     }
+    get oAuth() {
+        return (this._oAuth ?? (this._oAuth = new OAuth(this._options)));
+    }
     get chat() {
         return (this._chat ?? (this._chat = new Chat(this._options)));
     }

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "0.0.1-beta.12",
+  "version": "0.0.1-beta.16",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.0.1-beta.12",
+  "version": "0.0.1-beta.16",
   "author": "OpenRouter",
   "type": "module",
   "main": "./esm/index.js",
@@ -70,7 +70,9 @@
   "devDependencies": {
     "@eslint/js": "^9.19.0",
     "@tanstack/react-query": "^5.61.4",
+    "@types/node": "^22.13.12",
     "@types/react": "^18.3.12",
+    "dotenv": "^16.4.7",
     "eslint": "^9.19.0",
     "globals": "^15.14.0",
     "typescript": "~5.8.3",

package/vitest.config.ts

@@ -1,10 +1,25 @@
+import { config } from "dotenv";
 import { defineConfig } from "vitest/config";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Load environment variables from .env file if it exists
+// This will not override existing environment variables
+config({ path: join(__dirname, ".env") });
 
 export default defineConfig({
   test: {
     globals: true,
     environment: "node",
-    testMatch: ["**/*.test.ts"],
+    // Don't override env vars - just let them pass through from the system
+    // The env object here will be merged with process.env
+    env: {
+      OPENROUTER_API_KEY: process.env.OPENROUTER_API_KEY,
+    },
+    include: ["tests/**/*.test.ts"],
     hookTimeout: 30000,
     testTimeout: 30000,
   },

package/esm/models/operations/createapialpharesponses.d.ts

@@ -1,58 +0,0 @@
-import * as z from "zod/v4";
-import { EventStream } from "../../lib/event-streams.js";
-import { Result as SafeParseResult } from "../../types/fp.js";
-import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-import * as models from "../index.js";
-/**
- * Successful response
- */
-export type CreateApiAlphaResponsesResponseBody = {
-    /**
-     * Union of all possible event types emitted during response streaming
-     */
-    data: models.OpenResponsesStreamEvent;
-};
-export type CreateApiAlphaResponsesResponse = models.OpenResponsesNonStreamingResponse | EventStream<CreateApiAlphaResponsesResponseBody>;
-/** @internal */
-export declare const CreateApiAlphaResponsesResponseBody$inboundSchema: z.ZodType<CreateApiAlphaResponsesResponseBody, unknown>;
-/** @internal */
-export type CreateApiAlphaResponsesResponseBody$Outbound = {
-    data: models.OpenResponsesStreamEvent$Outbound;
-};
-/** @internal */
-export declare const CreateApiAlphaResponsesResponseBody$outboundSchema: z.ZodType<CreateApiAlphaResponsesResponseBody$Outbound, CreateApiAlphaResponsesResponseBody>;
-/**
- * @internal
- * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
- */
-export declare namespace CreateApiAlphaResponsesResponseBody$ {
-    /** @deprecated use `CreateApiAlphaResponsesResponseBody$inboundSchema` instead. */
-    const inboundSchema: z.ZodType<CreateApiAlphaResponsesResponseBody, unknown, z.core.$ZodTypeInternals<CreateApiAlphaResponsesResponseBody, unknown>>;
-    /** @deprecated use `CreateApiAlphaResponsesResponseBody$outboundSchema` instead. */
-    const outboundSchema: z.ZodType<CreateApiAlphaResponsesResponseBody$Outbound, CreateApiAlphaResponsesResponseBody, z.core.$ZodTypeInternals<CreateApiAlphaResponsesResponseBody$Outbound, CreateApiAlphaResponsesResponseBody>>;
-    /** @deprecated use `CreateApiAlphaResponsesResponseBody$Outbound` instead. */
-    type Outbound = CreateApiAlphaResponsesResponseBody$Outbound;
-}
-export declare function createApiAlphaResponsesResponseBodyToJSON(createApiAlphaResponsesResponseBody: CreateApiAlphaResponsesResponseBody): string;
-export declare function createApiAlphaResponsesResponseBodyFromJSON(jsonString: string): SafeParseResult<CreateApiAlphaResponsesResponseBody, SDKValidationError>;
-/** @internal */
-export declare const CreateApiAlphaResponsesResponse$inboundSchema: z.ZodType<CreateApiAlphaResponsesResponse, unknown>;
-/** @internal */
-export type CreateApiAlphaResponsesResponse$Outbound = models.OpenResponsesNonStreamingResponse$Outbound | never;
-/** @internal */
-export declare const CreateApiAlphaResponsesResponse$outboundSchema: z.ZodType<CreateApiAlphaResponsesResponse$Outbound, CreateApiAlphaResponsesResponse>;
-/**
- * @internal
- * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
- */
-export declare namespace CreateApiAlphaResponsesResponse$ {
-    /** @deprecated use `CreateApiAlphaResponsesResponse$inboundSchema` instead. */
-    const inboundSchema: z.ZodType<CreateApiAlphaResponsesResponse, unknown, z.core.$ZodTypeInternals<CreateApiAlphaResponsesResponse, unknown>>;
-    /** @deprecated use `CreateApiAlphaResponsesResponse$outboundSchema` instead. */
-    const outboundSchema: z.ZodType<models.OpenResponsesNonStreamingResponse$Outbound, CreateApiAlphaResponsesResponse, z.core.$ZodTypeInternals<models.OpenResponsesNonStreamingResponse$Outbound, CreateApiAlphaResponsesResponse>>;
-    /** @deprecated use `CreateApiAlphaResponsesResponse$Outbound` instead. */
-    type Outbound = CreateApiAlphaResponsesResponse$Outbound;
-}
-export declare function createApiAlphaResponsesResponseToJSON(createApiAlphaResponsesResponse: CreateApiAlphaResponsesResponse): string;
-export declare function createApiAlphaResponsesResponseFromJSON(jsonString: string): SafeParseResult<CreateApiAlphaResponsesResponse, SDKValidationError>;
-//# sourceMappingURL=createapialpharesponses.d.ts.map

package/esm/models/operations/createapialpharesponses.js

@@ -1,81 +0,0 @@
-/*
- * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- */
-import * as z from "zod/v4";
-import { EventStream } from "../../lib/event-streams.js";
-import { safeParse } from "../../lib/schemas.js";
-import * as models from "../index.js";
-/** @internal */
-export const CreateApiAlphaResponsesResponseBody$inboundSchema = z.object({
-    data: z.string().transform((v, ctx) => {
-        try {
-            return JSON.parse(v);
-        }
-        catch (err) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                message: `malformed json: ${err}`,
-            });
-            return z.NEVER;
-        }
-    }).pipe(models.OpenResponsesStreamEvent$inboundSchema),
-});
-/** @internal */
-export const CreateApiAlphaResponsesResponseBody$outboundSchema = z.object({
-    data: models.OpenResponsesStreamEvent$outboundSchema,
-});
-/**
- * @internal
- * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
- */
-export var CreateApiAlphaResponsesResponseBody$;
-(function (CreateApiAlphaResponsesResponseBody$) {
-    /** @deprecated use `CreateApiAlphaResponsesResponseBody$inboundSchema` instead. */
-    CreateApiAlphaResponsesResponseBody$.inboundSchema = CreateApiAlphaResponsesResponseBody$inboundSchema;
-    /** @deprecated use `CreateApiAlphaResponsesResponseBody$outboundSchema` instead. */
-    CreateApiAlphaResponsesResponseBody$.outboundSchema = CreateApiAlphaResponsesResponseBody$outboundSchema;
-})(CreateApiAlphaResponsesResponseBody$ || (CreateApiAlphaResponsesResponseBody$ = {}));
-export function createApiAlphaResponsesResponseBodyToJSON(createApiAlphaResponsesResponseBody) {
-    return JSON.stringify(CreateApiAlphaResponsesResponseBody$outboundSchema.parse(createApiAlphaResponsesResponseBody));
-}
-export function createApiAlphaResponsesResponseBodyFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => CreateApiAlphaResponsesResponseBody$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'CreateApiAlphaResponsesResponseBody' from JSON`);
-}
-/** @internal */
-export const CreateApiAlphaResponsesResponse$inboundSchema = z.union([
-    models.OpenResponsesNonStreamingResponse$inboundSchema,
-    z.custom(x => x instanceof ReadableStream)
-        .transform(stream => {
-        return new EventStream(stream, rawEvent => {
-            if (rawEvent.data === "[DONE]")
-                return { done: true };
-            return {
-                value: z.lazy(() => CreateApiAlphaResponsesResponseBody$inboundSchema)
-                    .parse(rawEvent),
-            };
-        });
-    }),
-]);
-/** @internal */
-export const CreateApiAlphaResponsesResponse$outboundSchema = z.union([
-    models.OpenResponsesNonStreamingResponse$outboundSchema,
-    z.never(),
-]);
-/**
- * @internal
- * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
- */
-export var CreateApiAlphaResponsesResponse$;
-(function (CreateApiAlphaResponsesResponse$) {
-    /** @deprecated use `CreateApiAlphaResponsesResponse$inboundSchema` instead. */
-    CreateApiAlphaResponsesResponse$.inboundSchema = CreateApiAlphaResponsesResponse$inboundSchema;
-    /** @deprecated use `CreateApiAlphaResponsesResponse$outboundSchema` instead. */
-    CreateApiAlphaResponsesResponse$.outboundSchema = CreateApiAlphaResponsesResponse$outboundSchema;
-})(CreateApiAlphaResponsesResponse$ || (CreateApiAlphaResponsesResponse$ = {}));
-export function createApiAlphaResponsesResponseToJSON(createApiAlphaResponsesResponse) {
-    return JSON.stringify(CreateApiAlphaResponsesResponse$outboundSchema.parse(createApiAlphaResponsesResponse));
-}
-export function createApiAlphaResponsesResponseFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => CreateApiAlphaResponsesResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'CreateApiAlphaResponsesResponse' from JSON`);
-}
-//# sourceMappingURL=createapialpharesponses.js.map