cencori 1.2.1 → 1.3.0

package/dist/react/index.mjs

@@ -0,0 +1,367 @@
+// src/react/vision/vision-format-banner.tsx
+import { ImageIcon, Info } from "lucide-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var UNIVERSAL_FORMATS = ["JPEG", "PNG", "WEBP", "GIF"];
+var PROVIDER_LIMITS = {
+  openai: { formats: ["JPEG", "PNG", "WEBP", "GIF"], maxMB: 20, notes: "Non-animated GIFs only." },
+  anthropic: { formats: ["JPEG", "PNG", "WEBP", "GIF"], maxMB: 5, notes: "Max 8000\xD78000 dimensions." },
+  google: { formats: ["JPEG", "PNG", "WEBP", "GIF", "HEIC", "HEIF"], maxMB: 20, notes: "HEIC/HEIF supported." }
+};
+function joinClasses(...parts) {
+  return parts.filter(Boolean).join(" ");
+}
+function VisionFormatBanner({
+  provider,
+  variant = "info",
+  className,
+  title
+}) {
+  const info = provider ? PROVIDER_LIMITS[provider] : { formats: UNIVERSAL_FORMATS, maxMB: 5, notes: "These formats work across every supported provider." };
+  const heading = title ?? (provider ? `Supported for ${providerLabel(provider)}` : "Supported image formats");
+  const base = variant === "info" ? "bg-blue-50 border-blue-200 text-blue-900 dark:bg-blue-950/40 dark:border-blue-900 dark:text-blue-100" : "bg-neutral-50 border-neutral-200 text-neutral-800 dark:bg-neutral-900 dark:border-neutral-800 dark:text-neutral-100";
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      role: "note",
+      className: joinClasses(
+        "flex gap-3 rounded-lg border p-4 text-sm",
+        base,
+        className
+      ),
+      children: [
+        /* @__PURE__ */ jsx("div", { className: "flex-shrink-0 pt-0.5", children: /* @__PURE__ */ jsx(Info, { className: "h-5 w-5 opacity-70", "aria-hidden": true }) }),
+        /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-2", children: [
+          /* @__PURE__ */ jsx("p", { className: "font-medium", children: heading }),
+          /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1.5", children: info.formats.map((f) => /* @__PURE__ */ jsxs(
+            "span",
+            {
+              className: "inline-flex items-center gap-1 rounded-md border border-current/20 bg-white/50 px-2 py-0.5 text-xs font-medium dark:bg-black/20",
+              children: [
+                /* @__PURE__ */ jsx(ImageIcon, { className: "h-3 w-3 opacity-70", "aria-hidden": true }),
+                f
+              ]
+            },
+            f
+          )) }),
+          /* @__PURE__ */ jsxs("p", { className: "text-xs opacity-80", children: [
+            "Up to ",
+            /* @__PURE__ */ jsxs("strong", { children: [
+              info.maxMB,
+              "MB"
+            ] }),
+            " per image. ",
+            info.notes
+          ] })
+        ] })
+      ]
+    }
+  );
+}
+function providerLabel(p) {
+  if (p === "openai") return "OpenAI";
+  if (p === "anthropic") return "Anthropic";
+  return "Google";
+}
+
+// src/react/vision/vision-uploader.tsx
+import { useCallback, useMemo, useRef, useState } from "react";
+import { AlertCircle, Loader2, Upload, X } from "lucide-react";
+
+// src/react/vision/downscale.ts
+var DOWNSCALABLE_TYPES = /* @__PURE__ */ new Set(["image/jpeg", "image/png", "image/webp"]);
+function canDownscale(mimeType) {
+  return DOWNSCALABLE_TYPES.has(mimeType.toLowerCase());
+}
+async function downscaleImage(file, maxBytes, options = {}) {
+  const originalBytes = file.size;
+  if (originalBytes <= maxBytes) {
+    return { file, originalBytes, finalBytes: originalBytes, steps: 0 };
+  }
+  if (!canDownscale(file.type)) {
+    throw new Error(`Cannot auto-compress ${file.type}. Please upload a smaller image.`);
+  }
+  const bitmap = await createImageBitmap(file);
+  let { width, height } = bitmap;
+  const minDim = options.minDimension ?? 320;
+  let quality = 0.9;
+  const qFloor = options.qualityFloor ?? 0.5;
+  const outputType = "image/jpeg";
+  let steps = 0;
+  let bytes = originalBytes;
+  let outFile = file;
+  while (bytes > maxBytes && steps < 8) {
+    steps += 1;
+    if (Math.min(width, height) > minDim && steps <= 4) {
+      width = Math.floor(width * 0.75);
+      height = Math.floor(height * 0.75);
+    } else if (quality > qFloor) {
+      quality = Math.max(qFloor, quality - 0.15);
+    } else {
+      break;
+    }
+    const canvas = typeof OffscreenCanvas !== "undefined" ? new OffscreenCanvas(width, height) : Object.assign(document.createElement("canvas"), { width, height });
+    const ctx = canvas.getContext("2d");
+    if (!ctx) throw new Error("Canvas 2D context unavailable");
+    ctx.drawImage(bitmap, 0, 0, width, height);
+    const blob = canvas instanceof OffscreenCanvas ? await canvas.convertToBlob({ type: outputType, quality }) : await new Promise((resolve, reject) => {
+      canvas.toBlob(
+        (b) => b ? resolve(b) : reject(new Error("toBlob returned null")),
+        outputType,
+        quality
+      );
+    });
+    bytes = blob.size;
+    outFile = new File([blob], renameToJpeg(file.name), { type: outputType, lastModified: Date.now() });
+  }
+  bitmap.close?.();
+  if (bytes > maxBytes) {
+    throw new Error(`Could not compress image below the ${(maxBytes / (1024 * 1024)).toFixed(1)}MB limit.`);
+  }
+  return { file: outFile, originalBytes, finalBytes: bytes, steps };
+}
+function renameToJpeg(name) {
+  const dot = name.lastIndexOf(".");
+  if (dot === -1) return `${name}.jpg`;
+  return `${name.slice(0, dot)}.jpg`;
+}
+
+// src/react/vision/vision-uploader.tsx
+import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var UNIVERSAL_FORMATS2 = ["image/jpeg", "image/png", "image/webp", "image/gif"];
+var PROVIDER_RULES = {
+  openai: { formats: UNIVERSAL_FORMATS2, maxBytes: 20 * 1024 * 1024 },
+  anthropic: { formats: UNIVERSAL_FORMATS2, maxBytes: 5 * 1024 * 1024 },
+  google: { formats: [...UNIVERSAL_FORMATS2, "image/heic", "image/heif"], maxBytes: 20 * 1024 * 1024 }
+};
+function rulesFor(provider) {
+  if (provider) return PROVIDER_RULES[provider];
+  return { formats: UNIVERSAL_FORMATS2, maxBytes: 5 * 1024 * 1024 };
+}
+function formatBytes(bytes) {
+  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+  return `${(bytes / 1024).toFixed(0)}KB`;
+}
+function friendlyFormats(mimes) {
+  return mimes.map((m) => m.replace("image/", "").toUpperCase()).join(", ");
+}
+function joinClasses2(...parts) {
+  return parts.filter(Boolean).join(" ");
+}
+function VisionUploader({
+  endpoint = "/api/ai/vision",
+  apiKey,
+  task = "analyze",
+  provider,
+  model,
+  prompt,
+  onResult,
+  onError,
+  hideBanner = false,
+  autoCompress = true,
+  headers,
+  className
+}) {
+  const [file, setFile] = useState(null);
+  const [preview, setPreview] = useState(null);
+  const [error, setError] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [result, setResult] = useState(null);
+  const [dragging, setDragging] = useState(false);
+  const [notice, setNotice] = useState(null);
+  const inputRef = useRef(null);
+  const rules = useMemo(() => rulesFor(provider), [provider]);
+  const targetUrl = task === "analyze" ? endpoint : `${endpoint.replace(/\/$/, "")}/${task}`;
+  const acceptFile = useCallback(async (f) => {
+    setResult(null);
+    setNotice(null);
+    let effective = f;
+    const mime = (f.type || "").toLowerCase();
+    if (!rules.formats.includes(mime)) {
+      const err = {
+        code: "unsupported_format",
+        message: `"${f.name}" is ${mime || "an unknown type"}. Please upload one of: ${friendlyFormats(rules.formats)}.`
+      };
+      setError(err);
+      setFile(null);
+      setPreview(null);
+      onError?.(err);
+      return;
+    }
+    if (f.size > rules.maxBytes) {
+      if (autoCompress && canDownscale(mime)) {
+        try {
+          const result2 = await downscaleImage(f, rules.maxBytes);
+          effective = result2.file;
+          setNotice(
+            `Compressed from ${formatBytes(result2.originalBytes)} to ${formatBytes(result2.finalBytes)} to fit the ${provider ?? "universal"} limit.`
+          );
+        } catch (compressErr) {
+          const err = {
+            code: "image_too_large",
+            message: compressErr instanceof Error ? compressErr.message : `"${f.name}" is ${formatBytes(f.size)} \u2014 the limit is ${formatBytes(rules.maxBytes)}${provider ? ` for ${provider}` : ""}.`
+          };
+          setError(err);
+          setFile(null);
+          setPreview(null);
+          onError?.(err);
+          return;
+        }
+      } else {
+        const err = {
+          code: "image_too_large",
+          message: `"${f.name}" is ${formatBytes(f.size)} \u2014 the limit is ${formatBytes(rules.maxBytes)}${provider ? ` for ${provider}` : ""}.`
+        };
+        setError(err);
+        setFile(null);
+        setPreview(null);
+        onError?.(err);
+        return;
+      }
+    }
+    setError(null);
+    setFile(effective);
+    setPreview(URL.createObjectURL(effective));
+  }, [rules, provider, autoCompress, onError]);
+  const handleDrop = useCallback((e) => {
+    e.preventDefault();
+    setDragging(false);
+    const f = e.dataTransfer.files?.[0];
+    if (f) acceptFile(f);
+  }, [acceptFile]);
+  const handleSubmit = useCallback(async () => {
+    if (!file) return;
+    setLoading(true);
+    setError(null);
+    setResult(null);
+    try {
+      const form = new FormData();
+      form.append("file", file);
+      if (prompt && task === "analyze") form.append("prompt", prompt);
+      if (model) form.append("model", model);
+      const requestHeaders = { ...headers ?? {} };
+      if (apiKey) requestHeaders.Authorization = `Bearer ${apiKey}`;
+      const res = await fetch(targetUrl, {
+        method: "POST",
+        headers: Object.keys(requestHeaders).length ? requestHeaders : void 0,
+        body: form
+      });
+      const data = await res.json();
+      if (!res.ok) {
+        const err = {
+          code: data && typeof data === "object" && "error" in data ? String(data.error) : "request_failed",
+          message: data && typeof data === "object" && "message" in data ? String(data.message) : `Request failed with status ${res.status}`
+        };
+        setError(err);
+        onError?.(err);
+        return;
+      }
+      setResult(data);
+      onResult?.(data);
+    } catch (err) {
+      const e = { code: "network_error", message: err instanceof Error ? err.message : "Network error" };
+      setError(e);
+      onError?.(e);
+    } finally {
+      setLoading(false);
+    }
+  }, [file, prompt, model, task, targetUrl, apiKey, headers, onResult, onError]);
+  const clear = useCallback(() => {
+    setFile(null);
+    setPreview(null);
+    setResult(null);
+    setError(null);
+    setNotice(null);
+    if (inputRef.current) inputRef.current.value = "";
+  }, []);
+  return /* @__PURE__ */ jsxs2("div", { className: joinClasses2("flex flex-col gap-3", className), children: [
+    !hideBanner && /* @__PURE__ */ jsx2(VisionFormatBanner, { provider }),
+    /* @__PURE__ */ jsxs2(
+      "div",
+      {
+        onDragOver: (e) => {
+          e.preventDefault();
+          setDragging(true);
+        },
+        onDragLeave: () => setDragging(false),
+        onDrop: handleDrop,
+        onClick: () => inputRef.current?.click(),
+        role: "button",
+        tabIndex: 0,
+        "aria-label": "Upload image",
+        className: joinClasses2(
+          "flex cursor-pointer flex-col items-center justify-center gap-2 rounded-xl border-2 border-dashed p-8 text-center transition",
+          dragging ? "border-blue-500 bg-blue-50 dark:bg-blue-950/30" : "border-neutral-300 hover:border-neutral-400 dark:border-neutral-700 dark:hover:border-neutral-600"
+        ),
+        children: [
+          preview ? /* @__PURE__ */ jsxs2("div", { className: "relative", children: [
+            /* @__PURE__ */ jsx2("img", { src: preview, alt: "Preview", className: "max-h-64 rounded-lg object-contain" }),
+            /* @__PURE__ */ jsx2(
+              "button",
+              {
+                type: "button",
+                onClick: (e) => {
+                  e.stopPropagation();
+                  clear();
+                },
+                className: "absolute -right-2 -top-2 rounded-full bg-white p-1 shadow ring-1 ring-neutral-200 hover:bg-neutral-100 dark:bg-neutral-900 dark:ring-neutral-700",
+                "aria-label": "Remove image",
+                children: /* @__PURE__ */ jsx2(X, { className: "h-4 w-4" })
+              }
+            )
+          ] }) : /* @__PURE__ */ jsxs2(Fragment, { children: [
+            /* @__PURE__ */ jsx2(Upload, { className: "h-8 w-8 text-neutral-400", "aria-hidden": true }),
+            /* @__PURE__ */ jsx2("p", { className: "text-sm font-medium", children: "Drop an image or click to upload" }),
+            /* @__PURE__ */ jsxs2("p", { className: "text-xs text-neutral-500", children: [
+              friendlyFormats(rules.formats),
+              " \xB7 up to ",
+              formatBytes(rules.maxBytes)
+            ] })
+          ] }),
+          /* @__PURE__ */ jsx2(
+            "input",
+            {
+              ref: inputRef,
+              type: "file",
+              accept: rules.formats.join(","),
+              className: "hidden",
+              onChange: (e) => {
+                const f = e.target.files?.[0];
+                if (f) acceptFile(f);
+              }
+            }
+          )
+        ]
+      }
+    ),
+    error && /* @__PURE__ */ jsxs2("div", { role: "alert", className: "flex items-start gap-2 rounded-lg border border-red-200 bg-red-50 p-3 text-sm text-red-900 dark:border-red-900 dark:bg-red-950/40 dark:text-red-100", children: [
+      /* @__PURE__ */ jsx2(AlertCircle, { className: "mt-0.5 h-4 w-4 flex-shrink-0", "aria-hidden": true }),
+      /* @__PURE__ */ jsxs2("div", { children: [
+        /* @__PURE__ */ jsx2("p", { className: "font-medium", children: "Can't process this image" }),
+        /* @__PURE__ */ jsx2("p", { className: "text-xs opacity-90", children: error.message })
+      ] })
+    ] }),
+    notice && !error && /* @__PURE__ */ jsx2("p", { className: "text-xs text-neutral-500 dark:text-neutral-400", children: notice }),
+    file && !loading && !result && /* @__PURE__ */ jsx2(
+      "button",
+      {
+        type: "button",
+        onClick: handleSubmit,
+        className: "inline-flex items-center justify-center rounded-lg bg-neutral-900 px-4 py-2 text-sm font-medium text-white transition hover:bg-neutral-800 dark:bg-white dark:text-neutral-900 dark:hover:bg-neutral-100",
+        children: "Analyze image"
+      }
+    ),
+    loading && /* @__PURE__ */ jsxs2("div", { className: "inline-flex items-center gap-2 text-sm text-neutral-600 dark:text-neutral-400", children: [
+      /* @__PURE__ */ jsx2(Loader2, { className: "h-4 w-4 animate-spin", "aria-hidden": true }),
+      "Analyzing\u2026"
+    ] }),
+    result !== null && /* @__PURE__ */ jsxs2("div", { className: "rounded-lg border border-neutral-200 bg-neutral-50 p-3 text-sm dark:border-neutral-800 dark:bg-neutral-900", children: [
+      /* @__PURE__ */ jsx2("p", { className: "mb-1 text-xs font-medium uppercase text-neutral-500", children: "Result" }),
+      /* @__PURE__ */ jsx2("pre", { className: "overflow-auto whitespace-pre-wrap break-words text-xs", children: typeof result === "string" ? result : JSON.stringify(result, null, 2) })
+    ] })
+  ] });
+}
+export {
+  VisionFormatBanner,
+  VisionUploader
+};
+//# sourceMappingURL=index.mjs.map

package/dist/react/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/vision/vision-format-banner.tsx","../../src/react/vision/vision-uploader.tsx","../../src/react/vision/downscale.ts"],"sourcesContent":["/**\n * VisionFormatBanner\n *\n * Drop-in banner that documents the supported image formats and size limits\n * for the Cencori Vision API. Zero external state — safe to embed anywhere,\n * including inside a customer's own product.\n *\n * Deps: react, lucide-react, tailwindcss.\n */\n\n'use client';\n\nimport { ImageIcon, Info } from 'lucide-react';\nimport type { ReactNode } from 'react';\n\nexport type VisionProvider = 'openai' | 'anthropic' | 'google';\n\nexport interface VisionFormatBannerProps {\n    /** Restrict displayed limits to a specific provider. Omit to show universal (all-provider) limits. */\n    provider?: VisionProvider;\n    /** Tone. */\n    variant?: 'info' | 'muted';\n    /** Extra classes. */\n    className?: string;\n    /** Optional title override. */\n    title?: ReactNode;\n}\n\nconst UNIVERSAL_FORMATS = ['JPEG', 'PNG', 'WEBP', 'GIF'];\n\nconst PROVIDER_LIMITS: Record<VisionProvider, { formats: string[]; maxMB: number; notes: string }> = {\n    openai: { formats: ['JPEG', 'PNG', 'WEBP', 'GIF'], maxMB: 20, notes: 'Non-animated GIFs only.' },\n    anthropic: { formats: ['JPEG', 'PNG', 'WEBP', 'GIF'], maxMB: 5, notes: 'Max 8000×8000 dimensions.' },\n    google: { formats: ['JPEG', 'PNG', 'WEBP', 'GIF', 'HEIC', 'HEIF'], maxMB: 20, notes: 'HEIC/HEIF supported.' },\n};\n\nfunction joinClasses(...parts: Array<string | undefined | false>): string {\n    return parts.filter(Boolean).join(' ');\n}\n\nexport function VisionFormatBanner({\n    provider,\n    variant = 'info',\n    className,\n    title,\n}: VisionFormatBannerProps) {\n    const info = provider ? PROVIDER_LIMITS[provider] : { formats: UNIVERSAL_FORMATS, maxMB: 5, notes: 'These formats work across every supported provider.' };\n    const heading = title ?? (provider ? `Supported for ${providerLabel(provider)}` : 'Supported image formats');\n\n    const base = variant === 'info'\n        ? 'bg-blue-50 border-blue-200 text-blue-900 dark:bg-blue-950/40 dark:border-blue-900 dark:text-blue-100'\n        : 'bg-neutral-50 border-neutral-200 text-neutral-800 dark:bg-neutral-900 dark:border-neutral-800 dark:text-neutral-100';\n\n    return (\n        <div\n            role=\"note\"\n            className={joinClasses(\n                'flex gap-3 rounded-lg border p-4 text-sm',\n                base,\n                className\n            )}\n        >\n            <div className=\"flex-shrink-0 pt-0.5\">\n                <Info className=\"h-5 w-5 opacity-70\" aria-hidden />\n            </div>\n            <div className=\"flex flex-col gap-2\">\n                <p className=\"font-medium\">{heading}</p>\n                <div className=\"flex flex-wrap gap-1.5\">\n                    {info.formats.map(f => (\n                        <span\n                            key={f}\n                            className=\"inline-flex items-center gap-1 rounded-md border border-current/20 bg-white/50 px-2 py-0.5 text-xs font-medium dark:bg-black/20\"\n                        >\n                            <ImageIcon className=\"h-3 w-3 opacity-70\" aria-hidden />\n                            {f}\n                        </span>\n                    ))}\n                </div>\n                <p className=\"text-xs opacity-80\">\n                    Up to <strong>{info.maxMB}MB</strong> per image. {info.notes}\n                </p>\n            </div>\n        </div>\n    );\n}\n\nfunction providerLabel(p: VisionProvider): string {\n    if (p === 'openai') return 'OpenAI';\n    if (p === 'anthropic') return 'Anthropic';\n    return 'Google';\n}\n","/**\n * VisionUploader\n *\n * Drop-in image uploader for the Cencori Vision API. Handles drag-drop,\n * client-side format + size validation, and calls the endpoint via\n * multipart/form-data. Renders clear error messages and a supported-formats\n * banner. Zero external state — safe to embed in a customer's own product.\n *\n * Usage:\n *   <VisionUploader\n *       endpoint=\"https://api.cencori.com/api/ai/vision\"\n *       apiKey={process.env.NEXT_PUBLIC_CENCORI_KEY}\n *       task=\"describe\"\n *       onResult={(result) => console.log(result)}\n *   />\n *\n * Deps: react, lucide-react, tailwindcss.\n */\n\n'use client';\n\nimport { useCallback, useMemo, useRef, useState } from 'react';\nimport { AlertCircle, Loader2, Upload, X } from 'lucide-react';\nimport { VisionFormatBanner, type VisionProvider } from './vision-format-banner';\nimport { canDownscale, downscaleImage } from './downscale';\n\n// ── Public types ────────────────────────────────────────────────\n\nexport type VisionTask = 'analyze' | 'describe' | 'ocr' | 'classify';\n\nexport interface VisionUploaderProps {\n    /** Base Vision endpoint. Defaults to same-origin `/api/ai/vision`. */\n    endpoint?: string;\n    /** Cencori API key. Sent as `Authorization: Bearer`. */\n    apiKey?: string;\n    /** Which task to run: analyze (default), describe, ocr, or classify. */\n    task?: VisionTask;\n    /** Provider to target — informs client-side validation. Defaults to universal (all providers). */\n    provider?: VisionProvider;\n    /** Optional model override. */\n    model?: string;\n    /** Custom prompt (only meaningful for task=\"analyze\"). */\n    prompt?: string;\n    /** Called on success. */\n    onResult?: (result: unknown) => void;\n    /** Called on error (before the built-in banner renders it). */\n    onError?: (error: { code: string; message: string }) => void;\n    /** Hide the supported-formats banner. Default: shown. */\n    hideBanner?: boolean;\n    /**\n     * Auto-compress images that exceed the provider's size limit. JPEG/PNG/WEBP only.\n     * Default: true.\n     */\n    autoCompress?: boolean;\n    /** Additional request headers to forward on upload (in addition to Authorization). */\n    headers?: Record<string, string>;\n    /** Extra classes. */\n    className?: string;\n}\n\n// ── Client-side validation rules (mirror the server) ────────────\n\nconst UNIVERSAL_FORMATS = ['image/jpeg', 'image/png', 'image/webp', 'image/gif'];\n\nconst PROVIDER_RULES: Record<VisionProvider, { formats: string[]; maxBytes: number }> = {\n    openai: { formats: UNIVERSAL_FORMATS, maxBytes: 20 * 1024 * 1024 },\n    anthropic: { formats: UNIVERSAL_FORMATS, maxBytes: 5 * 1024 * 1024 },\n    google: { formats: [...UNIVERSAL_FORMATS, 'image/heic', 'image/heif'], maxBytes: 20 * 1024 * 1024 },\n};\n\nfunction rulesFor(provider?: VisionProvider) {\n    if (provider) return PROVIDER_RULES[provider];\n    return { formats: UNIVERSAL_FORMATS, maxBytes: 5 * 1024 * 1024 };\n}\n\nfunction formatBytes(bytes: number): string {\n    if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;\n    return `${(bytes / 1024).toFixed(0)}KB`;\n}\n\nfunction friendlyFormats(mimes: string[]): string {\n    return mimes.map(m => m.replace('image/', '').toUpperCase()).join(', ');\n}\n\nfunction joinClasses(...parts: Array<string | undefined | false>): string {\n    return parts.filter(Boolean).join(' ');\n}\n\n// ── Component ───────────────────────────────────────────────────\n\nexport function VisionUploader({\n    endpoint = '/api/ai/vision',\n    apiKey,\n    task = 'analyze',\n    provider,\n    model,\n    prompt,\n    onResult,\n    onError,\n    hideBanner = false,\n    autoCompress = true,\n    headers,\n    className,\n}: VisionUploaderProps) {\n    const [file, setFile] = useState<File | null>(null);\n    const [preview, setPreview] = useState<string | null>(null);\n    const [error, setError] = useState<{ code: string; message: string } | null>(null);\n    const [loading, setLoading] = useState(false);\n    const [result, setResult] = useState<unknown>(null);\n    const [dragging, setDragging] = useState(false);\n    const [notice, setNotice] = useState<string | null>(null);\n    const inputRef = useRef<HTMLInputElement | null>(null);\n\n    const rules = useMemo(() => rulesFor(provider), [provider]);\n    const targetUrl = task === 'analyze' ? endpoint : `${endpoint.replace(/\\/$/, '')}/${task}`;\n\n    const acceptFile = useCallback(async (f: File) => {\n        setResult(null);\n        setNotice(null);\n        let effective = f;\n\n        // Wrong format: fail fast, no attempt at compression\n        const mime = (f.type || '').toLowerCase();\n        if (!rules.formats.includes(mime)) {\n            const err = {\n                code: 'unsupported_format',\n                message: `\"${f.name}\" is ${mime || 'an unknown type'}. Please upload one of: ${friendlyFormats(rules.formats)}.`,\n            };\n            setError(err);\n            setFile(null);\n            setPreview(null);\n            onError?.(err);\n            return;\n        }\n\n        // Too big: try auto-compression if allowed and format is downscalable\n        if (f.size > rules.maxBytes) {\n            if (autoCompress && canDownscale(mime)) {\n                try {\n                    const result = await downscaleImage(f, rules.maxBytes);\n                    effective = result.file;\n                    setNotice(\n                        `Compressed from ${formatBytes(result.originalBytes)} to ${formatBytes(result.finalBytes)} to fit the ${provider ?? 'universal'} limit.`\n                    );\n                } catch (compressErr) {\n                    const err = {\n                        code: 'image_too_large',\n                        message: compressErr instanceof Error\n                            ? compressErr.message\n                            : `\"${f.name}\" is ${formatBytes(f.size)} — the limit is ${formatBytes(rules.maxBytes)}${provider ? ` for ${provider}` : ''}.`,\n                    };\n                    setError(err);\n                    setFile(null);\n                    setPreview(null);\n                    onError?.(err);\n                    return;\n                }\n            } else {\n                const err = {\n                    code: 'image_too_large',\n                    message: `\"${f.name}\" is ${formatBytes(f.size)} — the limit is ${formatBytes(rules.maxBytes)}${provider ? ` for ${provider}` : ''}.`,\n                };\n                setError(err);\n                setFile(null);\n                setPreview(null);\n                onError?.(err);\n                return;\n            }\n        }\n\n        setError(null);\n        setFile(effective);\n        setPreview(URL.createObjectURL(effective));\n    }, [rules, provider, autoCompress, onError]);\n\n    const handleDrop = useCallback((e: React.DragEvent) => {\n        e.preventDefault();\n        setDragging(false);\n        const f = e.dataTransfer.files?.[0];\n        if (f) acceptFile(f);\n    }, [acceptFile]);\n\n    const handleSubmit = useCallback(async () => {\n        if (!file) return;\n        setLoading(true);\n        setError(null);\n        setResult(null);\n        try {\n            const form = new FormData();\n            form.append('file', file);\n            if (prompt && task === 'analyze') form.append('prompt', prompt);\n            if (model) form.append('model', model);\n\n            const requestHeaders: Record<string, string> = { ...(headers ?? {}) };\n            if (apiKey) requestHeaders.Authorization = `Bearer ${apiKey}`;\n\n            const res = await fetch(targetUrl, {\n                method: 'POST',\n                headers: Object.keys(requestHeaders).length ? requestHeaders : undefined,\n                body: form,\n            });\n            const data = await res.json();\n            if (!res.ok) {\n                const err = {\n                    code: (data && typeof data === 'object' && 'error' in data ? String(data.error) : 'request_failed'),\n                    message: (data && typeof data === 'object' && 'message' in data ? String(data.message) : `Request failed with status ${res.status}`),\n                };\n                setError(err);\n                onError?.(err);\n                return;\n            }\n            setResult(data);\n            onResult?.(data);\n        } catch (err) {\n            const e = { code: 'network_error', message: err instanceof Error ? err.message : 'Network error' };\n            setError(e);\n            onError?.(e);\n        } finally {\n            setLoading(false);\n        }\n    }, [file, prompt, model, task, targetUrl, apiKey, headers, onResult, onError]);\n\n    const clear = useCallback(() => {\n        setFile(null);\n        setPreview(null);\n        setResult(null);\n        setError(null);\n        setNotice(null);\n        if (inputRef.current) inputRef.current.value = '';\n    }, []);\n\n    return (\n        <div className={joinClasses('flex flex-col gap-3', className)}>\n            {!hideBanner && <VisionFormatBanner provider={provider} />}\n\n            <div\n                onDragOver={e => { e.preventDefault(); setDragging(true); }}\n                onDragLeave={() => setDragging(false)}\n                onDrop={handleDrop}\n                onClick={() => inputRef.current?.click()}\n                role=\"button\"\n                tabIndex={0}\n                aria-label=\"Upload image\"\n                className={joinClasses(\n                    'flex cursor-pointer flex-col items-center justify-center gap-2 rounded-xl border-2 border-dashed p-8 text-center transition',\n                    dragging\n                        ? 'border-blue-500 bg-blue-50 dark:bg-blue-950/30'\n                        : 'border-neutral-300 hover:border-neutral-400 dark:border-neutral-700 dark:hover:border-neutral-600',\n                )}\n            >\n                {preview ? (\n                    <div className=\"relative\">\n                        <img src={preview} alt=\"Preview\" className=\"max-h-64 rounded-lg object-contain\" />\n                        <button\n                            type=\"button\"\n                            onClick={e => { e.stopPropagation(); clear(); }}\n                            className=\"absolute -right-2 -top-2 rounded-full bg-white p-1 shadow ring-1 ring-neutral-200 hover:bg-neutral-100 dark:bg-neutral-900 dark:ring-neutral-700\"\n                            aria-label=\"Remove image\"\n                        >\n                            <X className=\"h-4 w-4\" />\n                        </button>\n                    </div>\n                ) : (\n                    <>\n                        <Upload className=\"h-8 w-8 text-neutral-400\" aria-hidden />\n                        <p className=\"text-sm font-medium\">Drop an image or click to upload</p>\n                        <p className=\"text-xs text-neutral-500\">{friendlyFormats(rules.formats)} · up to {formatBytes(rules.maxBytes)}</p>\n                    </>\n                )}\n                <input\n                    ref={inputRef}\n                    type=\"file\"\n                    accept={rules.formats.join(',')}\n                    className=\"hidden\"\n                    onChange={e => {\n                        const f = e.target.files?.[0];\n                        if (f) acceptFile(f);\n                    }}\n                />\n            </div>\n\n            {error && (\n                <div role=\"alert\" className=\"flex items-start gap-2 rounded-lg border border-red-200 bg-red-50 p-3 text-sm text-red-900 dark:border-red-900 dark:bg-red-950/40 dark:text-red-100\">\n                    <AlertCircle className=\"mt-0.5 h-4 w-4 flex-shrink-0\" aria-hidden />\n                    <div>\n                        <p className=\"font-medium\">Can't process this image</p>\n                        <p className=\"text-xs opacity-90\">{error.message}</p>\n                    </div>\n                </div>\n            )}\n\n            {notice && !error && (\n                <p className=\"text-xs text-neutral-500 dark:text-neutral-400\">{notice}</p>\n            )}\n\n            {file && !loading && !result && (\n                <button\n                    type=\"button\"\n                    onClick={handleSubmit}\n                    className=\"inline-flex items-center justify-center rounded-lg bg-neutral-900 px-4 py-2 text-sm font-medium text-white transition hover:bg-neutral-800 dark:bg-white dark:text-neutral-900 dark:hover:bg-neutral-100\"\n                >\n                    Analyze image\n                </button>\n            )}\n\n            {loading && (\n                <div className=\"inline-flex items-center gap-2 text-sm text-neutral-600 dark:text-neutral-400\">\n                    <Loader2 className=\"h-4 w-4 animate-spin\" aria-hidden />\n                    Analyzing…\n                </div>\n            )}\n\n            {result !== null && (\n                <div className=\"rounded-lg border border-neutral-200 bg-neutral-50 p-3 text-sm dark:border-neutral-800 dark:bg-neutral-900\">\n                    <p className=\"mb-1 text-xs font-medium uppercase text-neutral-500\">Result</p>\n                    <pre className=\"overflow-auto whitespace-pre-wrap break-words text-xs\">\n                        {typeof result === 'string' ? result : JSON.stringify(result, null, 2)}\n                    </pre>\n                </div>\n            )}\n        </div>\n    );\n}\n","/**\n * Client-side image downscaling.\n *\n * Iteratively reduces JPEG/PNG/WEBP dimensions until the image fits under\n * `maxBytes`. Uses <canvas>, so it must run in the browser. GIF, HEIC, and\n * HEIF are not downscaled — the caller should reject those with a format error.\n */\n\nconst DOWNSCALABLE_TYPES = new Set(['image/jpeg', 'image/png', 'image/webp']);\n\nexport function canDownscale(mimeType: string): boolean {\n    return DOWNSCALABLE_TYPES.has(mimeType.toLowerCase());\n}\n\nexport interface DownscaleResult {\n    file: File;\n    originalBytes: number;\n    finalBytes: number;\n    steps: number;\n}\n\nexport async function downscaleImage(\n    file: File,\n    maxBytes: number,\n    options: { minDimension?: number; qualityFloor?: number } = {}\n): Promise<DownscaleResult> {\n    const originalBytes = file.size;\n    if (originalBytes <= maxBytes) {\n        return { file, originalBytes, finalBytes: originalBytes, steps: 0 };\n    }\n    if (!canDownscale(file.type)) {\n        throw new Error(`Cannot auto-compress ${file.type}. Please upload a smaller image.`);\n    }\n\n    const bitmap = await createImageBitmap(file);\n    let { width, height } = bitmap;\n    const minDim = options.minDimension ?? 320;\n    let quality = 0.9;\n    const qFloor = options.qualityFloor ?? 0.5;\n    // Re-encode to JPEG unless PNG has transparency we should preserve. Simpler: always JPEG for compression.\n    const outputType = 'image/jpeg';\n\n    let steps = 0;\n    let bytes = originalBytes;\n    let outFile = file;\n\n    while (bytes > maxBytes && steps < 8) {\n        steps += 1;\n        // Prefer reducing dimensions first (bigger win), then quality\n        if (Math.min(width, height) > minDim && steps <= 4) {\n            width = Math.floor(width * 0.75);\n            height = Math.floor(height * 0.75);\n        } else if (quality > qFloor) {\n            quality = Math.max(qFloor, quality - 0.15);\n        } else {\n            break;\n        }\n\n        const canvas = typeof OffscreenCanvas !== 'undefined'\n            ? new OffscreenCanvas(width, height)\n            : Object.assign(document.createElement('canvas'), { width, height });\n\n        const ctx = (canvas as HTMLCanvasElement | OffscreenCanvas).getContext('2d');\n        if (!ctx) throw new Error('Canvas 2D context unavailable');\n        (ctx as CanvasRenderingContext2D).drawImage(bitmap, 0, 0, width, height);\n\n        const blob = canvas instanceof OffscreenCanvas\n            ? await canvas.convertToBlob({ type: outputType, quality })\n            : await new Promise<Blob>((resolve, reject) => {\n                (canvas as HTMLCanvasElement).toBlob(\n                    (b) => b ? resolve(b) : reject(new Error('toBlob returned null')),\n                    outputType,\n                    quality,\n                );\n            });\n\n        bytes = blob.size;\n        outFile = new File([blob], renameToJpeg(file.name), { type: outputType, lastModified: Date.now() });\n    }\n\n    bitmap.close?.();\n\n    if (bytes > maxBytes) {\n        throw new Error(`Could not compress image below the ${(maxBytes / (1024 * 1024)).toFixed(1)}MB limit.`);\n    }\n\n    return { file: outFile, originalBytes, finalBytes: bytes, steps };\n}\n\nfunction renameToJpeg(name: string): string {\n    const dot = name.lastIndexOf('.');\n    if (dot === -1) return `${name}.jpg`;\n    return `${name.slice(0, dot)}.jpg`;\n}\n"],"mappings":"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","names":["jsx","jsxs","UNIVERSAL_FORMATS","joinClasses","result"]}

package/dist/vision/index.d.mts

@@ -0,0 +1,99 @@
+import { C as CencoriConfig } from '../types-kh1whvNH.mjs';
+
+/**
+ * Vision API — analyze, describe, OCR, and classify images.
+ *
+ * @example
+ *   const result = await cencori.vision.analyze({
+ *       image: { url: 'https://example.com/photo.jpg' },
+ *       prompt: 'What breed of dog is this?',
+ *   });
+ *
+ * @example
+ *   const { text } = await cencori.vision.ocr({ image: { base64, mimeType: 'image/png' } });
+ */
+
+type VisionProvider = 'openai' | 'anthropic' | 'google';
+type VisionTask = 'analyze' | 'describe' | 'ocr' | 'classify';
+interface VisionImage {
+    /** https:// URL or data: URL. Exactly one of `url` or `base64` must be set. */
+    url?: string;
+    /** Raw base64 (no data: prefix). Requires `mimeType`. */
+    base64?: string;
+    /** Image mime type. Required when using `base64`. */
+    mimeType?: string;
+}
+interface VisionRequest {
+    image: VisionImage;
+    prompt?: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    responseFormat?: 'text' | 'json';
+}
+interface VisionUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+interface VisionCost {
+    providerCostUsd: number;
+    cencoriChargeUsd: number;
+    markupPercentage: number;
+}
+interface VisionResult {
+    analysis: string;
+    model: string;
+    provider: VisionProvider;
+    usage: VisionUsage;
+    cost: VisionCost;
+}
+interface VisionDescribeResult {
+    description: string;
+    model: string;
+    provider: VisionProvider;
+    usage: VisionUsage;
+    cost: VisionCost;
+}
+interface VisionOcrResult {
+    text: string;
+    model: string;
+    provider: VisionProvider;
+    usage: VisionUsage;
+    cost: VisionCost;
+}
+interface VisionClassification {
+    primary_category?: string;
+    tags?: string[];
+    objects?: string[];
+    safe_for_work?: boolean;
+    confidence?: number;
+    summary?: string;
+    [key: string]: unknown;
+}
+interface VisionClassifyResult {
+    classification: VisionClassification | string;
+    raw: string;
+    model: string;
+    provider: VisionProvider;
+    usage: VisionUsage;
+    cost: VisionCost;
+}
+declare class VisionNamespace {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    /**
+     * General image analysis — provide your own prompt.
+     * Default prompt: "Describe this image in detail."
+     */
+    analyze(request: VisionRequest): Promise<VisionResult>;
+    /** Describe the image in rich detail. */
+    describe(request: VisionRequest): Promise<VisionDescribeResult>;
+    /** Extract all visible text from the image. */
+    ocr(request: VisionRequest): Promise<VisionOcrResult>;
+    /** Return structured tags, objects, and category classification. */
+    classify(request: VisionRequest): Promise<VisionClassifyResult>;
+    private post;
+}
+
+export { type VisionClassification, type VisionClassifyResult, type VisionCost, type VisionDescribeResult, type VisionImage, VisionNamespace, type VisionOcrResult, type VisionProvider, type VisionRequest, type VisionResult, type VisionTask, type VisionUsage };

package/dist/vision/index.d.ts

@@ -0,0 +1,99 @@
+import { C as CencoriConfig } from '../types-kh1whvNH.js';
+
+/**
+ * Vision API — analyze, describe, OCR, and classify images.
+ *
+ * @example
+ *   const result = await cencori.vision.analyze({
+ *       image: { url: 'https://example.com/photo.jpg' },
+ *       prompt: 'What breed of dog is this?',
+ *   });
+ *
+ * @example
+ *   const { text } = await cencori.vision.ocr({ image: { base64, mimeType: 'image/png' } });
+ */
+
+type VisionProvider = 'openai' | 'anthropic' | 'google';
+type VisionTask = 'analyze' | 'describe' | 'ocr' | 'classify';
+interface VisionImage {
+    /** https:// URL or data: URL. Exactly one of `url` or `base64` must be set. */
+    url?: string;
+    /** Raw base64 (no data: prefix). Requires `mimeType`. */
+    base64?: string;
+    /** Image mime type. Required when using `base64`. */
+    mimeType?: string;
+}
+interface VisionRequest {
+    image: VisionImage;
+    prompt?: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    responseFormat?: 'text' | 'json';
+}
+interface VisionUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+interface VisionCost {
+    providerCostUsd: number;
+    cencoriChargeUsd: number;
+    markupPercentage: number;
+}
+interface VisionResult {
+    analysis: string;
+    model: string;
+    provider: VisionProvider;
+    usage: VisionUsage;
+    cost: VisionCost;
+}
+interface VisionDescribeResult {
+    description: string;
+    model: string;
+    provider: VisionProvider;
+    usage: VisionUsage;
+    cost: VisionCost;
+}
+interface VisionOcrResult {
+    text: string;
+    model: string;
+    provider: VisionProvider;
+    usage: VisionUsage;
+    cost: VisionCost;
+}
+interface VisionClassification {
+    primary_category?: string;
+    tags?: string[];
+    objects?: string[];
+    safe_for_work?: boolean;
+    confidence?: number;
+    summary?: string;
+    [key: string]: unknown;
+}
+interface VisionClassifyResult {
+    classification: VisionClassification | string;
+    raw: string;
+    model: string;
+    provider: VisionProvider;
+    usage: VisionUsage;
+    cost: VisionCost;
+}
+declare class VisionNamespace {
+    private config;
+    constructor(config: Required<CencoriConfig>);
+    /**
+     * General image analysis — provide your own prompt.
+     * Default prompt: "Describe this image in detail."
+     */
+    analyze(request: VisionRequest): Promise<VisionResult>;
+    /** Describe the image in rich detail. */
+    describe(request: VisionRequest): Promise<VisionDescribeResult>;
+    /** Extract all visible text from the image. */
+    ocr(request: VisionRequest): Promise<VisionOcrResult>;
+    /** Return structured tags, objects, and category classification. */
+    classify(request: VisionRequest): Promise<VisionClassifyResult>;
+    private post;
+}
+
+export { type VisionClassification, type VisionClassifyResult, type VisionCost, type VisionDescribeResult, type VisionImage, VisionNamespace, type VisionOcrResult, type VisionProvider, type VisionRequest, type VisionResult, type VisionTask, type VisionUsage };