@apicity/openai 0.1.0-alpha.0

package/dist/src/openai.js

@@ -0,0 +1,735 @@
+import { OpenAiError, } from "./types.js";
+import { OpenAiChatRequestSchema, OpenAiEmbeddingRequestSchema, OpenAiFileUploadRequestSchema, OpenAiImageEditRequestSchema, OpenAiImageGenerationRequestSchema, OpenAiImageVariationRequestSchema, OpenAiModerationRequestSchema, OpenAiSpeechRequestSchema, OpenAiTranscribeRequestSchema, OpenAiTranslateRequestSchema, OpenAiBatchCreateRequestSchema, OpenAiResponseRequestSchema, OpenAiResponseCompactRequestSchema, OpenAiResponseInputTokensRequestSchema, OpenAiFineTuningJobCreateRequestSchema, OpenAiCheckpointPermissionCreateRequestSchema, } from "./zod.js";
+import { attachExamples } from "./example.js";
+export function textPart(text) {
+    return { type: "text", text };
+}
+export function imageUrlPart(url, detail) {
+    return {
+        type: "image_url",
+        image_url: { url, ...(detail ? { detail } : {}) },
+    };
+}
+export function imageBase64Part(base64, mediaType, detail) {
+    return imageUrlPart(`data:${mediaType};base64,${base64}`, detail);
+}
+export function firstContent(response) {
+    return response.choices[0]?.message?.content ?? "";
+}
+export function openai(opts) {
+    const baseURL = opts.baseURL ?? "https://api.openai.com/v1";
+    const doFetch = opts.fetch ?? fetch;
+    const timeout = opts.timeout ?? 30000;
+    async function makeRequest(path, init, signal) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        if (signal) {
+            signal.addEventListener("abort", () => controller.abort());
+        }
+        try {
+            const res = await doFetch(`${baseURL}${path}`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${opts.apiKey}`,
+                    ...init.headers,
+                },
+                body: init.body,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!res.ok) {
+                let message = `OpenAI API error: ${res.status}`;
+                let body = null;
+                try {
+                    body = await res.json();
+                    if (typeof body === "object" && body !== null && "error" in body) {
+                        const err = body.error;
+                        if (err?.message) {
+                            message = `OpenAI API error ${res.status}: ${err.message}`;
+                        }
+                    }
+                }
+                catch {
+                    // ignore parse errors
+                }
+                throw new OpenAiError(message, res.status, body);
+            }
+            return (await res.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof OpenAiError)
+                throw error;
+            throw new OpenAiError(`OpenAI request failed: ${error}`, 500);
+        }
+    }
+    function jsonRequest(body) {
+        return {
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        };
+    }
+    async function makeBinaryRequest(path, init, signal) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        if (signal) {
+            signal.addEventListener("abort", () => controller.abort());
+        }
+        try {
+            const res = await doFetch(`${baseURL}${path}`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${opts.apiKey}`,
+                    ...init.headers,
+                },
+                body: init.body,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!res.ok) {
+                let message = `OpenAI API error: ${res.status}`;
+                let body = null;
+                try {
+                    body = await res.json();
+                    if (typeof body === "object" && body !== null && "error" in body) {
+                        const err = body.error;
+                        if (err?.message) {
+                            message = `OpenAI API error ${res.status}: ${err.message}`;
+                        }
+                    }
+                }
+                catch {
+                    // ignore parse errors
+                }
+                throw new OpenAiError(message, res.status, body);
+            }
+            return await res.arrayBuffer();
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof OpenAiError)
+                throw error;
+            throw new OpenAiError(`OpenAI request failed: ${error}`, 500);
+        }
+    }
+    async function makeGetRequest(path, query, signal) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        if (signal) {
+            signal.addEventListener("abort", () => controller.abort());
+        }
+        const params = new URLSearchParams();
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value === undefined)
+                    continue;
+                if (Array.isArray(value)) {
+                    for (const v of value) {
+                        params.append(`${key}[]`, v);
+                    }
+                }
+                else {
+                    params.append(key, String(value));
+                }
+            }
+        }
+        const qs = params.toString();
+        const url = `${baseURL}${path}${qs ? `?${qs}` : ""}`;
+        try {
+            const res = await doFetch(url, {
+                method: "GET",
+                headers: {
+                    Authorization: `Bearer ${opts.apiKey}`,
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!res.ok) {
+                let message = `OpenAI API error: ${res.status}`;
+                let body = null;
+                try {
+                    body = await res.json();
+                    if (typeof body === "object" && body !== null && "error" in body) {
+                        const err = body.error;
+                        if (err?.message) {
+                            message = `OpenAI API error ${res.status}: ${err.message}`;
+                        }
+                    }
+                }
+                catch {
+                    // ignore parse errors
+                }
+                throw new OpenAiError(message, res.status, body);
+            }
+            return (await res.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof OpenAiError)
+                throw error;
+            throw new OpenAiError(`OpenAI request failed: ${error}`, 500);
+        }
+    }
+    async function makeEmptyPostRequest(path, signal) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        if (signal) {
+            signal.addEventListener("abort", () => controller.abort());
+        }
+        try {
+            const res = await doFetch(`${baseURL}${path}`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${opts.apiKey}`,
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!res.ok) {
+                let message = `OpenAI API error: ${res.status}`;
+                let body = null;
+                try {
+                    body = await res.json();
+                    if (typeof body === "object" && body !== null && "error" in body) {
+                        const err = body.error;
+                        if (err?.message) {
+                            message = `OpenAI API error ${res.status}: ${err.message}`;
+                        }
+                    }
+                }
+                catch {
+                    // ignore parse errors
+                }
+                throw new OpenAiError(message, res.status, body);
+            }
+            return (await res.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof OpenAiError)
+                throw error;
+            throw new OpenAiError(`OpenAI request failed: ${error}`, 500);
+        }
+    }
+    async function makeDeleteRequest(path, signal) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        if (signal) {
+            signal.addEventListener("abort", () => controller.abort());
+        }
+        try {
+            const res = await doFetch(`${baseURL}${path}`, {
+                method: "DELETE",
+                headers: {
+                    Authorization: `Bearer ${opts.apiKey}`,
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!res.ok) {
+                let message = `OpenAI API error: ${res.status}`;
+                let body = null;
+                try {
+                    body = await res.json();
+                    if (typeof body === "object" && body !== null && "error" in body) {
+                        const err = body.error;
+                        if (err?.message) {
+                            message = `OpenAI API error ${res.status}: ${err.message}`;
+                        }
+                    }
+                }
+                catch {
+                    // ignore parse errors
+                }
+                throw new OpenAiError(message, res.status, body);
+            }
+            return (await res.json());
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof OpenAiError)
+                throw error;
+            throw new OpenAiError(`OpenAI request failed: ${error}`, 500);
+        }
+    }
+    async function makeGetTextRequest(path, signal) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        if (signal) {
+            signal.addEventListener("abort", () => controller.abort());
+        }
+        const url = `${baseURL}${path}`;
+        try {
+            const res = await doFetch(url, {
+                method: "GET",
+                headers: {
+                    Authorization: `Bearer ${opts.apiKey}`,
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!res.ok) {
+                let message = `OpenAI API error: ${res.status}`;
+                let body = null;
+                try {
+                    body = await res.json();
+                    if (typeof body === "object" && body !== null && "error" in body) {
+                        const err = body.error;
+                        if (err?.message) {
+                            message = `OpenAI API error ${res.status}: ${err.message}`;
+                        }
+                    }
+                }
+                catch {
+                    // ignore parse errors
+                }
+                throw new OpenAiError(message, res.status, body);
+            }
+            return await res.text();
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof OpenAiError)
+                throw error;
+            throw new OpenAiError(`OpenAI request failed: ${error}`, 500);
+        }
+    }
+    // POST v1 namespace
+    const postV1 = {
+        chat: {
+            // POST https://api.openai.com/v1/chat/completions/{id}
+            // Docs: https://platform.openai.com/docs/api-reference
+            completions: Object.assign(async (reqOrId, reqOrSignal, signal) => {
+                // Overload: update stored completion (POST /chat/completions/{id})
+                if (typeof reqOrId === "string") {
+                    const id = reqOrId;
+                    const req = reqOrSignal;
+                    const actualSignal = signal;
+                    return makeRequest(`/chat/completions/${encodeURIComponent(id)}`, jsonRequest(req), actualSignal);
+                }
+                // Default: create chat completion (POST /chat/completions)
+                return makeRequest("/chat/completions", jsonRequest(reqOrId), reqOrSignal);
+            }, {
+                schema: OpenAiChatRequestSchema,
+            }),
+        },
+        audio: {
+            // POST https://api.openai.com/v1/audio/speech
+            // Docs: https://platform.openai.com/docs/api-reference
+            speech: Object.assign(async (req, signal) => {
+                return makeBinaryRequest("/audio/speech", jsonRequest(req), signal);
+            }, {
+                schema: OpenAiSpeechRequestSchema,
+            }),
+            // POST https://api.openai.com/v1/audio/transcriptions
+            // Docs: https://platform.openai.com/docs/api-reference
+            transcriptions: Object.assign(async (req, signal) => {
+                const form = new FormData();
+                form.append("file", req.file);
+                form.append("model", req.model);
+                if (req.response_format !== undefined)
+                    form.append("response_format", req.response_format);
+                if (req.language !== undefined)
+                    form.append("language", req.language);
+                if (req.prompt !== undefined)
+                    form.append("prompt", req.prompt);
+                if (req.temperature !== undefined)
+                    form.append("temperature", String(req.temperature));
+                return makeRequest("/audio/transcriptions", { headers: {}, body: form }, signal);
+            }, {
+                schema: OpenAiTranscribeRequestSchema,
+            }),
+            // POST https://api.openai.com/v1/audio/translations
+            // Docs: https://platform.openai.com/docs/api-reference
+            translations: Object.assign(async (req, signal) => {
+                const form = new FormData();
+                form.append("file", req.file);
+                form.append("model", req.model);
+                if (req.response_format !== undefined)
+                    form.append("response_format", req.response_format);
+                if (req.prompt !== undefined)
+                    form.append("prompt", req.prompt);
+                if (req.temperature !== undefined)
+                    form.append("temperature", String(req.temperature));
+                return makeRequest("/audio/translations", { headers: {}, body: form }, signal);
+            }, {
+                schema: OpenAiTranslateRequestSchema,
+            }),
+        },
+        // POST https://api.openai.com/v1/embeddings
+        // Docs: https://platform.openai.com/docs/api-reference
+        embeddings: Object.assign(async (req, signal) => {
+            return makeRequest("/embeddings", jsonRequest(req), signal);
+        }, {
+            schema: OpenAiEmbeddingRequestSchema,
+        }),
+        images: {
+            // POST https://api.openai.com/v1/images/generations
+            // Docs: https://platform.openai.com/docs/api-reference
+            generations: Object.assign(async (req, signal) => {
+                return makeRequest("/images/generations", jsonRequest({ moderation: "low", ...req }), signal);
+            }, {
+                schema: OpenAiImageGenerationRequestSchema,
+            }),
+            // POST https://api.openai.com/v1/images/edits
+            // Docs: https://platform.openai.com/docs/api-reference
+            edits: Object.assign(async (req, signal) => {
+                const form = new FormData();
+                if (Array.isArray(req.image)) {
+                    for (const img of req.image) {
+                        form.append("image", img);
+                    }
+                }
+                else {
+                    form.append("image", req.image);
+                }
+                form.append("prompt", req.prompt);
+                if (req.mask !== undefined)
+                    form.append("mask", req.mask);
+                if (req.model !== undefined)
+                    form.append("model", req.model);
+                if (req.n !== undefined)
+                    form.append("n", String(req.n));
+                if (req.size !== undefined)
+                    form.append("size", req.size);
+                if (req.quality !== undefined)
+                    form.append("quality", req.quality);
+                if (req.output_format !== undefined)
+                    form.append("output_format", req.output_format);
+                if (req.response_format !== undefined)
+                    form.append("response_format", req.response_format);
+                if (req.background !== undefined)
+                    form.append("background", req.background);
+                if (req.input_fidelity !== undefined)
+                    form.append("input_fidelity", req.input_fidelity);
+                if (req.output_compression !== undefined)
+                    form.append("output_compression", String(req.output_compression));
+                if (req.user !== undefined)
+                    form.append("user", req.user);
+                return makeRequest("/images/edits", { headers: {}, body: form }, signal);
+            }, {
+                schema: OpenAiImageEditRequestSchema,
+            }),
+            // POST https://api.openai.com/v1/images/variations
+            // Docs: https://platform.openai.com/docs/api-reference
+            variations: Object.assign(async (req, signal) => {
+                const form = new FormData();
+                form.append("image", req.image);
+                if (req.model !== undefined)
+                    form.append("model", req.model);
+                if (req.n !== undefined)
+                    form.append("n", String(req.n));
+                if (req.response_format !== undefined)
+                    form.append("response_format", req.response_format);
+                if (req.size !== undefined)
+                    form.append("size", req.size);
+                if (req.user !== undefined)
+                    form.append("user", req.user);
+                return makeRequest("/images/variations", { headers: {}, body: form }, signal);
+            }, {
+                schema: OpenAiImageVariationRequestSchema,
+            }),
+        },
+        // POST https://api.openai.com/v1/files
+        // Docs: https://platform.openai.com/docs/api-reference
+        files: Object.assign(async (req, signal) => {
+            const form = new FormData();
+            form.append("file", req.file);
+            form.append("purpose", req.purpose);
+            if (req.expires_after !== undefined) {
+                form.append("expires_after", JSON.stringify(req.expires_after));
+            }
+            return makeRequest("/files", { headers: {}, body: form }, signal);
+        }, {
+            schema: OpenAiFileUploadRequestSchema,
+        }),
+        // POST https://api.openai.com/v1/moderations
+        // Docs: https://platform.openai.com/docs/api-reference
+        moderations: Object.assign(async (req, signal) => {
+            return makeRequest("/moderations", jsonRequest(req), signal);
+        }, {
+            schema: OpenAiModerationRequestSchema,
+        }),
+        // POST https://api.openai.com/v1/responses
+        // Docs: https://platform.openai.com/docs/api-reference
+        responses: Object.assign(async (req, signal) => {
+            return makeRequest("/responses", jsonRequest(req), signal);
+        }, {
+            schema: OpenAiResponseRequestSchema,
+            // POST https://api.openai.com/v1/responses/compact
+            // Docs: https://platform.openai.com/docs/api-reference
+            compact: Object.assign(async (req, signal) => {
+                return makeRequest("/responses/compact", jsonRequest(req), signal);
+            }, {
+                schema: OpenAiResponseCompactRequestSchema,
+            }),
+            // POST https://api.openai.com/v1/responses/input_tokens
+            // Docs: https://platform.openai.com/docs/api-reference
+            inputTokens: Object.assign(async (req, signal) => {
+                return makeRequest("/responses/input_tokens", jsonRequest(req), signal);
+            }, {
+                schema: OpenAiResponseInputTokensRequestSchema,
+            }),
+            // POST https://api.openai.com/v1/responses/{id}/cancel
+            // Docs: https://platform.openai.com/docs/api-reference
+            cancel: Object.assign(async (id, signal) => {
+                return makeEmptyPostRequest(`/responses/${encodeURIComponent(id)}/cancel`, signal);
+            }, {}),
+        }),
+        // POST https://api.openai.com/v1/batches
+        // Docs: https://platform.openai.com/docs/api-reference
+        batches: Object.assign(async (req, signal) => {
+            return makeRequest("/batches", jsonRequest(req), signal);
+        }, {
+            schema: OpenAiBatchCreateRequestSchema,
+            // POST https://api.openai.com/v1/batches/{id}/cancel
+            // Docs: https://platform.openai.com/docs/api-reference
+            cancel: Object.assign(async (id, signal) => {
+                return makeEmptyPostRequest(`/batches/${encodeURIComponent(id)}/cancel`, signal);
+            }, {}),
+        }),
+        fineTuning: {
+            // POST https://api.openai.com/v1/fine_tuning/jobs
+            // Docs: https://platform.openai.com/docs/api-reference
+            jobs: Object.assign(async (req, signal) => {
+                return makeRequest("/fine_tuning/jobs", jsonRequest(req), signal);
+            }, {
+                schema: OpenAiFineTuningJobCreateRequestSchema,
+                // POST https://api.openai.com/v1/fine_tuning/jobs/{id}/cancel
+                // Docs: https://platform.openai.com/docs/api-reference
+                cancel: Object.assign(async (id, signal) => {
+                    return makeEmptyPostRequest(`/fine_tuning/jobs/${encodeURIComponent(id)}/cancel`, signal);
+                }, {}),
+                // POST https://api.openai.com/v1/fine_tuning/jobs/{id}/pause
+                // Docs: https://platform.openai.com/docs/api-reference
+                pause: Object.assign(async (id, signal) => {
+                    return makeEmptyPostRequest(`/fine_tuning/jobs/${encodeURIComponent(id)}/pause`, signal);
+                }, {}),
+                // POST https://api.openai.com/v1/fine_tuning/jobs/{id}/resume
+                // Docs: https://platform.openai.com/docs/api-reference
+                resume: Object.assign(async (id, signal) => {
+                    return makeEmptyPostRequest(`/fine_tuning/jobs/${encodeURIComponent(id)}/resume`, signal);
+                }, {}),
+            }),
+            checkpoints: {
+                // POST https://api.openai.com/v1/fine_tuning/checkpoints/{checkpoint}/permissions
+                // Docs: https://platform.openai.com/docs/api-reference
+                permissions: Object.assign(async (checkpoint, req, signal) => {
+                    return makeRequest(`/fine_tuning/checkpoints/${encodeURIComponent(checkpoint)}/permissions`, jsonRequest(req), signal);
+                }, {
+                    schema: OpenAiCheckpointPermissionCreateRequestSchema,
+                }),
+            },
+        },
+    };
+    // GET v1 namespace
+    const getV1 = {
+        chat: {
+            // GET https://api.openai.com/v1/chat/completions/{idOrOpts}
+            // Docs: https://platform.openai.com/docs/api-reference
+            completions: Object.assign(async (idOrOpts, signal) => {
+                if (typeof idOrOpts === "string") {
+                    // GET /chat/completions/{id}
+                    return makeGetRequest(`/chat/completions/${encodeURIComponent(idOrOpts)}`, undefined, signal);
+                }
+                // GET /chat/completions (list)
+                const query = {};
+                if (idOrOpts?.after)
+                    query.after = idOrOpts.after;
+                if (idOrOpts?.limit !== undefined)
+                    query.limit = String(idOrOpts.limit);
+                if (idOrOpts?.order)
+                    query.order = idOrOpts.order;
+                if (idOrOpts?.metadata) {
+                    for (const [k, v] of Object.entries(idOrOpts.metadata)) {
+                        query[`metadata[${k}]`] = v;
+                    }
+                }
+                return makeGetRequest("/chat/completions", query, signal);
+            }, {
+                // GET https://api.openai.com/v1/chat/completions/{id}/messages
+                // Docs: https://platform.openai.com/docs/api-reference
+                messages: async (id, opts, signal) => {
+                    const query = {};
+                    if (opts?.after)
+                        query.after = opts.after;
+                    if (opts?.limit !== undefined)
+                        query.limit = String(opts.limit);
+                    if (opts?.order)
+                        query.order = opts.order;
+                    return makeGetRequest(`/chat/completions/${encodeURIComponent(id)}/messages`, query, signal);
+                },
+            }),
+        },
+        // GET https://api.openai.com/v1/files/{idOrOpts}
+        // Docs: https://platform.openai.com/docs/api-reference
+        files: Object.assign(async (idOrOpts, signal) => {
+            if (typeof idOrOpts === "string") {
+                // GET /files/{id}
+                return makeGetRequest(`/files/${encodeURIComponent(idOrOpts)}`, undefined, signal);
+            }
+            // GET /files (list)
+            const query = {};
+            if (idOrOpts?.purpose !== undefined)
+                query.purpose = idOrOpts.purpose;
+            if (idOrOpts?.limit !== undefined)
+                query.limit = String(idOrOpts.limit);
+            if (idOrOpts?.order !== undefined)
+                query.order = idOrOpts.order;
+            if (idOrOpts?.after !== undefined)
+                query.after = idOrOpts.after;
+            return makeGetRequest("/files", query, signal);
+        }, {
+            // GET https://api.openai.com/v1/files/{id}/content
+            // Docs: https://platform.openai.com/docs/api-reference
+            content: async (id, signal) => {
+                return makeGetTextRequest(`/files/${encodeURIComponent(id)}/content`, signal);
+            },
+        }),
+        // GET https://api.openai.com/v1/models/{id}
+        // Docs: https://platform.openai.com/docs/api-reference
+        models: Object.assign(async (id, signal) => {
+            if (typeof id === "string") {
+                // GET /models/{id}
+                return makeGetRequest(`/models/${encodeURIComponent(id)}`, undefined, signal);
+            }
+            // GET /models (list)
+            return makeGetRequest("/models", undefined, typeof id === "object" ? id : signal // Handle signal as first param
+            );
+        }, {}),
+        // GET https://api.openai.com/v1/responses/{id}
+        // Docs: https://platform.openai.com/docs/api-reference
+        responses: Object.assign(async (id, opts, signal) => {
+            return makeGetRequest(`/responses/${encodeURIComponent(id)}`, {
+                include: opts?.include,
+                stream: opts?.stream,
+            }, signal);
+        }, {
+            // GET https://api.openai.com/v1/responses/{id}/input_items
+            // Docs: https://platform.openai.com/docs/api-reference
+            inputItems: async (id, opts, signal) => {
+                return makeGetRequest(`/responses/${encodeURIComponent(id)}/input_items`, {
+                    after: opts?.after,
+                    limit: opts?.limit !== undefined ? String(opts.limit) : undefined,
+                    order: opts?.order,
+                    include: opts?.include,
+                }, signal);
+            },
+        }),
+        // GET https://api.openai.com/v1/batches/{idOrOpts}
+        // Docs: https://platform.openai.com/docs/api-reference
+        batches: Object.assign(async (idOrOpts, signal) => {
+            if (typeof idOrOpts === "string") {
+                // GET /batches/{id}
+                return makeGetRequest(`/batches/${encodeURIComponent(idOrOpts)}`, undefined, signal);
+            }
+            // GET /batches (list)
+            return makeGetRequest("/batches", {
+                after: idOrOpts?.after,
+                limit: idOrOpts?.limit !== undefined
+                    ? String(idOrOpts.limit)
+                    : undefined,
+            }, signal);
+        }, {}),
+        fineTuning: {
+            // GET https://api.openai.com/v1/fine_tuning/jobs/{idOrOpts}
+            // Docs: https://platform.openai.com/docs/api-reference
+            jobs: Object.assign(async (idOrOpts, signal) => {
+                if (typeof idOrOpts === "string") {
+                    // GET /fine_tuning/jobs/{id}
+                    return makeGetRequest(`/fine_tuning/jobs/${encodeURIComponent(idOrOpts)}`, undefined, signal);
+                }
+                // GET /fine_tuning/jobs (list)
+                const query = {};
+                const opts = idOrOpts;
+                if (opts?.after)
+                    query.after = opts.after;
+                if (opts?.limit !== undefined)
+                    query.limit = String(opts.limit);
+                if (opts?.metadata) {
+                    for (const [k, v] of Object.entries(opts.metadata)) {
+                        query[`metadata[${k}]`] = v;
+                    }
+                }
+                return makeGetRequest("/fine_tuning/jobs", query, signal);
+            }, {
+                // GET https://api.openai.com/v1/fine_tuning/jobs/{id}/events
+                // Docs: https://platform.openai.com/docs/api-reference
+                events: async (id, opts, signal) => {
+                    const query = {};
+                    if (opts?.after)
+                        query.after = opts.after;
+                    if (opts?.limit !== undefined)
+                        query.limit = String(opts.limit);
+                    return makeGetRequest(`/fine_tuning/jobs/${encodeURIComponent(id)}/events`, query, signal);
+                },
+                // GET https://api.openai.com/v1/fine_tuning/jobs/{id}/checkpoints
+                // Docs: https://platform.openai.com/docs/api-reference
+                checkpoints: async (id, opts, signal) => {
+                    const query = {};
+                    if (opts?.after)
+                        query.after = opts.after;
+                    if (opts?.limit !== undefined)
+                        query.limit = String(opts.limit);
+                    return makeGetRequest(`/fine_tuning/jobs/${encodeURIComponent(id)}/checkpoints`, query, signal);
+                },
+            }),
+            checkpoints: {
+                // GET https://api.openai.com/v1/fine_tuning/checkpoints/{checkpoint}/permissions
+                // Docs: https://platform.openai.com/docs/api-reference
+                permissions: async (checkpoint, opts, signal) => {
+                    const query = {};
+                    if (opts?.after)
+                        query.after = opts.after;
+                    if (opts?.limit !== undefined)
+                        query.limit = String(opts.limit);
+                    if (opts?.order)
+                        query.order = opts.order;
+                    if (opts?.project_id)
+                        query.project_id = opts.project_id;
+                    return makeGetRequest(`/fine_tuning/checkpoints/${encodeURIComponent(checkpoint)}/permissions`, query, signal);
+                },
+            },
+        },
+    };
+    // DELETE v1 namespace
+    const deleteV1 = {
+        chat: {
+            // DELETE https://api.openai.com/v1/chat/completions/{id}
+            // Docs: https://platform.openai.com/docs/api-reference
+            completions: async (id, signal) => {
+                return makeDeleteRequest(`/chat/completions/${encodeURIComponent(id)}`, signal);
+            },
+        },
+        // DELETE https://api.openai.com/v1/files/{id}
+        // Docs: https://platform.openai.com/docs/api-reference
+        files: async (id, signal) => {
+            return makeDeleteRequest(`/files/${encodeURIComponent(id)}`, signal);
+        },
+        // DELETE https://api.openai.com/v1/models/{id}
+        // Docs: https://platform.openai.com/docs/api-reference
+        models: async (id, signal) => {
+            return makeDeleteRequest(`/models/${encodeURIComponent(id)}`, signal);
+        },
+        // DELETE https://api.openai.com/v1/responses/{id}
+        // Docs: https://platform.openai.com/docs/api-reference
+        responses: async (id, signal) => {
+            return makeDeleteRequest(`/responses/${encodeURIComponent(id)}`, signal);
+        },
+        fineTuning: {
+            checkpoints: {
+                // DELETE https://api.openai.com/v1/fine_tuning/checkpoints/{checkpoint}/permissions/{permissionId}
+                // Docs: https://platform.openai.com/docs/api-reference
+                permissions: async (checkpoint, permissionId, signal) => {
+                    return makeDeleteRequest(`/fine_tuning/checkpoints/${encodeURIComponent(checkpoint)}/permissions/${encodeURIComponent(permissionId)}`, signal);
+                },
+            },
+        },
+    };
+    return attachExamples({
+        post: { v1: postV1 },
+        get: { v1: getV1 },
+        delete: { v1: deleteV1 },
+    });
+}
+//# sourceMappingURL=openai.js.map