@abliteration/sdk 0.1.0 → 0.1.1

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@abliteration/sdk",
-  "version": "0.1.0",
-  "description": "Auto-generated TypeScript SDK for the abliteration.org LLM catalog API. Covers every route on /api/v1 with typed models.",
-  "author": "Catyonic OU <contact@catyonic.com>",
+  "version": "0.1.1",
+  "description": "OpenAPI client for @abliteration/sdk",
+  "author": "OpenAPI-Generator",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/neymark/abliteration.git"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "module": "./dist/esm/index.js",
@@ -14,18 +18,12 @@
   "devDependencies": {
     "typescript": "^4.0 || ^5.0"
   },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
   "homepage": "https://abliteration.org/api",
-  "license": "MIT",
-  "keywords": [
-    "abliteration",
-    "llm",
-    "catalog",
-    "api",
-    "openapi",
-    "sdk"
-  ],
-  "files": [
-    "dist",
-    "README.md"
-  ]
+  "bugs": {
+    "url": "https://github.com/neymark/abliteration/issues"
+  }
 }

package/src/apis/AuthorsApi.ts

@@ -0,0 +1,248 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * abliteration.org Public API
+ * Read access to the abliteration.org catalog: models and their method classification, alignment datasets and their passports, the M-code taxonomy, the four flagship indices and the curated field timeline.  Every call is authenticated with a bearer key and metered in credits against the same wallet the Research Agent spends from. There is no free tier for machine traffic and no separate billing.  Responses report `cost` and `credits_remaining` on every success. While `metering` reads `preview`, the cost shown is what the call will bill once metering is enabled and nothing is actually deducted; when it reads `billed`, it was.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime';
+import {
+    type GetAuthor200Response,
+    GetAuthor200ResponseFromJSON,
+    GetAuthor200ResponseToJSON,
+} from '../models/GetAuthor200Response';
+import {
+    type ListAuthors200Response,
+    ListAuthors200ResponseFromJSON,
+    ListAuthors200ResponseToJSON,
+} from '../models/ListAuthors200Response';
+
+export interface GetAuthorRequest {
+    /**
+     * 
+     */
+    id: string;
+}
+
+export interface ListAuthorsRequest {
+    /**
+     * Bare key is DESC (largest first); a leading `-` flips to ASC. Aliases: `downloads` == `total_downloads`, `models` == `total_models`, `likes` == `total_likes`.
+     */
+    sort?: ListAuthorsSortEnum;
+    /**
+     * Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     */
+    limit?: number;
+    /**
+     * Rows to skip. Negative and non-numeric values are treated as 0.
+     */
+    offset?: number;
+}
+
+/**
+ * AuthorsApi - interface
+ * 
+ * @export
+ * @interface AuthorsApiInterface
+ */
+export interface AuthorsApiInterface {
+    /**
+     * Creates request options for getAuthor without sending the request
+     * @param {string} id 
+     * @throws {RequiredError}
+     * @memberof AuthorsApiInterface
+     */
+    getAuthorRequestOpts(requestParameters: GetAuthorRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Cost: 1 credit.
+     * @summary Get one author
+     * @param {string} id 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AuthorsApiInterface
+     */
+    getAuthorRaw(requestParameters: GetAuthorRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetAuthor200Response>>;
+
+    /**
+     * Cost: 1 credit.
+     * Get one author
+     */
+    getAuthor(requestParameters: GetAuthorRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetAuthor200Response>;
+
+    /**
+     * Creates request options for listAuthors without sending the request
+     * @param {'total_downloads' | '-total_downloads' | 'downloads' | '-downloads' | 'total_models' | '-total_models' | 'models' | '-models' | 'total_likes' | '-total_likes' | 'likes' | '-likes'} [sort] Bare key is DESC (largest first); a leading &#x60;-&#x60; flips to ASC. Aliases: &#x60;downloads&#x60; &#x3D;&#x3D; &#x60;total_downloads&#x60;, &#x60;models&#x60; &#x3D;&#x3D; &#x60;total_models&#x60;, &#x60;likes&#x60; &#x3D;&#x3D; &#x60;total_likes&#x60;.
+     * @param {number} [limit] Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     * @param {number} [offset] Rows to skip. Negative and non-numeric values are treated as 0.
+     * @throws {RequiredError}
+     * @memberof AuthorsApiInterface
+     */
+    listAuthorsRequestOpts(requestParameters: ListAuthorsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Cost: 5-15 credits, by rows returned.
+     * @summary List authors
+     * @param {'total_downloads' | '-total_downloads' | 'downloads' | '-downloads' | 'total_models' | '-total_models' | 'models' | '-models' | 'total_likes' | '-total_likes' | 'likes' | '-likes'} [sort] Bare key is DESC (largest first); a leading &#x60;-&#x60; flips to ASC. Aliases: &#x60;downloads&#x60; &#x3D;&#x3D; &#x60;total_downloads&#x60;, &#x60;models&#x60; &#x3D;&#x3D; &#x60;total_models&#x60;, &#x60;likes&#x60; &#x3D;&#x3D; &#x60;total_likes&#x60;.
+     * @param {number} [limit] Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     * @param {number} [offset] Rows to skip. Negative and non-numeric values are treated as 0.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AuthorsApiInterface
+     */
+    listAuthorsRaw(requestParameters: ListAuthorsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListAuthors200Response>>;
+
+    /**
+     * Cost: 5-15 credits, by rows returned.
+     * List authors
+     */
+    listAuthors(requestParameters: ListAuthorsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListAuthors200Response>;
+
+}
+
+/**
+ * 
+ */
+export class AuthorsApi extends runtime.BaseAPI implements AuthorsApiInterface {
+
+    /**
+     * Creates request options for getAuthor without sending the request
+     */
+    async getAuthorRequestOpts(requestParameters: GetAuthorRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError(
+                'id',
+                'Required parameter "id" was null or undefined when calling getAuthor().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/v1/authors/{id}`;
+        urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Cost: 1 credit.
+     * Get one author
+     */
+    async getAuthorRaw(requestParameters: GetAuthorRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetAuthor200Response>> {
+        const requestOptions = await this.getAuthorRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetAuthor200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Cost: 1 credit.
+     * Get one author
+     */
+    async getAuthor(requestParameters: GetAuthorRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetAuthor200Response> {
+        const response = await this.getAuthorRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listAuthors without sending the request
+     */
+    async listAuthorsRequestOpts(requestParameters: ListAuthorsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['sort'] != null) {
+            queryParameters['sort'] = requestParameters['sort'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/v1/authors`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Cost: 5-15 credits, by rows returned.
+     * List authors
+     */
+    async listAuthorsRaw(requestParameters: ListAuthorsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListAuthors200Response>> {
+        const requestOptions = await this.listAuthorsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ListAuthors200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Cost: 5-15 credits, by rows returned.
+     * List authors
+     */
+    async listAuthors(requestParameters: ListAuthorsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListAuthors200Response> {
+        const response = await this.listAuthorsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}
+
+/**
+ * @export
+ */
+export const ListAuthorsSortEnum = {
+    TotalDownloads: 'total_downloads',
+    TotalDownloads2: '-total_downloads',
+    Downloads: 'downloads',
+    Downloads2: '-downloads',
+    TotalModels: 'total_models',
+    TotalModels2: '-total_models',
+    Models: 'models',
+    Models2: '-models',
+    TotalLikes: 'total_likes',
+    TotalLikes2: '-total_likes',
+    Likes: 'likes',
+    Likes2: '-likes',
+} as const;
+export type ListAuthorsSortEnum = typeof ListAuthorsSortEnum[keyof typeof ListAuthorsSortEnum];

package/src/apis/DatasetsApi.ts

@@ -0,0 +1,278 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * abliteration.org Public API
+ * Read access to the abliteration.org catalog: models and their method classification, alignment datasets and their passports, the M-code taxonomy, the four flagship indices and the curated field timeline.  Every call is authenticated with a bearer key and metered in credits against the same wallet the Research Agent spends from. There is no free tier for machine traffic and no separate billing.  Responses report `cost` and `credits_remaining` on every success. While `metering` reads `preview`, the cost shown is what the call will bill once metering is enabled and nothing is actually deducted; when it reads `billed`, it was.
+ *
+ * The version of the OpenAPI document: 1.0.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import * as runtime from '../runtime';
+import {
+    type GetDataset200Response,
+    GetDataset200ResponseFromJSON,
+    GetDataset200ResponseToJSON,
+} from '../models/GetDataset200Response';
+import {
+    type ListDatasets200Response,
+    ListDatasets200ResponseFromJSON,
+    ListDatasets200ResponseToJSON,
+} from '../models/ListDatasets200Response';
+
+export interface GetDatasetRequest {
+    /**
+     * 
+     */
+    id: string;
+}
+
+export interface ListDatasetsRequest {
+    /**
+     * Workflow stage, for example heal or extract.
+     */
+    category?: string;
+    /**
+     * Publisher handle, case-insensitive.
+     */
+    author?: string;
+    /**
+     * License string as published.
+     */
+    license?: string;
+    /**
+     * Bare key is the natural direction (downloads/likes = most first, dates = newest first). A leading `-` flips it. `created` and `first_seen` are aliases for the full column names.
+     */
+    sort?: ListDatasetsSortEnum;
+    /**
+     * Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     */
+    limit?: number;
+    /**
+     * Rows to skip. Negative and non-numeric values are treated as 0.
+     */
+    offset?: number;
+}
+
+/**
+ * DatasetsApi - interface
+ * 
+ * @export
+ * @interface DatasetsApiInterface
+ */
+export interface DatasetsApiInterface {
+    /**
+     * Creates request options for getDataset without sending the request
+     * @param {string} id 
+     * @throws {RequiredError}
+     * @memberof DatasetsApiInterface
+     */
+    getDatasetRequestOpts(requestParameters: GetDatasetRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Cost: 1 credit. The passport is null for datasets that do not have one yet.
+     * @summary Get one dataset
+     * @param {string} id 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DatasetsApiInterface
+     */
+    getDatasetRaw(requestParameters: GetDatasetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetDataset200Response>>;
+
+    /**
+     * Cost: 1 credit. The passport is null for datasets that do not have one yet.
+     * Get one dataset
+     */
+    getDataset(requestParameters: GetDatasetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetDataset200Response>;
+
+    /**
+     * Creates request options for listDatasets without sending the request
+     * @param {string} [category] Workflow stage, for example heal or extract.
+     * @param {string} [author] Publisher handle, case-insensitive.
+     * @param {string} [license] License string as published.
+     * @param {'downloads' | '-downloads' | 'likes' | '-likes' | 'created' | '-created' | 'created_at' | '-created_at' | 'first_seen' | '-first_seen' | 'first_seen_at' | '-first_seen_at'} [sort] Bare key is the natural direction (downloads/likes &#x3D; most first, dates &#x3D; newest first). A leading &#x60;-&#x60; flips it. &#x60;created&#x60; and &#x60;first_seen&#x60; are aliases for the full column names.
+     * @param {number} [limit] Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     * @param {number} [offset] Rows to skip. Negative and non-numeric values are treated as 0.
+     * @throws {RequiredError}
+     * @memberof DatasetsApiInterface
+     */
+    listDatasetsRequestOpts(requestParameters: ListDatasetsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Cost: 5-15 credits, by rows returned.
+     * @summary List datasets
+     * @param {string} [category] Workflow stage, for example heal or extract.
+     * @param {string} [author] Publisher handle, case-insensitive.
+     * @param {string} [license] License string as published.
+     * @param {'downloads' | '-downloads' | 'likes' | '-likes' | 'created' | '-created' | 'created_at' | '-created_at' | 'first_seen' | '-first_seen' | 'first_seen_at' | '-first_seen_at'} [sort] Bare key is the natural direction (downloads/likes &#x3D; most first, dates &#x3D; newest first). A leading &#x60;-&#x60; flips it. &#x60;created&#x60; and &#x60;first_seen&#x60; are aliases for the full column names.
+     * @param {number} [limit] Rows to return, 1 to 1000. Values outside the range are clamped, not rejected.
+     * @param {number} [offset] Rows to skip. Negative and non-numeric values are treated as 0.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DatasetsApiInterface
+     */
+    listDatasetsRaw(requestParameters: ListDatasetsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListDatasets200Response>>;
+
+    /**
+     * Cost: 5-15 credits, by rows returned.
+     * List datasets
+     */
+    listDatasets(requestParameters: ListDatasetsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListDatasets200Response>;
+
+}
+
+/**
+ * 
+ */
+export class DatasetsApi extends runtime.BaseAPI implements DatasetsApiInterface {
+
+    /**
+     * Creates request options for getDataset without sending the request
+     */
+    async getDatasetRequestOpts(requestParameters: GetDatasetRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError(
+                'id',
+                'Required parameter "id" was null or undefined when calling getDataset().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/v1/datasets/{id}`;
+        urlPath = urlPath.replace('{id}', encodeURIComponent(String(requestParameters['id'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Cost: 1 credit. The passport is null for datasets that do not have one yet.
+     * Get one dataset
+     */
+    async getDatasetRaw(requestParameters: GetDatasetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<GetDataset200Response>> {
+        const requestOptions = await this.getDatasetRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => GetDataset200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Cost: 1 credit. The passport is null for datasets that do not have one yet.
+     * Get one dataset
+     */
+    async getDataset(requestParameters: GetDatasetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<GetDataset200Response> {
+        const response = await this.getDatasetRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listDatasets without sending the request
+     */
+    async listDatasetsRequestOpts(requestParameters: ListDatasetsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['category'] != null) {
+            queryParameters['category'] = requestParameters['category'];
+        }
+
+        if (requestParameters['author'] != null) {
+            queryParameters['author'] = requestParameters['author'];
+        }
+
+        if (requestParameters['license'] != null) {
+            queryParameters['license'] = requestParameters['license'];
+        }
+
+        if (requestParameters['sort'] != null) {
+            queryParameters['sort'] = requestParameters['sort'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/v1/datasets`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Cost: 5-15 credits, by rows returned.
+     * List datasets
+     */
+    async listDatasetsRaw(requestParameters: ListDatasetsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListDatasets200Response>> {
+        const requestOptions = await this.listDatasetsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ListDatasets200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Cost: 5-15 credits, by rows returned.
+     * List datasets
+     */
+    async listDatasets(requestParameters: ListDatasetsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListDatasets200Response> {
+        const response = await this.listDatasetsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}
+
+/**
+ * @export
+ */
+export const ListDatasetsSortEnum = {
+    Downloads: 'downloads',
+    Downloads2: '-downloads',
+    Likes: 'likes',
+    Likes2: '-likes',
+    Created: 'created',
+    Created2: '-created',
+    CreatedAt: 'created_at',
+    CreatedAt2: '-created_at',
+    FirstSeen: 'first_seen',
+    FirstSeen2: '-first_seen',
+    FirstSeenAt: 'first_seen_at',
+    FirstSeenAt2: '-first_seen_at',
+} as const;
+export type ListDatasetsSortEnum = typeof ListDatasetsSortEnum[keyof typeof ListDatasetsSortEnum];