UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

66 lines (58 loc) • 2.86 kB
import type { OcxDocumentContent } from "../types"; const DATA_URL = /^data:([^;,]+)((?:;[^;,]*)*),(.*)$/s; const BASE64_PAYLOAD = /^[A-Za-z0-9+/]+={0,2}$/; function usableBase64(payload: string): boolean { if (!BASE64_PAYLOAD.test(payload)) return false; // Preserve valid unpadded encodings, but a single sextet cannot represent any byte. // Padding, when present, must complete a four-character quantum. No payload allocation. return payload.endsWith("=") ? payload.length % 4 === 0 : payload.length % 4 !== 1; } /** The one marker vocabulary for an attached document, derived from what the part knows. */ export function inlineDocumentMarker(filename: string | undefined): string { return filename !== undefined && filename.length > 0 ? `[document: ${filename}]` : "[document]"; } /** * An inline document part from a `data:` URL, or `undefined` when there are no usable bytes. * * A reference with no payload — a `file_id`, a bare filename — is deliberately not a document: * there is nothing to carry, and minting a part for it would claim an attachment the request * never contained. Those keep the marker path they already had. */ export function inlineDocumentFromDataUrl( fileData: string | undefined, filename: string | undefined, ): OcxDocumentContent | undefined { if (typeof fileData !== "string" || fileData.length === 0) return undefined; const match = DATA_URL.exec(fileData); if (!match) return undefined; const mediaType = match[1]!; const payload = match[3]!; if (!hasBase64Parameter(match[2] ?? "") || !usableBase64(payload)) return undefined; return { type: "document", text: inlineDocumentMarker(filename), mediaType, data: payload, ...(filename !== undefined && filename.length > 0 ? { filename } : {}), }; } /** The `data:` URL spelling of a document part, for wires whose counterpart takes one. */ export function inlineDocumentDataUrl(part: OcxDocumentContent): string { return `data:${part.mediaType};base64,${part.data}`; } /** * Whether this string is a `data:` URL this module would actually decode. * * The media-type scanner and this parser have to agree exactly. A looser scanner would exempt an * attachment from the untranslated-media refusal that the parser then reduces to a marker, which * is the silent drop the refusal exists to prevent. `;base64` must be a whole parameter token, * not a substring of one: `;notbase64,` and `;x=base64,` are not base64 payloads. */ export function isInlineDocumentDataUrl(value: unknown): boolean { if (typeof value !== "string" || value.length === 0) return false; const match = DATA_URL.exec(value); return match !== null && hasBase64Parameter(match[2] ?? "") && usableBase64(match[3]!); } function hasBase64Parameter(parameters: string): boolean { return parameters.split(";").includes("base64"); }