@openrouter/sdk 0.12.79 → 0.13.7

package/esm/sdk/betaanalytics.d.ts

@@ -0,0 +1,19 @@
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as operations from "../models/operations/index.js";
+export declare class BetaAnalytics extends ClientSDK {
+    /**
+     * Get available analytics metrics and dimensions
+     *
+     * @remarks
+     * Returns the available metrics, dimensions, filter operators, and granularities for the analytics query endpoint. [Management key](/docs/guides/overview/auth/management-api-keys) required.
+     */
+    getAnalyticsMeta(request?: operations.GetAnalyticsMetaRequest | undefined, options?: RequestOptions): Promise<operations.GetAnalyticsMetaResponse>;
+    /**
+     * Query analytics data
+     *
+     * @remarks
+     * Execute an analytics query with specified metrics, dimensions, filters, and time range. [Management key](/docs/guides/overview/auth/management-api-keys) required.
+     */
+    queryAnalytics(request: operations.QueryAnalyticsRequest, options?: RequestOptions): Promise<operations.QueryAnalyticsResponse>;
+}
+//# sourceMappingURL=betaanalytics.d.ts.map

package/esm/sdk/betaanalytics.js

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 814879ad7548
+ */
+import { betaAnalyticsGetAnalyticsMeta } from "../funcs/betaAnalyticsGetAnalyticsMeta.js";
+import { betaAnalyticsQueryAnalytics } from "../funcs/betaAnalyticsQueryAnalytics.js";
+import { ClientSDK } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+export class BetaAnalytics extends ClientSDK {
+    /**
+     * Get available analytics metrics and dimensions
+     *
+     * @remarks
+     * Returns the available metrics, dimensions, filter operators, and granularities for the analytics query endpoint. [Management key](/docs/guides/overview/auth/management-api-keys) required.
+     */
+    async getAnalyticsMeta(request, options) {
+        return unwrapAsync(betaAnalyticsGetAnalyticsMeta(this, request, options));
+    }
+    /**
+     * Query analytics data
+     *
+     * @remarks
+     * Execute an analytics query with specified metrics, dimensions, filters, and time range. [Management key](/docs/guides/overview/auth/management-api-keys) required.
+     */
+    async queryAnalytics(request, options) {
+        return unwrapAsync(betaAnalyticsQueryAnalytics(this, request, options));
+    }
+}
+//# sourceMappingURL=betaanalytics.js.map

package/esm/sdk/datasets.d.ts

@@ -1,7 +1,53 @@
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
+import { PageIterator } from "../types/operations.js";
 export declare class Datasets extends ClientSDK {
+    /**
+     * Top apps by token usage
+     *
+     * @remarks
+     * Returns the top public apps on OpenRouter ranked by token usage inside the requested
+     * date window, matching the public apps marketplace on openrouter.ai/apps. Token totals
+     * are `prompt_tokens + completion_tokens`; hidden and private apps are excluded and
+     * traffic from related app aliases is merged into the canonical visible app.
+     *
+     * `sort=popular` (default) ranks by total token volume inside the window.
+     * `sort=trending` ranks by absolute excess token growth: window volume minus the average
+     * volume of the three equal-length periods immediately preceding the window. Apps with
+     * no excess growth are omitted, so `trending` may return fewer than `limit` rows.
+     *
+     * Filter with `category` (marketplace category group, e.g. `coding`) or `subcategory`
+     * (e.g. `cli-agent`). Ranks are re-numbered 1..N after filtering. Page with `offset` —
+     * `rank` stays absolute, so the first row of `offset=50` is `rank: 51`.
+     *
+     * Authenticate with any valid OpenRouter API key (same key used for inference).
+     * Rate-limited to 30 requests/minute per key and 500 requests/day per account.
+     *
+     * When republishing or quoting this dataset, OpenRouter must be cited as:
+     * "Source: OpenRouter (openrouter.ai/apps), as of {as_of}."
+     *
+     * Token counts come from each upstream provider's own tokenizer, so a token attributed
+     * to one app is not directly comparable to a token attributed to another app whose
+     * traffic flows through a different provider.
+     */
+    getAppRankings(request?: operations.GetAppRankingsRequest | undefined, options?: RequestOptions): Promise<PageIterator<operations.GetAppRankingsResponse, {
+        offset: number;
+    }>>;
+    /**
+     * Artificial Analysis Benchmark Indices
+     *
+     * @remarks
+     * Returns composite index scores (Intelligence, Coding, Agentic) from Artificial Analysis for LLM models. Includes OpenRouter pricing per model. Authenticate with any valid OpenRouter API key. Rate-limited to 30 requests/minute per key and 500 requests/day per account.
+     */
+    getBenchmarksArtificialAnalysis(request?: operations.GetBenchmarksArtificialAnalysisRequest | undefined, options?: RequestOptions): Promise<models.BenchmarksAAResponse>;
+    /**
+     * Design Arena Benchmark Rankings
+     *
+     * @remarks
+     * Returns ELO ratings from head-to-head arena battles on Design Arena. Filterable by arena (models/builders/agents) and category. Includes OpenRouter pricing per model. Authenticate with any valid OpenRouter API key. Rate-limited to 30 requests/minute per key and 500 requests/day per account.
+     */
+    getBenchmarksDesignArena(request?: operations.GetBenchmarksDesignArenaRequest | undefined, options?: RequestOptions): Promise<models.BenchmarksDAResponse>;
     /**
      * Daily token totals for top 50 models
      *

package/esm/sdk/datasets.js

@@ -2,10 +2,63 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  * @generated-id: 2f1e89a21914
  */
+import { datasetsGetAppRankings } from "../funcs/datasetsGetAppRankings.js";
+import { datasetsGetBenchmarksArtificialAnalysis } from "../funcs/datasetsGetBenchmarksArtificialAnalysis.js";
+import { datasetsGetBenchmarksDesignArena } from "../funcs/datasetsGetBenchmarksDesignArena.js";
 import { datasetsGetRankingsDaily } from "../funcs/datasetsGetRankingsDaily.js";
 import { ClientSDK } from "../lib/sdks.js";
 import { unwrapAsync } from "../types/fp.js";
+import { unwrapResultIterator } from "../types/operations.js";
 export class Datasets extends ClientSDK {
+    /**
+     * Top apps by token usage
+     *
+     * @remarks
+     * Returns the top public apps on OpenRouter ranked by token usage inside the requested
+     * date window, matching the public apps marketplace on openrouter.ai/apps. Token totals
+     * are `prompt_tokens + completion_tokens`; hidden and private apps are excluded and
+     * traffic from related app aliases is merged into the canonical visible app.
+     *
+     * `sort=popular` (default) ranks by total token volume inside the window.
+     * `sort=trending` ranks by absolute excess token growth: window volume minus the average
+     * volume of the three equal-length periods immediately preceding the window. Apps with
+     * no excess growth are omitted, so `trending` may return fewer than `limit` rows.
+     *
+     * Filter with `category` (marketplace category group, e.g. `coding`) or `subcategory`
+     * (e.g. `cli-agent`). Ranks are re-numbered 1..N after filtering. Page with `offset` —
+     * `rank` stays absolute, so the first row of `offset=50` is `rank: 51`.
+     *
+     * Authenticate with any valid OpenRouter API key (same key used for inference).
+     * Rate-limited to 30 requests/minute per key and 500 requests/day per account.
+     *
+     * When republishing or quoting this dataset, OpenRouter must be cited as:
+     * "Source: OpenRouter (openrouter.ai/apps), as of {as_of}."
+     *
+     * Token counts come from each upstream provider's own tokenizer, so a token attributed
+     * to one app is not directly comparable to a token attributed to another app whose
+     * traffic flows through a different provider.
+     */
+    async getAppRankings(request, options) {
+        return unwrapResultIterator(datasetsGetAppRankings(this, request, options));
+    }
+    /**
+     * Artificial Analysis Benchmark Indices
+     *
+     * @remarks
+     * Returns composite index scores (Intelligence, Coding, Agentic) from Artificial Analysis for LLM models. Includes OpenRouter pricing per model. Authenticate with any valid OpenRouter API key. Rate-limited to 30 requests/minute per key and 500 requests/day per account.
+     */
+    async getBenchmarksArtificialAnalysis(request, options) {
+        return unwrapAsync(datasetsGetBenchmarksArtificialAnalysis(this, request, options));
+    }
+    /**
+     * Design Arena Benchmark Rankings
+     *
+     * @remarks
+     * Returns ELO ratings from head-to-head arena battles on Design Arena. Filterable by arena (models/builders/agents) and category. Includes OpenRouter pricing per model. Authenticate with any valid OpenRouter API key. Rate-limited to 30 requests/minute per key and 500 requests/day per account.
+     */
+    async getBenchmarksDesignArena(request, options) {
+        return unwrapAsync(datasetsGetBenchmarksDesignArena(this, request, options));
+    }
     /**
      * Daily token totals for top 50 models
      *

package/esm/sdk/files.d.ts

@@ -0,0 +1,44 @@
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { PageIterator } from "../types/operations.js";
+export declare class Files extends ClientSDK {
+    /**
+     * List files
+     *
+     * @remarks
+     * Lists files belonging to the workspace of the authenticating API key.
+     */
+    list(request?: operations.ListFilesRequest | undefined, options?: RequestOptions): Promise<PageIterator<operations.ListFilesResponse, {
+        cursor: string;
+    }>>;
+    /**
+     * Upload a file
+     *
+     * @remarks
+     * Uploads a file to be referenced in future API calls. The file is stored under the workspace of the authenticating API key. Maximum file size: 100 MB.
+     */
+    upload(request: operations.UploadFileRequest, options?: RequestOptions): Promise<models.FileMetadata>;
+    /**
+     * Delete a file
+     *
+     * @remarks
+     * Deletes a file owned by the requesting workspace. Deletion is irreversible.
+     */
+    delete(request: operations.DeleteFileRequest, options?: RequestOptions): Promise<models.FileDeleteResponse>;
+    /**
+     * Get file metadata
+     *
+     * @remarks
+     * Retrieves metadata for a single file owned by the requesting workspace.
+     */
+    retrieve(request: operations.GetFileMetadataRequest, options?: RequestOptions): Promise<models.FileMetadata>;
+    /**
+     * Download file content
+     *
+     * @remarks
+     * Downloads the raw bytes of a file. Only files created server-side are downloadable; uploaded files return 400.
+     */
+    download(request: operations.DownloadFileContentRequest, options?: RequestOptions): Promise<ReadableStream<Uint8Array>>;
+}
+//# sourceMappingURL=files.d.ts.map

package/esm/sdk/files.js

@@ -0,0 +1,60 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: bb9172f41ecb
+ */
+import { filesDelete } from "../funcs/filesDelete.js";
+import { filesDownload } from "../funcs/filesDownload.js";
+import { filesList } from "../funcs/filesList.js";
+import { filesRetrieve } from "../funcs/filesRetrieve.js";
+import { filesUpload } from "../funcs/filesUpload.js";
+import { ClientSDK } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+import { unwrapResultIterator } from "../types/operations.js";
+export class Files extends ClientSDK {
+    /**
+     * List files
+     *
+     * @remarks
+     * Lists files belonging to the workspace of the authenticating API key.
+     */
+    async list(request, options) {
+        return unwrapResultIterator(filesList(this, request, options));
+    }
+    /**
+     * Upload a file
+     *
+     * @remarks
+     * Uploads a file to be referenced in future API calls. The file is stored under the workspace of the authenticating API key. Maximum file size: 100 MB.
+     */
+    async upload(request, options) {
+        return unwrapAsync(filesUpload(this, request, options));
+    }
+    /**
+     * Delete a file
+     *
+     * @remarks
+     * Deletes a file owned by the requesting workspace. Deletion is irreversible.
+     */
+    async delete(request, options) {
+        return unwrapAsync(filesDelete(this, request, options));
+    }
+    /**
+     * Get file metadata
+     *
+     * @remarks
+     * Retrieves metadata for a single file owned by the requesting workspace.
+     */
+    async retrieve(request, options) {
+        return unwrapAsync(filesRetrieve(this, request, options));
+    }
+    /**
+     * Download file content
+     *
+     * @remarks
+     * Downloads the raw bytes of a file. Only files created server-side are downloadable; uploaded files return 400.
+     */
+    async download(request, options) {
+        return unwrapAsync(filesDownload(this, request, options));
+    }
+}
+//# sourceMappingURL=files.js.map

package/esm/sdk/models.d.ts

@@ -2,6 +2,13 @@ import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
 export declare class Models extends ClientSDK {
+    /**
+     * Get a model by its slug
+     *
+     * @remarks
+     * Returns full details for a single model identified by its author and slug (e.g. openai/gpt-4). Supports variant suffixes (e.g. openai/gpt-4:free) and resolves known slug aliases.
+     */
+    get(request: operations.GetModelRequest, options?: RequestOptions): Promise<models.ModelResponse>;
     /**
      * List all models and their properties
      */

package/esm/sdk/models.js

@@ -3,11 +3,21 @@
  * @generated-id: 8c761ab180fd
  */
 import { modelsCount } from "../funcs/modelsCount.js";
+import { modelsGet } from "../funcs/modelsGet.js";
 import { modelsList } from "../funcs/modelsList.js";
 import { modelsListForUser } from "../funcs/modelsListForUser.js";
 import { ClientSDK } from "../lib/sdks.js";
 import { unwrapAsync } from "../types/fp.js";
 export class Models extends ClientSDK {
+    /**
+     * Get a model by its slug
+     *
+     * @remarks
+     * Returns full details for a single model identified by its author and slug (e.g. openai/gpt-4). Supports variant suffixes (e.g. openai/gpt-4:free) and resolves known slug aliases.
+     */
+    async get(request, options) {
+        return unwrapAsync(modelsGet(this, request, options));
+    }
     /**
      * List all models and their properties
      */

package/esm/sdk/presets.d.ts

@@ -1,7 +1,24 @@
 import { ClientSDK, RequestOptions } from "../lib/sdks.js";
 import * as models from "../models/index.js";
 import * as operations from "../models/operations/index.js";
+import { PageIterator } from "../types/operations.js";
 export declare class Presets extends ClientSDK {
+    /**
+     * List presets
+     *
+     * @remarks
+     * Lists all presets for the authenticated user, ordered by most recently updated first.
+     */
+    list(request?: operations.ListPresetsRequest | undefined, options?: RequestOptions): Promise<PageIterator<operations.ListPresetsResponse, {
+        offset: number;
+    }>>;
+    /**
+     * Get a preset
+     *
+     * @remarks
+     * Retrieves a preset by its slug with its currently designated version inline.
+     */
+    get(request: operations.GetPresetRequest, options?: RequestOptions): Promise<models.GetPresetResponse>;
     /**
      * Create a preset from a chat-completions request body
      *
@@ -23,5 +40,21 @@ export declare class Presets extends ClientSDK {
      * Creates a preset (or a new version of an existing one) from an inference request body. Only fields that overlap with the preset config are persisted; other fields (e.g. `messages`, `stream`, `prompt`) are silently ignored.
      */
     createPresetsResponses(request: operations.CreatePresetsResponsesRequest, options?: RequestOptions): Promise<models.CreatePresetFromInferenceResponse>;
+    /**
+     * List versions of a preset
+     *
+     * @remarks
+     * Lists all versions of a preset, ordered by version number ascending (oldest first).
+     */
+    listVersions(request: operations.ListPresetVersionsRequest, options?: RequestOptions): Promise<PageIterator<operations.ListPresetVersionsResponse, {
+        offset: number;
+    }>>;
+    /**
+     * Get a specific version of a preset
+     *
+     * @remarks
+     * Retrieves a specific version of a preset by its slug and version number.
+     */
+    getVersion(request: operations.GetPresetVersionRequest, options?: RequestOptions): Promise<models.GetPresetVersionResponse>;
 }
 //# sourceMappingURL=presets.d.ts.map

package/esm/sdk/presets.js

@@ -5,9 +5,32 @@
 import { presetsCreatePresetsChatCompletions } from "../funcs/presetsCreatePresetsChatCompletions.js";
 import { presetsCreatePresetsMessages } from "../funcs/presetsCreatePresetsMessages.js";
 import { presetsCreatePresetsResponses } from "../funcs/presetsCreatePresetsResponses.js";
+import { presetsGet } from "../funcs/presetsGet.js";
+import { presetsGetVersion } from "../funcs/presetsGetVersion.js";
+import { presetsList } from "../funcs/presetsList.js";
+import { presetsListVersions } from "../funcs/presetsListVersions.js";
 import { ClientSDK } from "../lib/sdks.js";
 import { unwrapAsync } from "../types/fp.js";
+import { unwrapResultIterator } from "../types/operations.js";
 export class Presets extends ClientSDK {
+    /**
+     * List presets
+     *
+     * @remarks
+     * Lists all presets for the authenticated user, ordered by most recently updated first.
+     */
+    async list(request, options) {
+        return unwrapResultIterator(presetsList(this, request, options));
+    }
+    /**
+     * Get a preset
+     *
+     * @remarks
+     * Retrieves a preset by its slug with its currently designated version inline.
+     */
+    async get(request, options) {
+        return unwrapAsync(presetsGet(this, request, options));
+    }
     /**
      * Create a preset from a chat-completions request body
      *
@@ -35,5 +58,23 @@ export class Presets extends ClientSDK {
     async createPresetsResponses(request, options) {
         return unwrapAsync(presetsCreatePresetsResponses(this, request, options));
     }
+    /**
+     * List versions of a preset
+     *
+     * @remarks
+     * Lists all versions of a preset, ordered by version number ascending (oldest first).
+     */
+    async listVersions(request, options) {
+        return unwrapResultIterator(presetsListVersions(this, request, options));
+    }
+    /**
+     * Get a specific version of a preset
+     *
+     * @remarks
+     * Retrieves a specific version of a preset by its slug and version number.
+     */
+    async getVersion(request, options) {
+        return unwrapAsync(presetsGetVersion(this, request, options));
+    }
 }
 //# sourceMappingURL=presets.js.map

package/esm/sdk/sdk.d.ts

@@ -8,6 +8,7 @@ import { Credits } from "./credits.js";
 import { Datasets } from "./datasets.js";
 import { Embeddings } from "./embeddings.js";
 import { Endpoints } from "./endpoints.js";
+import { Files } from "./files.js";
 import { Generations } from "./generations.js";
 import { Guardrails } from "./guardrails.js";
 import { Models } from "./models.js";
@@ -30,6 +31,8 @@ export { ToolType };
 export declare class OpenRouter extends ClientSDK {
     private _analytics?;
     get analytics(): Analytics;
+    private _beta?;
+    get beta(): Beta;
     private _tts?;
     get tts(): Tts;
     private _stt?;
@@ -48,6 +51,8 @@ export declare class OpenRouter extends ClientSDK {
     get embeddings(): Embeddings;
     private _endpoints?;
     get endpoints(): Endpoints;
+    private _files?;
+    get files(): Files;
     private _generations?;
     get generations(): Generations;
     private _guardrails?;
@@ -66,8 +71,6 @@ export declare class OpenRouter extends ClientSDK {
     get providers(): Providers;
     private _rerank?;
     get rerank(): Rerank;
-    private _beta?;
-    get beta(): Beta;
     private _videoGeneration?;
     get videoGeneration(): VideoGeneration;
     private _workspaces?;

package/esm/sdk/sdk.js

@@ -12,6 +12,7 @@ import { Credits } from "./credits.js";
 import { Datasets } from "./datasets.js";
 import { Embeddings } from "./embeddings.js";
 import { Endpoints } from "./endpoints.js";
+import { Files } from "./files.js";
 import { Generations } from "./generations.js";
 import { Guardrails } from "./guardrails.js";
 import { Models } from "./models.js";
@@ -33,6 +34,9 @@ export class OpenRouter extends ClientSDK {
     get analytics() {
         return (this._analytics ?? (this._analytics = new Analytics(this._options)));
     }
+    get beta() {
+        return (this._beta ?? (this._beta = new Beta(this._options)));
+    }
     get tts() {
         return (this._tts ?? (this._tts = new Tts(this._options)));
     }
@@ -60,6 +64,9 @@ export class OpenRouter extends ClientSDK {
     get endpoints() {
         return (this._endpoints ?? (this._endpoints = new Endpoints(this._options)));
     }
+    get files() {
+        return (this._files ?? (this._files = new Files(this._options)));
+    }
     get generations() {
         return (this._generations ?? (this._generations = new Generations(this._options)));
     }
@@ -87,9 +94,6 @@ export class OpenRouter extends ClientSDK {
     get rerank() {
         return (this._rerank ?? (this._rerank = new Rerank(this._options)));
     }
-    get beta() {
-        return (this._beta ?? (this._beta = new Beta(this._options)));
-    }
     get videoGeneration() {
         return (this._videoGeneration ?? (this._videoGeneration = new VideoGeneration(this._options)));
     }

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.79",
+  "version": "0.13.7",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.79",
+  "version": "0.13.7",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 300+ language models through a unified API.",
   "keywords": [
@@ -74,13 +74,13 @@
     "build": "tsc",
     "prepublishOnly": "npm run build",
     "test:watch": "vitest --watch --project unit",
+    "typecheck": "tsc --noEmit",
     "typecheck:transit": "exit 0",
     "compile": "tsc",
     "postinstall": "node scripts/check-types.js || true",
+    "prepare": "npm run build",
     "test": "vitest --run --project unit",
     "test:e2e": "vitest --run --project e2e",
-    "typecheck": "tsc --noEmit",
-    "prepare": "npm run build",
     "test:transit": "exit 0"
   },
   "peerDependencies": {},