@promte/app-library 0.1.2 → 0.1.3

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