@promte/app-library 0.1.2 → 0.1.4

package/README.md

@@ -0,0 +1,109 @@
+# @promte/app-library
+
+Docs for using the app DB API in embedded apps.
+
+## What "DB" means here
+
+In this library, DB access is exposed as:
+
+```ts
+const client = usePromteClient();
+const db = client.data(); // default scope: "private"
+```
+
+## Scopes
+
+- `private` (default): data is scoped per user.
+- `public`: shared for the whole workspace.
+  - Reads are allowed for users with workspace access.
+  - Writes (`set`, `update`, `remove`, `push`) require workspace admin/owner.
+
+```ts
+const privateDb = client.data(); // same as client.data("private")
+const publicDb = client.data("public");
+```
+
+## Paths and refs
+
+Use slash-separated paths:
+
+```ts
+const settingsRef = client.data("public").ref("translator/settings");
+```
+
+Path normalization trims spaces and removes extra slashes, so `" /a//b/ "` becomes `"a/b"`.
+
+## Core operations
+
+```ts
+// Read
+const settings = await client.data("public").ref("translator/settings").get();
+
+// Set/replace value at path
+await client.data("public").ref("translator/settings").set({
+  temperature: 0.2,
+});
+
+// Update multiple child paths relative to current ref
+await client.data("public").ref("translator").update({
+  "settings/temperature": 0.3,
+  "features/context": true,
+});
+
+// Remove path
+await client.data("public").ref("translator/features").remove();
+
+// Push into array at path (creates array if missing/not array)
+await client.data().ref("sessions/session-1/events").push({
+  type: "message",
+  at: Date.now(),
+});
+```
+
+## Models/capabilities
+
+You can fetch configured models/capabilities from backend:
+
+```ts
+const client = usePromteClient();
+const allModels = await client.models();
+const llmsOnly = await client.models({ type: "llm", configuredOnly: true });
+```
+
+Or use the built-in hook:
+
+```ts
+const { models, loading, error, reload } = usePromteModels({
+  type: "llm",
+  configuredOnly: true,
+});
+```
+
+Each model includes `id`, `label`, `type` (`llm` | `embedding` | `image` | `stt` | `tts`) and `configured`.
+
+## Return behavior
+
+- `get()` returns the value at the current path, or `null` if missing.
+- Mutations (`set`, `update`, `remove`, `push`) return the updated scope object.
+
+## Common patterns
+
+```ts
+// Save one record by id
+await client.data().ref(`sessions/${sessionId}`).set(session);
+
+// List records under a collection-like object
+const sessionsObj = await client.data().ref("sessions").get();
+const sessions = sessionsObj ? Object.values(sessionsObj) : [];
+```
+
+## Errors to expect
+
+- `Promte settings not received yet` / `Promte token not received yet`:
+  provider handshake not ready.
+- `Admin only`:
+  trying to write to `public` scope without admin rights.
+- `update requires an object`:
+  `ref.update(...)` got a non-object input.
+- `push requires a path`:
+  attempted `client.data().push(...)` without a ref path.

package/dist/index.d.ts

@@ -89,6 +89,7 @@ export declare type PromteAppProviderProps = {
 export declare type PromteClient = {
     isReady(): boolean;
     getBackendUrl(): string | null;
+    models(req?: PromteModelsRequest): Promise<PromteModelInfo[]>;
     chatCompletions(req: ChatCompletionsRequest): Promise<ChatCompletionsResponse>;
     chatText(req: ChatCompletionsRequest): Promise<string>;
     audio: {
@@ -96,6 +97,9 @@ export declare type PromteClient = {
         stt(req: AudioSttRequest): Promise<AudioSttResponse>;
         voices(req?: AudioVoicesRequest): Promise<AudioVoiceInfo[]>;
     };
+    web: {
+        scrapeUrl(req: ScrapeUrlRequest): Promise<ScrapeUrlResponse>;
+    };
     data(scope?: AppDataScope): AppDataRef;
 };
 
@@ -112,6 +116,21 @@ declare type PromteCtxValue = {
 
 export declare type PromteHandshakeState = "booting" | "waiting_for_settings" | "waiting_for_token" | "ready";
 
+export declare type PromteModelInfo = {
+    id: string;
+    label: string;
+    type: PromteModelType;
+    configured: boolean;
+    source?: string;
+};
+
+export declare type PromteModelsRequest = {
+    type?: PromteModelType | PromteModelType[];
+    configuredOnly?: boolean;
+};
+
+export declare type PromteModelType = "llm" | "embedding" | "image" | "stt" | "tts";
+
 export declare type PromteSettings = {
     workspaceId: string;
     version: number;
@@ -129,12 +148,46 @@ export declare type PromteUser = {
 
 export declare type ReasoningEffort = "minimal" | "low" | "medium" | "high";
 
+export declare type ScrapeUrlRequest = {
+    url: string;
+    maxChars?: number;
+};
+
+export declare type ScrapeUrlResponse = {
+    requestedUrl: string;
+    url: string;
+    label: string;
+    text: string;
+    title?: string;
+    status?: number;
+    extractor?: string;
+    warning?: string;
+    cached?: boolean;
+    fallback?: {
+        provider?: string;
+        enabled?: boolean;
+        attempted?: boolean;
+        used?: boolean;
+    };
+};
+
 export declare function usePromte(): PromteCtxValue;
 
 export declare function usePromteClient(): PromteClient;
 
 export declare function usePromteDarkMode(): boolean;
 
+export declare function usePromteModels(options?: UsePromteModelsOptions): {
+    models: PromteModelInfo[];
+    loading: boolean;
+    error: string;
+    reload: () => Promise<PromteModelInfo[]>;
+};
+
+export declare type UsePromteModelsOptions = PromteModelsRequest & {
+    auto?: boolean;
+};
+
 export declare function usePromteSettings(): PromteSettings;
 
 export declare function usePromteToken(): string;

package/dist/index.mjs

@@ -1,298 +1,370 @@
-import { jsx as M } from "react/jsx-runtime";
-import { createContext as A, useState as E, useMemo as j, useCallback as D, useEffect as R, useContext as L } from "react";
-const U = A(null);
-function z({
-  children: y,
-  expectedParentOrigin: h,
+import { jsx as L } from "react/jsx-runtime";
+import { createContext as O, useState as k, useMemo as S, useCallback as U, useEffect as P, useContext as D } from "react";
+const B = O(null);
+function N({
+  children: p,
+  expectedParentOrigin: d,
   initTargetOrigin: v,
-  retryInit: f = { enabled: !0, intervalMs: 500, maxAttempts: 20 }
+  retryInit: l = { enabled: !0, intervalMs: 500, maxAttempts: 20 }
 }) {
-  const [u, P] = E(null), [p, x] = E(null), [k, e] = E(null), [r, n] = E(null), [t, o] = E(null), i = j(() => t ? "booting" : u ? p ? "ready" : "waiting_for_token" : "waiting_for_settings", [u, p, t]), l = i === "ready", w = j(() => v || h || "*", [v, h]), d = D(() => {
-    var g;
+  const [m, $] = k(null), [y, x] = k(null), [h, E] = k(null), [b, t] = k(null), [r, n] = k(null), e = S(() => r ? "booting" : m ? y ? "ready" : "waiting_for_token" : "waiting_for_settings", [m, y, r]), s = e === "ready", c = S(() => v || d || "*", [v, d]), a = U(() => {
+    var o;
     try {
-      const m = { type: "init" };
-      (g = window.parent) == null || g.postMessage(m, w);
-    } catch (m) {
-      o((m == null ? void 0 : m.message) || "Failed to post init");
+      const w = { type: "init" };
+      (o = window.parent) == null || o.postMessage(w, c);
+    } catch (w) {
+      n((w == null ? void 0 : w.message) || "Failed to post init");
     }
-  }, [w]);
-  R(() => {
-    d();
-  }, [d]), R(() => {
-    if (!(f != null && f.enabled) || u) return;
-    const g = f.intervalMs ?? 500, m = f.maxAttempts ?? 20;
-    let a = 0;
-    const c = window.setInterval(() => {
-      if (u) {
-        window.clearInterval(c);
+  }, [c]);
+  P(() => {
+    a();
+  }, [a]), P(() => {
+    if (!(l != null && l.enabled) || m) return;
+    const o = l.intervalMs ?? 500, w = l.maxAttempts ?? 20;
+    let i = 0;
+    const f = window.setInterval(() => {
+      if (m) {
+        window.clearInterval(f);
         return;
       }
-      if (a += 1, a > m) {
-        window.clearInterval(c);
+      if (i += 1, i > w) {
+        window.clearInterval(f);
         return;
       }
-      d();
-    }, g);
-    return () => window.clearInterval(c);
-  }, [f, u, d]), R(() => {
-    const g = (m) => {
-      if (h && m.origin !== h) return;
-      const a = m.data;
-      if (!(!a || typeof a != "object")) {
-        if (a.type === "set-settings") {
-          const c = a.value;
-          if (!(c != null && c.backendUrl) || c.parentOrigin && h && c.parentOrigin !== h)
+      a();
+    }, o);
+    return () => window.clearInterval(f);
+  }, [l, m, a]), P(() => {
+    const o = (w) => {
+      if (d && w.origin !== d) return;
+      const i = w.data;
+      if (!(!i || typeof i != "object")) {
+        if (i.type === "set-settings") {
+          const f = i.value;
+          if (!(f != null && f.backendUrl) || f.parentOrigin && d && f.parentOrigin !== d)
             return;
-          P(c), c != null && c.user && n(c.user), o(null);
+          $(f), f != null && f.user && t(f.user), n(null);
           return;
         }
-        if (a.type === "set-token" && typeof a.value == "string") {
-          x(a.value), o(null);
+        if (i.type === "set-token" && typeof i.value == "string") {
+          x(i.value), n(null);
           return;
         }
-        if (a.type === "set-dark-mode" && typeof a.value == "boolean") {
-          e(a.value);
+        if (i.type === "set-dark-mode" && typeof i.value == "boolean") {
+          E(i.value);
           return;
         }
-        if (a.type === "set-user" && typeof a.value == "object") {
-          n(a.value);
+        if (i.type === "set-user" && typeof i.value == "object") {
+          t(i.value);
           return;
         }
       }
     };
-    return window.addEventListener("message", g), () => window.removeEventListener("message", g);
-  }, [h]);
-  const s = j(() => F(
-    () => u,
-    () => p
-  ), [u, p]), T = j(
+    return window.addEventListener("message", o), () => window.removeEventListener("message", o);
+  }, [d]);
+  const u = S(() => _(
+    () => m,
+    () => y
+  ), [m, y]), g = S(
     () => ({
-      settings: u,
-      token: p,
-      isDarkMode: k,
-      user: r,
-      ready: l,
-      state: i,
-      error: t,
-      client: s
+      settings: m,
+      token: y,
+      isDarkMode: h,
+      user: b,
+      ready: s,
+      state: e,
+      error: r,
+      client: u
     }),
-    [u, p, k, r, l, i, t, s]
+    [m, y, h, b, s, e, r, u]
   );
-  return /* @__PURE__ */ M(U.Provider, { value: T, children: y });
+  return /* @__PURE__ */ L(B.Provider, { value: g, children: p });
 }
-function b() {
-  const y = L(U);
-  if (!y)
+function j() {
+  const p = D(B);
+  if (!p)
     throw new Error("usePromte must be used inside <PromteAppProvider>");
-  return y;
+  return p;
 }
-function G() {
-  return b().settings;
+function z() {
+  return j().settings;
 }
-function J() {
-  return b().token;
+function V() {
+  return j().token;
 }
-function N() {
-  return b().isDarkMode;
-}
-function O() {
-  return b().user;
+function W() {
+  return j().isDarkMode;
 }
 function I() {
-  return b().client;
+  return j().user;
+}
+function F() {
+  return j().client;
+}
+function K(p = {}) {
+  const { ready: d } = j(), v = F(), [l, m] = k([]), [$, y] = k(!1), [x, h] = k(null), E = S(() => (Array.isArray(p.type) ? p.type : p.type ? [p.type] : []).filter(Boolean).map((e) => String(e)).join(","), [p.type]), b = p.configuredOnly === !0, t = p.auto !== !1, r = U(async () => {
+    if (!d) return [];
+    y(!0), h(null);
+    try {
+      const n = E ? E.split(",").filter(Boolean) : void 0, e = await v.models({ type: n, configuredOnly: b });
+      return m(e), e;
+    } catch (n) {
+      const e = n instanceof Error ? n.message : String(n);
+      throw h(e), n;
+    } finally {
+      y(!1);
+    }
+  }, [v, b, d, E]);
+  return P(() => {
+    !t || !d || r().catch(() => {
+    });
+  }, [t, d, r]), { models: l, loading: $, error: x, reload: r };
 }
-function F(y, h) {
-  const v = (e) => typeof e == "string" && e.startsWith("gpt-5");
-  async function f(e, r) {
-    const n = y(), t = h();
+function _(p, d) {
+  const v = (t) => typeof t == "string" && t.startsWith("gpt-5");
+  async function l(t, r) {
+    const n = p(), e = d();
     if (!n) throw new Error("Promte settings not received yet");
-    if (!t) throw new Error("Promte token not received yet");
-    const o = new URL(n.backendUrl + "/" + e).toString();
-    return await fetch(o, {
+    if (!e) throw new Error("Promte token not received yet");
+    const s = n.backendUrl.replace(/\/+$/, ""), c = String(t || "").replace(/^\/+/, ""), a = `${s}/${c}`;
+    return await fetch(a, {
       ...r,
       headers: {
         ...r.headers || {},
-        Authorization: `Bearer ${t}`
+        Authorization: `Bearer ${e}`
       }
     });
   }
-  async function u(e, r) {
-    const n = await f(`/app-api/data/${e}`, {
+  async function m(t, r) {
+    const n = await l(`/app-api/data/${t}`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(r)
-    }), t = await n.json().catch(() => ({}));
+    }), e = await n.json().catch(() => ({}));
     if (!n.ok)
       throw new Error(
-        (t == null ? void 0 : t.error) || `Request failed (${n.status})`
+        (e == null ? void 0 : e.error) || `Request failed (${n.status})`
       );
-    return t == null ? void 0 : t.value;
+    return e == null ? void 0 : e.value;
   }
-  async function P(e) {
+  async function $(t) {
     const r = new URLSearchParams();
-    e.scope && r.set("scope", e.scope), e.path && r.set("path", e.path);
-    const n = await f(`/app-api/data?${r.toString()}`, {
+    t.scope && r.set("scope", t.scope), t.path && r.set("path", t.path);
+    const n = await l(`/app-api/data?${r.toString()}`, {
       method: "GET"
-    }), t = await n.json().catch(() => ({}));
+    }), e = await n.json().catch(() => ({}));
     if (!n.ok)
-      throw new Error((t == null ? void 0 : t.error) || `Request failed (${n.status})`);
-    return t == null ? void 0 : t.value;
+      throw new Error((e == null ? void 0 : e.error) || `Request failed (${n.status})`);
+    return e == null ? void 0 : e.value;
+  }
+  async function y(t) {
+    const r = new URLSearchParams(), n = Array.isArray(t == null ? void 0 : t.type) ? t == null ? void 0 : t.type : t != null && t.type ? [t.type] : [];
+    n.length > 0 && r.set("type", n.join(",")), t != null && t.configuredOnly && r.set("configuredOnly", "true");
+    const e = await l(
+      `/app-api/models${r.toString() ? `?${r.toString()}` : ""}`,
+      { method: "GET" }
+    ), s = await e.json().catch(() => ({}));
+    if (!e.ok)
+      throw new Error((s == null ? void 0 : s.error) || `Request failed (${e.status})`);
+    return (Array.isArray(s == null ? void 0 : s.models) ? s.models : []).map((a) => {
+      if (!a || typeof a != "object") return null;
+      const u = typeof a.id == "string" ? a.id.trim() : "", g = typeof a.label == "string" ? a.label.trim() : u, o = a.type, w = a.configured === !0, i = typeof a.source == "string" && a.source.trim() ? a.source.trim() : void 0;
+      return !u || o !== "llm" && o !== "embedding" && o !== "image" && o !== "stt" && o !== "tts" ? null : {
+        id: u,
+        label: g || u,
+        type: o,
+        configured: w,
+        source: i
+      };
+    }).filter(
+      (a) => !!a
+    );
   }
-  const p = (e) => e ? e.split("/").map((r) => r.trim()).filter(Boolean).join("/") : "", x = (e, r) => {
-    const n = p(e), t = p(r);
-    return n ? t ? `${n}/${t}` : n : t;
-  }, k = (e, r) => {
-    const n = { scope: e };
+  async function x(t, r) {
+    const n = await l(t, r), s = (n.headers.get("content-type") || "").includes("application/json") ? await n.json().catch(() => ({})) : await n.text();
+    if (!n.ok)
+      throw new Error(
+        typeof s == "string" ? s || `Request failed (${n.status})` : (s == null ? void 0 : s.error) || (s == null ? void 0 : s.message) || `Request failed (${n.status})`
+      );
+    return s;
+  }
+  const h = (t) => t ? t.split("/").map((r) => r.trim()).filter(Boolean).join("/") : "", E = (t, r) => {
+    const n = h(t), e = h(r);
+    return n ? e ? `${n}/${e}` : n : e;
+  }, b = (t, r) => {
+    const n = { scope: t };
     return {
       async get() {
-        const t = p(r);
-        return P({ ...n, path: t || void 0 });
+        const e = h(r);
+        return $({ ...n, path: e || void 0 });
       },
-      async set(t) {
-        const o = p(r);
-        return u("set", {
+      async set(e) {
+        const s = h(r);
+        return m("set", {
           ...n,
-          path: o || void 0,
-          value: t
+          path: s || void 0,
+          value: e
         });
       },
-      async update(t) {
-        if (!t || typeof t != "object")
+      async update(e) {
+        if (!e || typeof e != "object")
           throw new Error("update requires an object");
-        const o = {};
-        for (const [i, l] of Object.entries(t)) {
-          const w = x(r, i);
-          if (!w)
+        const s = {};
+        for (const [c, a] of Object.entries(e)) {
+          const u = E(r, c);
+          if (!u)
             throw new Error("update paths must be non-empty");
-          o[w] = l;
+          s[u] = a;
         }
-        return u("update", { ...n, updates: o });
+        return m("update", { ...n, updates: s });
       },
       async remove() {
-        const t = p(r);
-        return u("remove", { ...n, path: t || void 0 });
+        const e = h(r);
+        return m("remove", { ...n, path: e || void 0 });
       },
-      async push(t) {
-        const o = p(r);
-        if (!o) throw new Error("push requires a path");
-        return u("array-push", { ...n, path: o, value: t });
+      async push(e) {
+        const s = h(r);
+        if (!s) throw new Error("push requires a path");
+        return m("array-push", { ...n, path: s, value: e });
       },
-      ref(t) {
-        const o = x(r, t);
-        if (!o) throw new Error("ref requires a path");
-        return k(e, o);
+      ref(e) {
+        const s = E(r, e);
+        if (!s) throw new Error("ref requires a path");
+        return b(t, s);
       }
     };
   };
   return {
     isReady() {
-      return !!y() && !!h();
+      return !!p() && !!d();
     },
     getBackendUrl() {
-      var e;
-      return ((e = y()) == null ? void 0 : e.backendUrl) ?? null;
+      var t;
+      return ((t = p()) == null ? void 0 : t.backendUrl) ?? null;
+    },
+    async models(t) {
+      return y(t);
     },
-    async chatCompletions(e) {
-      var s;
+    async chatCompletions(t) {
+      var o;
       const {
         reasoningEffort: r,
         reasoning_effort: n,
-        ...t
-      } = e, o = r ?? n, i = {
-        ...t,
+        ...e
+      } = t, s = r ?? n, c = {
+        ...e,
         stream: !1
       };
-      o && v(e.model) && (i.reasoning_effort = o);
-      const l = await f("/openai/chat/completions", {
+      s && v(t.model) && (c.reasoning_effort = s);
+      const a = await l("/openai/chat/completions", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(i)
-      }), d = (l.headers.get("content-type") || "").includes("application/json") ? await l.json() : await l.text();
-      if (!l.ok)
+        body: JSON.stringify(c)
+      }), g = (a.headers.get("content-type") || "").includes("application/json") ? await a.json() : await a.text();
+      if (!a.ok)
         throw new Error(
-          typeof d == "string" ? d : ((s = d == null ? void 0 : d.error) == null ? void 0 : s.message) || `Request failed (${l.status})`
+          typeof g == "string" ? g : ((o = g == null ? void 0 : g.error) == null ? void 0 : o.message) || `Request failed (${a.status})`
         );
-      return d;
+      return g;
     },
-    async chatText(e) {
-      var n, t, o;
-      const r = await this.chatCompletions(e);
-      return ((o = (t = (n = r == null ? void 0 : r.choices) == null ? void 0 : n[0]) == null ? void 0 : t.message) == null ? void 0 : o.content) ?? "";
+    async chatText(t) {
+      var n, e, s;
+      const r = await this.chatCompletions(t);
+      return ((s = (e = (n = r == null ? void 0 : r.choices) == null ? void 0 : n[0]) == null ? void 0 : e.message) == null ? void 0 : s.content) ?? "";
     },
     audio: {
-      async tts(e) {
-        var o;
-        const r = (o = e == null ? void 0 : e.text) == null ? void 0 : o.trim();
+      async tts(t) {
+        var s;
+        const r = (s = t == null ? void 0 : t.text) == null ? void 0 : s.trim();
         if (!r) throw new Error("audio.tts requires non-empty text");
-        const n = await f("/app-api/audio/tts", {
+        const n = await l("/app-api/audio/tts", {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({
             text: r,
-            voice: e.voice,
-            lang: e.lang
+            voice: t.voice,
+            lang: t.lang
           })
         });
         if (!n.ok) {
-          const i = await n.text();
-          throw new Error(i || `Request failed (${n.status})`);
+          const c = await n.text();
+          throw new Error(c || `Request failed (${n.status})`);
         }
         return {
           audio: await n.arrayBuffer(),
           contentType: n.headers.get("content-type")
         };
       },
-      async stt(e) {
-        var g, m, a;
-        if (!(e != null && e.file)) throw new Error("audio.stt requires a file");
-        const r = (c) => {
-          if (!c) return;
-          const $ = c.trim();
-          if (!$) return;
-          const C = $.toLowerCase(), S = C.split("-")[0];
-          return S.length === 2 ? S : C;
-        }, n = typeof File < "u" && e.file instanceof File, t = n && e.file.name.split(".").pop() || "webm", o = e.ext || t, i = new FormData();
-        n ? i.set("file", e.file) : i.set("file", e.file, `audio.${o}`);
-        const l = r(e.language);
-        l && i.set("language", l), e.prompt && i.set("prompt", e.prompt);
-        const w = await f(
-          `/app-api/audio/stt?ext=${encodeURIComponent(o)}`,
+      async stt(t) {
+        var i, f, T;
+        if (!(t != null && t.file)) throw new Error("audio.stt requires a file");
+        const r = (R) => {
+          if (!R) return;
+          const C = R.trim();
+          if (!C) return;
+          const A = C.toLowerCase(), M = A.split("-")[0];
+          return M.length === 2 ? M : A;
+        }, n = typeof File < "u" && t.file instanceof File, e = n && t.file.name.split(".").pop() || "webm", s = t.ext || e, c = new FormData();
+        n ? c.set("file", t.file) : c.set("file", t.file, `audio.${s}`);
+        const a = r(t.language);
+        a && c.set("language", a), t.prompt && c.set("prompt", t.prompt);
+        const u = await l(
+          `/app-api/audio/stt?ext=${encodeURIComponent(s)}`,
           {
             method: "POST",
-            body: i
+            body: c
           }
-        ), s = (w.headers.get("content-type") || "").includes("application/json") ? await w.json() : await w.text();
-        if (!w.ok)
+        ), o = (u.headers.get("content-type") || "").includes("application/json") ? await u.json() : await u.text();
+        if (!u.ok)
           throw new Error(
-            typeof s == "string" ? s : ((g = s == null ? void 0 : s.error) == null ? void 0 : g.message) || `Request failed (${w.status})`
+            typeof o == "string" ? o : ((i = o == null ? void 0 : o.error) == null ? void 0 : i.message) || `Request failed (${u.status})`
           );
-        return { text: typeof s == "string" ? s : (s == null ? void 0 : s.text) || (s == null ? void 0 : s.original) || ((a = (m = s == null ? void 0 : s.results) == null ? void 0 : m[0]) == null ? void 0 : a.text) || "", raw: s };
+        return { text: typeof o == "string" ? o : (o == null ? void 0 : o.text) || (o == null ? void 0 : o.original) || ((T = (f = o == null ? void 0 : o.results) == null ? void 0 : f[0]) == null ? void 0 : T.text) || "", raw: o };
       },
-      async voices(e) {
+      async voices(t) {
         const r = new URLSearchParams();
-        e != null && e.locale && r.set("locale", e.locale);
-        const n = await f(
+        t != null && t.locale && r.set("locale", t.locale);
+        const n = await l(
           `/app-api/audio/tts/voices${r.toString() ? `?${r}` : ""}`,
           { method: "GET" }
-        ), t = await n.json().catch(() => []);
+        ), e = await n.json().catch(() => []);
         if (!n.ok)
           throw new Error(
-            (t == null ? void 0 : t.error) || `Request failed (${n.status})`
+            (e == null ? void 0 : e.error) || `Request failed (${n.status})`
           );
-        return Array.isArray(t) ? t : (t == null ? void 0 : t.voices) || [];
+        return Array.isArray(e) ? e : (e == null ? void 0 : e.voices) || [];
+      }
+    },
+    web: {
+      async scrapeUrl(t) {
+        var n;
+        const r = (n = t == null ? void 0 : t.url) == null ? void 0 : n.trim();
+        if (!r) throw new Error("web.scrapeUrl requires a url");
+        return x(
+          "/app-api/web/scrape-url",
+          {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+              url: r,
+              maxChars: t.maxChars
+            })
+          }
+        );
       }
     },
-    data(e = "private") {
-      return k(e, "");
+    data(t = "private") {
+      return b(t, "");
     }
   };
 }
 export {
-  z as PromteAppProvider,
-  b as usePromte,
-  I as usePromteClient,
-  N as usePromteDarkMode,
-  G as usePromteSettings,
-  J as usePromteToken,
-  O as usePromteUser
+  N as PromteAppProvider,
+  j as usePromte,
+  F as usePromteClient,
+  W as usePromteDarkMode,
+  K as usePromteModels,
+  z as usePromteSettings,
+  V as usePromteToken,
+  I as usePromteUser
 };

package/dist/index.umd.cjs

@@ -1 +1 @@
-(function(f,P){typeof exports=="object"&&typeof module<"u"?P(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],P):(f=typeof globalThis<"u"?globalThis:f||self,P(f.PromteAppLibrary={},f.jsxRuntime,f.react))})(this,function(f,P,c){"use strict";const x=c.createContext(null);function U({children:k,expectedParentOrigin:y,initTargetOrigin:j,retryInit:l={enabled:!0,intervalMs:500,maxAttempts:20}}){const[p,T]=c.useState(null),[m,S]=c.useState(null),[b,e]=c.useState(null),[o,n]=c.useState(null),[t,r]=c.useState(null),a=c.useMemo(()=>t?"booting":p?m?"ready":"waiting_for_token":"waiting_for_settings",[p,m,t]),d=a==="ready",h=c.useMemo(()=>j||y||"*",[j,y]),g=c.useCallback(()=>{var v;try{const w={type:"init"};(v=window.parent)==null||v.postMessage(w,h)}catch(w){r((w==null?void 0:w.message)||"Failed to post init")}},[h]);c.useEffect(()=>{g()},[g]),c.useEffect(()=>{if(!(l!=null&&l.enabled)||p)return;const v=l.intervalMs??500,w=l.maxAttempts??20;let i=0;const u=window.setInterval(()=>{if(p){window.clearInterval(u);return}if(i+=1,i>w){window.clearInterval(u);return}g()},v);return()=>window.clearInterval(u)},[l,p,g]),c.useEffect(()=>{const v=w=>{if(y&&w.origin!==y)return;const i=w.data;if(!(!i||typeof i!="object")){if(i.type==="set-settings"){const u=i.value;if(!(u!=null&&u.backendUrl)||u.parentOrigin&&y&&u.parentOrigin!==y)return;T(u),u!=null&&u.user&&n(u.user),r(null);return}if(i.type==="set-token"&&typeof i.value=="string"){S(i.value),r(null);return}if(i.type==="set-dark-mode"&&typeof i.value=="boolean"){e(i.value);return}if(i.type==="set-user"&&typeof i.value=="object"){n(i.value);return}}};return window.addEventListener("message",v),()=>window.removeEventListener("message",v)},[y]);const s=c.useMemo(()=>B(()=>p,()=>m),[p,m]),R=c.useMemo(()=>({settings:p,token:m,isDarkMode:b,user:o,ready:d,state:a,error:t,client:s}),[p,m,b,o,d,a,t,s]);return P.jsx(x.Provider,{value:R,children:k})}function E(){const k=c.useContext(x);if(!k)throw new Error("usePromte must be used inside <PromteAppProvider>");return k}function A(){return E().settings}function D(){return E().token}function L(){return E().isDarkMode}function F(){return E().user}function _(){return E().client}function B(k,y){const j=e=>typeof e=="string"&&e.startsWith("gpt-5");async function l(e,o){const n=k(),t=y();if(!n)throw new Error("Promte settings not received yet");if(!t)throw new Error("Promte token not received yet");const r=new URL(n.backendUrl+"/"+e).toString();return await fetch(r,{...o,headers:{...o.headers||{},Authorization:`Bearer ${t}`}})}async function p(e,o){const n=await l(`/app-api/data/${e}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(o)}),t=await n.json().catch(()=>({}));if(!n.ok)throw new Error((t==null?void 0:t.error)||`Request failed (${n.status})`);return t==null?void 0:t.value}async function T(e){const o=new URLSearchParams;e.scope&&o.set("scope",e.scope),e.path&&o.set("path",e.path);const n=await l(`/app-api/data?${o.toString()}`,{method:"GET"}),t=await n.json().catch(()=>({}));if(!n.ok)throw new Error((t==null?void 0:t.error)||`Request failed (${n.status})`);return t==null?void 0:t.value}const m=e=>e?e.split("/").map(o=>o.trim()).filter(Boolean).join("/"):"",S=(e,o)=>{const n=m(e),t=m(o);return n?t?`${n}/${t}`:n:t},b=(e,o)=>{const n={scope:e};return{async get(){const t=m(o);return T({...n,path:t||void 0})},async set(t){const r=m(o);return p("set",{...n,path:r||void 0,value:t})},async update(t){if(!t||typeof t!="object")throw new Error("update requires an object");const r={};for(const[a,d]of Object.entries(t)){const h=S(o,a);if(!h)throw new Error("update paths must be non-empty");r[h]=d}return p("update",{...n,updates:r})},async remove(){const t=m(o);return p("remove",{...n,path:t||void 0})},async push(t){const r=m(o);if(!r)throw new Error("push requires a path");return p("array-push",{...n,path:r,value:t})},ref(t){const r=S(o,t);if(!r)throw new Error("ref requires a path");return b(e,r)}}};return{isReady(){return!!k()&&!!y()},getBackendUrl(){var e;return((e=k())==null?void 0:e.backendUrl)??null},async chatCompletions(e){var s;const{reasoningEffort:o,reasoning_effort:n,...t}=e,r=o??n,a={...t,stream:!1};r&&j(e.model)&&(a.reasoning_effort=r);const d=await l("/openai/chat/completions",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(a)}),g=(d.headers.get("content-type")||"").includes("application/json")?await d.json():await d.text();if(!d.ok)throw new Error(typeof g=="string"?g:((s=g==null?void 0:g.error)==null?void 0:s.message)||`Request failed (${d.status})`);return g},async chatText(e){var n,t,r;const o=await this.chatCompletions(e);return((r=(t=(n=o==null?void 0:o.choices)==null?void 0:n[0])==null?void 0:t.message)==null?void 0:r.content)??""},audio:{async tts(e){var r;const o=(r=e==null?void 0:e.text)==null?void 0:r.trim();if(!o)throw new Error("audio.tts requires non-empty text");const n=await l("/app-api/audio/tts",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({text:o,voice:e.voice,lang:e.lang})});if(!n.ok){const a=await n.text();throw new Error(a||`Request failed (${n.status})`)}return{audio:await n.arrayBuffer(),contentType:n.headers.get("content-type")}},async stt(e){var v,w,i;if(!(e!=null&&e.file))throw new Error("audio.stt requires a file");const o=u=>{if(!u)return;const C=u.trim();if(!C)return;const M=C.toLowerCase(),$=M.split("-")[0];return $.length===2?$:M},n=typeof File<"u"&&e.file instanceof File,t=n&&e.file.name.split(".").pop()||"webm",r=e.ext||t,a=new FormData;n?a.set("file",e.file):a.set("file",e.file,`audio.${r}`);const d=o(e.language);d&&a.set("language",d),e.prompt&&a.set("prompt",e.prompt);const h=await l(`/app-api/audio/stt?ext=${encodeURIComponent(r)}`,{method:"POST",body:a}),s=(h.headers.get("content-type")||"").includes("application/json")?await h.json():await h.text();if(!h.ok)throw new Error(typeof s=="string"?s:((v=s==null?void 0:s.error)==null?void 0:v.message)||`Request failed (${h.status})`);return{text:typeof s=="string"?s:(s==null?void 0:s.text)||(s==null?void 0:s.original)||((i=(w=s==null?void 0:s.results)==null?void 0:w[0])==null?void 0:i.text)||"",raw:s}},async voices(e){const o=new URLSearchParams;e!=null&&e.locale&&o.set("locale",e.locale);const n=await l(`/app-api/audio/tts/voices${o.toString()?`?${o}`:""}`,{method:"GET"}),t=await n.json().catch(()=>[]);if(!n.ok)throw new Error((t==null?void 0:t.error)||`Request failed (${n.status})`);return Array.isArray(t)?t:(t==null?void 0:t.voices)||[]}},data(e="private"){return b(e,"")}}}f.PromteAppProvider=U,f.usePromte=E,f.usePromteClient=_,f.usePromteDarkMode=L,f.usePromteSettings=A,f.usePromteToken=D,f.usePromteUser=F,Object.defineProperty(f,Symbol.toStringTag,{value:"Module"})});
+(function(y,j){typeof exports=="object"&&typeof module<"u"?j(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],j):(y=typeof globalThis<"u"?globalThis:y||self,j(y.PromteAppLibrary={},y.jsxRuntime,y.react))})(this,function(y,j,i){"use strict";const M=i.createContext(null);function O({children:d,expectedParentOrigin:m,initTargetOrigin:b,retryInit:l={enabled:!0,intervalMs:500,maxAttempts:20}}){const[w,T]=i.useState(null),[v,$]=i.useState(null),[g,k]=i.useState(null),[P,t]=i.useState(null),[s,n]=i.useState(null),e=i.useMemo(()=>s?"booting":w?v?"ready":"waiting_for_token":"waiting_for_settings",[w,v,s]),r=e==="ready",c=i.useMemo(()=>b||m||"*",[b,m]),a=i.useCallback(()=>{var o;try{const h={type:"init"};(o=window.parent)==null||o.postMessage(h,c)}catch(h){n((h==null?void 0:h.message)||"Failed to post init")}},[c]);i.useEffect(()=>{a()},[a]),i.useEffect(()=>{if(!(l!=null&&l.enabled)||w)return;const o=l.intervalMs??500,h=l.maxAttempts??20;let u=0;const p=window.setInterval(()=>{if(w){window.clearInterval(p);return}if(u+=1,u>h){window.clearInterval(p);return}a()},o);return()=>window.clearInterval(p)},[l,w,a]),i.useEffect(()=>{const o=h=>{if(m&&h.origin!==m)return;const u=h.data;if(!(!u||typeof u!="object")){if(u.type==="set-settings"){const p=u.value;if(!(p!=null&&p.backendUrl)||p.parentOrigin&&m&&p.parentOrigin!==m)return;T(p),p!=null&&p.user&&t(p.user),n(null);return}if(u.type==="set-token"&&typeof u.value=="string"){$(u.value),n(null);return}if(u.type==="set-dark-mode"&&typeof u.value=="boolean"){k(u.value);return}if(u.type==="set-user"&&typeof u.value=="object"){t(u.value);return}}};return window.addEventListener("message",o),()=>window.removeEventListener("message",o)},[m]);const f=i.useMemo(()=>J(()=>w,()=>v),[w,v]),E=i.useMemo(()=>({settings:w,token:v,isDarkMode:g,user:P,ready:r,state:e,error:s,client:f}),[w,v,g,P,r,e,s,f]);return j.jsx(M.Provider,{value:E,children:d})}function S(){const d=i.useContext(M);if(!d)throw new Error("usePromte must be used inside <PromteAppProvider>");return d}function B(){return S().settings}function D(){return S().token}function F(){return S().isDarkMode}function _(){return S().user}function R(){return S().client}function G(d={}){const{ready:m}=S(),b=R(),[l,w]=i.useState([]),[T,v]=i.useState(!1),[$,g]=i.useState(null),k=i.useMemo(()=>(Array.isArray(d.type)?d.type:d.type?[d.type]:[]).filter(Boolean).map(e=>String(e)).join(","),[d.type]),P=d.configuredOnly===!0,t=d.auto!==!1,s=i.useCallback(async()=>{if(!m)return[];v(!0),g(null);try{const n=k?k.split(",").filter(Boolean):void 0,e=await b.models({type:n,configuredOnly:P});return w(e),e}catch(n){const e=n instanceof Error?n.message:String(n);throw g(e),n}finally{v(!1)}},[b,P,m,k]);return i.useEffect(()=>{!t||!m||s().catch(()=>{})},[t,m,s]),{models:l,loading:T,error:$,reload:s}}function J(d,m){const b=t=>typeof t=="string"&&t.startsWith("gpt-5");async function l(t,s){const n=d(),e=m();if(!n)throw new Error("Promte settings not received yet");if(!e)throw new Error("Promte token not received yet");const r=n.backendUrl.replace(/\/+$/,""),c=String(t||"").replace(/^\/+/,""),a=`${r}/${c}`;return await fetch(a,{...s,headers:{...s.headers||{},Authorization:`Bearer ${e}`}})}async function w(t,s){const n=await l(`/app-api/data/${t}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s)}),e=await n.json().catch(()=>({}));if(!n.ok)throw new Error((e==null?void 0:e.error)||`Request failed (${n.status})`);return e==null?void 0:e.value}async function T(t){const s=new URLSearchParams;t.scope&&s.set("scope",t.scope),t.path&&s.set("path",t.path);const n=await l(`/app-api/data?${s.toString()}`,{method:"GET"}),e=await n.json().catch(()=>({}));if(!n.ok)throw new Error((e==null?void 0:e.error)||`Request failed (${n.status})`);return e==null?void 0:e.value}async function v(t){const s=new URLSearchParams,n=Array.isArray(t==null?void 0:t.type)?t==null?void 0:t.type:t!=null&&t.type?[t.type]:[];n.length>0&&s.set("type",n.join(",")),t!=null&&t.configuredOnly&&s.set("configuredOnly","true");const e=await l(`/app-api/models${s.toString()?`?${s.toString()}`:""}`,{method:"GET"}),r=await e.json().catch(()=>({}));if(!e.ok)throw new Error((r==null?void 0:r.error)||`Request failed (${e.status})`);return(Array.isArray(r==null?void 0:r.models)?r.models:[]).map(a=>{if(!a||typeof a!="object")return null;const f=typeof a.id=="string"?a.id.trim():"",E=typeof a.label=="string"?a.label.trim():f,o=a.type,h=a.configured===!0,u=typeof a.source=="string"&&a.source.trim()?a.source.trim():void 0;return!f||o!=="llm"&&o!=="embedding"&&o!=="image"&&o!=="stt"&&o!=="tts"?null:{id:f,label:E||f,type:o,configured:h,source:u}}).filter(a=>!!a)}async function $(t,s){const n=await l(t,s),r=(n.headers.get("content-type")||"").includes("application/json")?await n.json().catch(()=>({})):await n.text();if(!n.ok)throw new Error(typeof r=="string"?r||`Request failed (${n.status})`:(r==null?void 0:r.error)||(r==null?void 0:r.message)||`Request failed (${n.status})`);return r}const g=t=>t?t.split("/").map(s=>s.trim()).filter(Boolean).join("/"):"",k=(t,s)=>{const n=g(t),e=g(s);return n?e?`${n}/${e}`:n:e},P=(t,s)=>{const n={scope:t};return{async get(){const e=g(s);return T({...n,path:e||void 0})},async set(e){const r=g(s);return w("set",{...n,path:r||void 0,value:e})},async update(e){if(!e||typeof e!="object")throw new Error("update requires an object");const r={};for(const[c,a]of Object.entries(e)){const f=k(s,c);if(!f)throw new Error("update paths must be non-empty");r[f]=a}return w("update",{...n,updates:r})},async remove(){const e=g(s);return w("remove",{...n,path:e||void 0})},async push(e){const r=g(s);if(!r)throw new Error("push requires a path");return w("array-push",{...n,path:r,value:e})},ref(e){const r=k(s,e);if(!r)throw new Error("ref requires a path");return P(t,r)}}};return{isReady(){return!!d()&&!!m()},getBackendUrl(){var t;return((t=d())==null?void 0:t.backendUrl)??null},async models(t){return v(t)},async chatCompletions(t){var o;const{reasoningEffort:s,reasoning_effort:n,...e}=t,r=s??n,c={...e,stream:!1};r&&b(t.model)&&(c.reasoning_effort=r);const a=await l("/openai/chat/completions",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(c)}),E=(a.headers.get("content-type")||"").includes("application/json")?await a.json():await a.text();if(!a.ok)throw new Error(typeof E=="string"?E:((o=E==null?void 0:E.error)==null?void 0:o.message)||`Request failed (${a.status})`);return E},async chatText(t){var n,e,r;const s=await this.chatCompletions(t);return((r=(e=(n=s==null?void 0:s.choices)==null?void 0:n[0])==null?void 0:e.message)==null?void 0:r.content)??""},audio:{async tts(t){var r;const s=(r=t==null?void 0:t.text)==null?void 0:r.trim();if(!s)throw new Error("audio.tts requires non-empty text");const n=await l("/app-api/audio/tts",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({text:s,voice:t.voice,lang:t.lang})});if(!n.ok){const c=await n.text();throw new Error(c||`Request failed (${n.status})`)}return{audio:await n.arrayBuffer(),contentType:n.headers.get("content-type")}},async stt(t){var u,p,x;if(!(t!=null&&t.file))throw new Error("audio.stt requires a file");const s=C=>{if(!C)return;const A=C.trim();if(!A)return;const U=A.toLowerCase(),L=U.split("-")[0];return L.length===2?L:U},n=typeof File<"u"&&t.file instanceof File,e=n&&t.file.name.split(".").pop()||"webm",r=t.ext||e,c=new FormData;n?c.set("file",t.file):c.set("file",t.file,`audio.${r}`);const a=s(t.language);a&&c.set("language",a),t.prompt&&c.set("prompt",t.prompt);const f=await l(`/app-api/audio/stt?ext=${encodeURIComponent(r)}`,{method:"POST",body:c}),o=(f.headers.get("content-type")||"").includes("application/json")?await f.json():await f.text();if(!f.ok)throw new Error(typeof o=="string"?o:((u=o==null?void 0:o.error)==null?void 0:u.message)||`Request failed (${f.status})`);return{text:typeof o=="string"?o:(o==null?void 0:o.text)||(o==null?void 0:o.original)||((x=(p=o==null?void 0:o.results)==null?void 0:p[0])==null?void 0:x.text)||"",raw:o}},async voices(t){const s=new URLSearchParams;t!=null&&t.locale&&s.set("locale",t.locale);const n=await l(`/app-api/audio/tts/voices${s.toString()?`?${s}`:""}`,{method:"GET"}),e=await n.json().catch(()=>[]);if(!n.ok)throw new Error((e==null?void 0:e.error)||`Request failed (${n.status})`);return Array.isArray(e)?e:(e==null?void 0:e.voices)||[]}},web:{async scrapeUrl(t){var n;const s=(n=t==null?void 0:t.url)==null?void 0:n.trim();if(!s)throw new Error("web.scrapeUrl requires a url");return $("/app-api/web/scrape-url",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({url:s,maxChars:t.maxChars})})}},data(t="private"){return P(t,"")}}}y.PromteAppProvider=O,y.usePromte=S,y.usePromteClient=R,y.usePromteDarkMode=F,y.usePromteModels=G,y.usePromteSettings=B,y.usePromteToken=D,y.usePromteUser=_,Object.defineProperty(y,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promte/app-library",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "private": false,
   "type": "module",
   "files": [