ultrasafeai 1.0.1

package/BaseClient.ts

@@ -0,0 +1,107 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import { HeaderAuthProvider } from "./auth/HeaderAuthProvider.js";
+import { mergeHeaders } from "./core/headers.js";
+import * as core from "./core/index.js";
+import type * as environments from "./environments.js";
+
+export type AuthOption =
+    | false
+    | core.AuthProvider["getAuthRequest"]
+    | core.AuthProvider
+    | HeaderAuthProvider.AuthOptions;
+
+export type BaseClientOptions = {
+    environment?: core.Supplier<environments.UltrasafeaiApiEnvironment | environments.UltrasafeaiApiEnvironmentUrls>;
+    /** Specify a custom URL to connect the client to. */
+    baseUrl?: core.Supplier<string>;
+    /** Additional headers to include in requests. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    /** The default maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The default number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** Provide a custom fetch implementation. Useful for platforms that don't have a built-in fetch or need a custom implementation. */
+    fetch?: typeof fetch;
+    /** Configure logging for the client. */
+    logging?: core.logging.LogConfig | core.logging.Logger;
+    /** Override auth. Pass false to disable, a function returning auth headers, an AuthProvider, or auth options. */
+    auth?: AuthOption;
+} & HeaderAuthProvider.AuthOptions;
+
+export interface BaseRequestOptions {
+    /** The maximum time to wait for a response in seconds. */
+    timeoutInSeconds?: number;
+    /** The number of times to retry the request. Defaults to 2. */
+    maxRetries?: number;
+    /** A hook to abort the request. */
+    abortSignal?: AbortSignal;
+    /** Additional query string parameters to include in the request. */
+    queryParams?: Record<string, unknown>;
+    /** Additional headers to include in the request. */
+    headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+}
+
+export type NormalizedClientOptions<T extends BaseClientOptions = BaseClientOptions> = T & {
+    logging: core.logging.Logger;
+    authProvider?: core.AuthProvider;
+};
+
+export type NormalizedClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions> =
+    NormalizedClientOptions<T> & {
+        authProvider: core.AuthProvider;
+    };
+
+export function normalizeClientOptions<T extends BaseClientOptions = BaseClientOptions>(
+    options: T,
+): NormalizedClientOptions<T> {
+    const headers = mergeHeaders(
+        {
+            "X-Fern-Language": "JavaScript",
+            "X-Fern-Runtime": core.RUNTIME.type,
+            "X-Fern-Runtime-Version": core.RUNTIME.version,
+        },
+        options?.headers,
+    );
+
+    return {
+        ...options,
+        logging: core.logging.createLogger(options?.logging),
+        headers,
+    } as NormalizedClientOptions<T>;
+}
+
+export function normalizeClientOptionsWithAuth<T extends BaseClientOptions = BaseClientOptions>(
+    options: T,
+): NormalizedClientOptionsWithAuth<T> {
+    const normalized = normalizeClientOptions(options) as NormalizedClientOptionsWithAuth<T>;
+
+    if (options.auth === false) {
+        normalized.authProvider = new core.NoOpAuthProvider();
+        return normalized;
+    }
+    if (options.auth != null) {
+        if (typeof options.auth === "function") {
+            normalized.authProvider = { getAuthRequest: options.auth };
+            return normalized;
+        }
+        if (core.isAuthProvider(options.auth)) {
+            normalized.authProvider = options.auth;
+            return normalized;
+        }
+        Object.assign(normalized, options.auth);
+    }
+
+    const normalizedWithNoOpAuthProvider = withNoOpAuthProvider(normalized);
+    normalized.authProvider ??= new HeaderAuthProvider(normalizedWithNoOpAuthProvider);
+    return normalized;
+}
+
+function withNoOpAuthProvider<T extends BaseClientOptions = BaseClientOptions>(
+    options: NormalizedClientOptions<T>,
+): NormalizedClientOptionsWithAuth<T> {
+    return {
+        ...options,
+        authProvider: new core.NoOpAuthProvider(),
+    };
+}

package/Client.ts

@@ -0,0 +1,203 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import { AdminClient } from "./api/resources/admin/client/Client.js";
+import { AssistantsClient } from "./api/resources/assistants/client/Client.js";
+import { AudioClient } from "./api/resources/audio/client/Client.js";
+import { BatchesClient } from "./api/resources/batches/client/Client.js";
+import { ChatClient } from "./api/resources/chat/client/Client.js";
+import { CompletionsClient } from "./api/resources/completions/client/Client.js";
+import { ContainersClient } from "./api/resources/containers/client/Client.js";
+import { EmbeddingsClient } from "./api/resources/embeddings/client/Client.js";
+import { EvalsClient } from "./api/resources/evals/client/Client.js";
+import { FilesClient } from "./api/resources/files/client/Client.js";
+import { FineTuningClient } from "./api/resources/fineTuning/client/Client.js";
+import { ImagesClient } from "./api/resources/images/client/Client.js";
+import { ModelsClient } from "./api/resources/models/client/Client.js";
+import { ModerationsClient } from "./api/resources/moderations/client/Client.js";
+import { OcrClient } from "./api/resources/ocr/client/Client.js";
+import { ParserClient } from "./api/resources/parser/client/Client.js";
+import { RealtimeClient } from "./api/resources/realtime/client/Client.js";
+import { RerankClient } from "./api/resources/rerank/client/Client.js";
+import { SkillsClient } from "./api/resources/skills/client/Client.js";
+import { ThreadsClient } from "./api/resources/threads/client/Client.js";
+import { UltraparserClient } from "./api/resources/ultraparser/client/Client.js";
+import { UploadsClient } from "./api/resources/uploads/client/Client.js";
+import { VectorStoresClient } from "./api/resources/vectorStores/client/Client.js";
+import { VideosClient } from "./api/resources/videos/client/Client.js";
+import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
+import { type NormalizedClientOptionsWithAuth, normalizeClientOptionsWithAuth } from "./BaseClient.js";
+import * as core from "./core/index.js";
+import * as environments from "./environments.js";
+
+export declare namespace UltrasafeaiApiClient {
+    export type Options = BaseClientOptions;
+
+    export interface RequestOptions extends BaseRequestOptions {}
+}
+
+export class UltrasafeaiApiClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<UltrasafeaiApiClient.Options>;
+    protected _chat: ChatClient | undefined;
+    protected _completions: CompletionsClient | undefined;
+    protected _embeddings: EmbeddingsClient | undefined;
+    protected _files: FilesClient | undefined;
+    protected _images: ImagesClient | undefined;
+    protected _audio: AudioClient | undefined;
+    protected _moderations: ModerationsClient | undefined;
+    protected _models: ModelsClient | undefined;
+    protected _fineTuning: FineTuningClient | undefined;
+    protected _vectorStores: VectorStoresClient | undefined;
+    protected _batches: BatchesClient | undefined;
+    protected _uploads: UploadsClient | undefined;
+    protected _assistants: AssistantsClient | undefined;
+    protected _threads: ThreadsClient | undefined;
+    protected _realtime: RealtimeClient | undefined;
+    protected _evals: EvalsClient | undefined;
+    protected _containers: ContainersClient | undefined;
+    protected _skills: SkillsClient | undefined;
+    protected _admin: AdminClient | undefined;
+    protected _rerank: RerankClient | undefined;
+    protected _videos: VideosClient | undefined;
+    protected _parser: ParserClient | undefined;
+    protected _ocr: OcrClient | undefined;
+    protected _ultraparser: UltraparserClient | undefined;
+
+    constructor(options: UltrasafeaiApiClient.Options = {}) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+
+    public get chat(): ChatClient {
+        return (this._chat ??= new ChatClient(this._options));
+    }
+
+    public get completions(): CompletionsClient {
+        return (this._completions ??= new CompletionsClient(this._options));
+    }
+
+    public get embeddings(): EmbeddingsClient {
+        return (this._embeddings ??= new EmbeddingsClient(this._options));
+    }
+
+    public get files(): FilesClient {
+        return (this._files ??= new FilesClient(this._options));
+    }
+
+    public get images(): ImagesClient {
+        return (this._images ??= new ImagesClient(this._options));
+    }
+
+    public get audio(): AudioClient {
+        return (this._audio ??= new AudioClient(this._options));
+    }
+
+    public get moderations(): ModerationsClient {
+        return (this._moderations ??= new ModerationsClient(this._options));
+    }
+
+    public get models(): ModelsClient {
+        return (this._models ??= new ModelsClient(this._options));
+    }
+
+    public get fineTuning(): FineTuningClient {
+        return (this._fineTuning ??= new FineTuningClient(this._options));
+    }
+
+    public get vectorStores(): VectorStoresClient {
+        return (this._vectorStores ??= new VectorStoresClient(this._options));
+    }
+
+    public get batches(): BatchesClient {
+        return (this._batches ??= new BatchesClient(this._options));
+    }
+
+    public get uploads(): UploadsClient {
+        return (this._uploads ??= new UploadsClient(this._options));
+    }
+
+    public get assistants(): AssistantsClient {
+        return (this._assistants ??= new AssistantsClient(this._options));
+    }
+
+    public get threads(): ThreadsClient {
+        return (this._threads ??= new ThreadsClient(this._options));
+    }
+
+    public get realtime(): RealtimeClient {
+        return (this._realtime ??= new RealtimeClient(this._options));
+    }
+
+    public get evals(): EvalsClient {
+        return (this._evals ??= new EvalsClient(this._options));
+    }
+
+    public get containers(): ContainersClient {
+        return (this._containers ??= new ContainersClient(this._options));
+    }
+
+    public get skills(): SkillsClient {
+        return (this._skills ??= new SkillsClient(this._options));
+    }
+
+    public get admin(): AdminClient {
+        return (this._admin ??= new AdminClient(this._options));
+    }
+
+    public get rerank(): RerankClient {
+        return (this._rerank ??= new RerankClient(this._options));
+    }
+
+    public get videos(): VideosClient {
+        return (this._videos ??= new VideosClient(this._options));
+    }
+
+    public get parser(): ParserClient {
+        return (this._parser ??= new ParserClient(this._options));
+    }
+
+    public get ocr(): OcrClient {
+        return (this._ocr ??= new OcrClient(this._options));
+    }
+
+    public get ultraparser(): UltraparserClient {
+        return (this._ultraparser ??= new UltraparserClient(this._options));
+    }
+
+    /**
+     * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
+     * This is useful for making requests to endpoints not yet supported in the SDK.
+     * The input can be a URL string, URL object, or Request object. Relative paths are resolved against the configured base URL.
+     *
+     * @param {Request | string | URL} input - The URL, path, or Request object.
+     * @param {RequestInit} init - Standard fetch RequestInit options.
+     * @param {core.PassthroughRequest.RequestOptions} requestOptions - Per-request overrides (timeout, retries, headers, abort signal).
+     * @returns {Promise<Response>} A standard Response object.
+     */
+    public async fetch(
+        input: Request | string | URL,
+        init?: RequestInit,
+        requestOptions?: core.PassthroughRequest.RequestOptions,
+    ): Promise<Response> {
+        return core.makePassthroughRequest(
+            input,
+            init,
+            {
+                baseUrl:
+                    this._options.baseUrl ??
+                    (async () => {
+                        const env = await core.Supplier.get(this._options.environment);
+                        return typeof env === "string"
+                            ? env
+                            : ((env as Record<string, string>)?.base ??
+                                  environments.UltrasafeaiApiEnvironment.Default.base);
+                    }),
+                headers: this._options.headers,
+                timeoutInSeconds: this._options.timeoutInSeconds,
+                maxRetries: this._options.maxRetries,
+                fetch: this._options.fetch,
+                logging: this._options.logging,
+                getAuthHeaders: async () => (await this._options.authProvider.getAuthRequest()).headers,
+            },
+            requestOptions,
+        );
+    }
+}

package/api/errors/BadRequestError.ts

@@ -0,0 +1,22 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as UltrasafeaiApi from "../index.js";
+
+export class BadRequestError extends errors.UltrasafeaiApiError {
+    constructor(body: UltrasafeaiApi.Error_, rawResponse?: core.RawResponse) {
+        super({
+            message: "BadRequestError",
+            statusCode: 400,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+
+        this.name = this.constructor.name;
+    }
+}

package/api/errors/PaymentRequiredError.ts

@@ -0,0 +1,22 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as UltrasafeaiApi from "../index.js";
+
+export class PaymentRequiredError extends errors.UltrasafeaiApiError {
+    constructor(body: UltrasafeaiApi.UltraparserError, rawResponse?: core.RawResponse) {
+        super({
+            message: "PaymentRequiredError",
+            statusCode: 402,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+
+        this.name = this.constructor.name;
+    }
+}

package/api/errors/UnauthorizedError.ts

@@ -0,0 +1,22 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as UltrasafeaiApi from "../index.js";
+
+export class UnauthorizedError extends errors.UltrasafeaiApiError {
+    constructor(body: UltrasafeaiApi.UltraparserError, rawResponse?: core.RawResponse) {
+        super({
+            message: "UnauthorizedError",
+            statusCode: 401,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+
+        this.name = this.constructor.name;
+    }
+}

package/api/errors/index.ts

@@ -0,0 +1,3 @@
+export * from "./BadRequestError.js";
+export * from "./PaymentRequiredError.js";
+export * from "./UnauthorizedError.js";

package/api/index.ts

@@ -0,0 +1,3 @@
+export * from "./errors/index.js";
+export * from "./resources/index.js";
+export * from "./types/index.js";