@promte/app-library 0.1.1 → 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

@@ -1,11 +1,69 @@
 import { default as default_2 } from 'react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 
+export declare type AppDataRef = {
+    get(): Promise<any>;
+    set(value: any): Promise<any>;
+    update(updates: AppDataUpdateMap): Promise<any>;
+    remove(): Promise<any>;
+    push(value: any): Promise<any>;
+    ref(path: string): AppDataRef;
+};
+
+export declare type AppDataScope = "private" | "public";
+
+export declare type AppDataUpdateMap = Record<string, any>;
+
+export declare type AudioSttRequest = {
+    file: File | Blob;
+    language?: string;
+    prompt?: string;
+    ext?: string;
+};
+
+export declare type AudioSttResponse = {
+    text: string;
+    raw: any;
+};
+
+export declare type AudioTtsRequest = {
+    text: string;
+    voice?: string;
+    lang?: string;
+};
+
+export declare type AudioTtsResponse = {
+    audio: ArrayBuffer;
+    contentType: string | null;
+};
+
+export declare type AudioVoiceInfo = {
+    short_name?: string;
+    locale?: string;
+    local_name?: string;
+    locale_english_name?: string;
+    locale_native_name?: string;
+    gender?: string;
+    voice_type?: string;
+    name?: string;
+    display_name?: string;
+    style_list?: string[];
+    sample_rate_hertz?: string;
+    status?: string;
+    words_per_minute?: string;
+};
+
+export declare type AudioVoicesRequest = {
+    locale?: string;
+};
+
 export declare type ChatCompletionsRequest = {
     model: string;
     messages: ChatMessage[];
     stream?: false;
     temperature?: number;
+    reasoningEffort?: ReasoningEffort;
+    reasoning_effort?: ReasoningEffort;
 };
 
 export declare type ChatCompletionsResponse = any;
@@ -31,14 +89,22 @@ 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: {
+        tts(req: AudioTtsRequest): Promise<AudioTtsResponse>;
+        stt(req: AudioSttRequest): Promise<AudioSttResponse>;
+        voices(req?: AudioVoicesRequest): Promise<AudioVoiceInfo[]>;
+    };
+    data(scope?: AppDataScope): AppDataRef;
 };
 
 declare type PromteCtxValue = {
     settings: PromteSettings | null;
     token: string | null;
     isDarkMode: boolean | null;
+    user: PromteUser | null;
     ready: boolean;
     state: PromteHandshakeState;
     error: string | null;
@@ -47,21 +113,59 @@ 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;
     backendUrl: string;
     parentOrigin?: string;
+    user?: PromteUser;
 };
 
+export declare type PromteUser = {
+    email?: string;
+    isAdmin?: boolean;
+    role?: string;
+    workspaceId?: string;
+};
+
+export declare type ReasoningEffort = "minimal" | "low" | "medium" | "high";
+
 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;
 
+export declare function usePromteUser(): PromteUser;
+
 export { }

package/dist/index.mjs

@@ -1,145 +1,344 @@
-import { jsx as T } from "react/jsx-runtime";
-import { createContext as U, useState as w, useMemo as p, useCallback as j, useEffect as g, useContext as x } from "react";
-const P = U(null);
-function L({
-  children: u,
-  expectedParentOrigin: o,
-  initTargetOrigin: f,
-  retryInit: n = { enabled: !0, intervalMs: 500, maxAttempts: 20 }
+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: f,
+  expectedParentOrigin: p,
+  initTargetOrigin: E,
+  retryInit: d = { enabled: !0, intervalMs: 500, maxAttempts: 20 }
 }) {
-  const [t, c] = w(null), [e, i] = w(null), [v, E] = w(null), [m, k] = w(null), y = p(() => m ? "booting" : t ? e ? "ready" : "waiting_for_token" : "waiting_for_settings", [t, e, m]), b = y === "ready", M = p(() => f || o || "*", [f, o]), d = j(() => {
-    var l;
+  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 s = { type: "init" };
-      (l = window.parent) == null || l.postMessage(s, M);
-    } catch (s) {
-      k((s == null ? void 0 : s.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");
     }
-  }, [M]);
-  g(() => {
-    d();
-  }, [d]), g(() => {
-    if (!(n != null && n.enabled) || t) return;
-    const l = n.intervalMs ?? 500, s = n.maxAttempts ?? 20;
-    let r = 0;
-    const a = window.setInterval(() => {
-      if (t) {
-        window.clearInterval(a);
+  }, [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 (r += 1, r > s) {
-        window.clearInterval(a);
+      if (c += 1, c > w) {
+        window.clearInterval(l);
         return;
       }
-      d();
-    }, l);
-    return () => window.clearInterval(a);
-  }, [n, t, d]), g(() => {
-    const l = (s) => {
-      if (o && s.origin !== o) return;
-      const r = s.data;
-      if (!(!r || typeof r != "object")) {
-        if (r.type === "set-settings") {
-          const a = r.value;
-          if (!(a != null && a.backendUrl) || a.parentOrigin && o && a.parentOrigin !== o)
+      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;
-          c(a), k(null);
+          x(l), l != null && l.user && r(l.user), e(null);
           return;
         }
-        if (r.type === "set-token" && typeof r.value == "string") {
-          i(r.value), k(null);
+        if (c.type === "set-token" && typeof c.value == "string") {
+          g(c.value), e(null);
           return;
         }
-        if (r.type === "set-dark-mode" && typeof r.value == "boolean") {
-          E(r.value);
+        if (c.type === "set-dark-mode" && typeof c.value == "boolean") {
+          b(c.value);
+          return;
+        }
+        if (c.type === "set-user" && typeof c.value == "object") {
+          r(c.value);
           return;
         }
       }
     };
-    return window.addEventListener("message", l), () => window.removeEventListener("message", l);
-  }, [o]);
-  const C = p(() => D(
-    () => t,
-    () => e
-  ), [t, e]), A = p(
+    return window.addEventListener("message", v), () => window.removeEventListener("message", v);
+  }, [p]);
+  const y = P(() => O(
+    () => m,
+    () => h
+  ), [m, h]), a = P(
     () => ({
-      settings: t,
-      token: e,
-      isDarkMode: v,
-      ready: b,
-      state: y,
-      error: m,
-      client: C
+      settings: m,
+      token: h,
+      isDarkMode: k,
+      user: t,
+      ready: u,
+      state: o,
+      error: n,
+      client: y
     }),
-    [t, e, v, b, y, m, C]
+    [m, h, k, t, u, o, n, y]
   );
-  return /* @__PURE__ */ T(P.Provider, { value: A, children: u });
+  return /* @__PURE__ */ B(U.Provider, { value: a, children: f });
 }
-function h() {
-  const u = x(P);
-  if (!u)
+function $() {
+  const f = D(U);
+  if (!f)
     throw new Error("usePromte must be used inside <PromteAppProvider>");
-  return u;
+  return f;
 }
-function R() {
-  return h().settings;
+function J() {
+  return $().settings;
 }
-function B() {
-  return h().token;
+function N() {
+  return $().token;
+}
+function V() {
+  return $().isDarkMode;
+}
+function I() {
+  return $().user;
 }
 function F() {
-  return h().isDarkMode;
+  return $().client;
 }
-function $() {
-  return h().client;
+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 D(u, o) {
-  async function f(n, t) {
-    const c = u(), e = o();
-    if (!c) throw new Error("Promte settings not received yet");
+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 (!e) throw new Error("Promte token not received yet");
-    const i = new URL(c.backendUrl + "/" + n).toString();
-    return await fetch(i, {
-      ...t,
+    const o = n.backendUrl.replace(/\/+$/, ""), u = String(t || "").replace(/^\/+/, ""), s = `${o}/${u}`;
+    return await fetch(s, {
+      ...r,
       headers: {
-        ...t.headers || {},
+        ...r.headers || {},
         Authorization: `Bearer ${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)
+    }), 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 x(t) {
+    const r = new URLSearchParams();
+    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"
+    }), 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 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 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 e = g(r);
+        return x({ ...n, path: e || void 0 });
+      },
+      async set(e) {
+        const o = g(r);
+        return m("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 [u, s] of Object.entries(e)) {
+          const i = k(r, u);
+          if (!i)
+            throw new Error("update paths must be non-empty");
+          o[i] = s;
+        }
+        return m("update", { ...n, updates: o });
+      },
+      async remove() {
+        const e = g(r);
+        return m("remove", { ...n, path: e || void 0 });
+      },
+      async push(e) {
+        const o = g(r);
+        if (!o) throw new Error("push requires a path");
+        return m("array-push", { ...n, path: o, value: e });
+      },
+      ref(e) {
+        const o = k(r, e);
+        if (!o) throw new Error("ref requires a path");
+        return b(t, o);
+      }
+    };
+  };
   return {
     isReady() {
-      return !!u() && !!o();
+      return !!f() && !!p();
     },
     getBackendUrl() {
-      var n;
-      return ((n = u()) == null ? void 0 : n.backendUrl) ?? null;
+      var t;
+      return ((t = f()) == null ? void 0 : t.backendUrl) ?? null;
     },
-    async chatCompletions(n) {
-      var i;
-      const t = await f("/openai/chat/completions", {
+    async models(t) {
+      return h(t);
+    },
+    async chatCompletions(t) {
+      var a;
+      const {
+        reasoningEffort: r,
+        reasoning_effort: n,
+        ...e
+      } = t, o = r ?? n, u = {
+        ...e,
+        stream: !1
+      };
+      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({ ...n, stream: !1 })
-      }), e = (t.headers.get("content-type") || "").includes("application/json") ? await t.json() : await t.text();
-      if (!t.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 e == "string" ? e : ((i = e == null ? void 0 : e.error) == null ? void 0 : i.message) || `Request failed (${t.status})`
+          typeof y == "string" ? y : ((a = y == null ? void 0 : y.error) == null ? void 0 : a.message) || `Request failed (${s.status})`
         );
-      return e;
+      return y;
+    },
+    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(t) {
+        var o;
+        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 d("/app-api/audio/tts", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({
+            text: r,
+            voice: t.voice,
+            lang: t.lang
+          })
+        });
+        if (!n.ok) {
+          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(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: u
+          }
+        ), a = (i.headers.get("content-type") || "").includes("application/json") ? await i.json() : await i.text();
+        if (!i.ok)
+          throw new Error(
+            typeof a == "string" ? a : ((w = a == null ? void 0 : a.error) == null ? void 0 : w.message) || `Request failed (${i.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 r = new URLSearchParams();
+        t != null && t.locale && r.set("locale", t.locale);
+        const n = await d(
+          `/app-api/audio/tts/voices${r.toString() ? `?${r}` : ""}`,
+          { 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) || [];
+      }
     },
-    async chatText(n) {
-      var c, e, i;
-      const t = await this.chatCompletions(n);
-      return ((i = (e = (c = t == null ? void 0 : t.choices) == null ? void 0 : c[0]) == null ? void 0 : e.message) == null ? void 0 : i.content) ?? "";
+    data(t = "private") {
+      return b(t, "");
     }
   };
 }
 export {
-  L as PromteAppProvider,
-  h as usePromte,
-  $ as usePromteClient,
-  F as usePromteDarkMode,
-  R as usePromteSettings,
-  B as usePromteToken
+  z as PromteAppProvider,
+  $ 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(r,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):(r=typeof globalThis<"u"?globalThis:r||self,m(r.PromteAppLibrary={},r.jsxRuntime,r.react))})(this,function(r,m,o){"use strict";const g=o.createContext(null);function E({children:l,expectedParentOrigin:u,initTargetOrigin:w,retryInit:n={enabled:!0,intervalMs:500,maxAttempts:20}}){const[e,f]=o.useState(null),[t,c]=o.useState(null),[y,U]=o.useState(null),[h,k]=o.useState(null),P=o.useMemo(()=>h?"booting":e?t?"ready":"waiting_for_token":"waiting_for_settings",[e,t,h]),M=P==="ready",b=o.useMemo(()=>w||u||"*",[w,u]),v=o.useCallback(()=>{var d;try{const i={type:"init"};(d=window.parent)==null||d.postMessage(i,b)}catch(i){k((i==null?void 0:i.message)||"Failed to post init")}},[b]);o.useEffect(()=>{v()},[v]),o.useEffect(()=>{if(!(n!=null&&n.enabled)||e)return;const d=n.intervalMs??500,i=n.maxAttempts??20;let s=0;const a=window.setInterval(()=>{if(e){window.clearInterval(a);return}if(s+=1,s>i){window.clearInterval(a);return}v()},d);return()=>window.clearInterval(a)},[n,e,v]),o.useEffect(()=>{const d=i=>{if(u&&i.origin!==u)return;const s=i.data;if(!(!s||typeof s!="object")){if(s.type==="set-settings"){const a=s.value;if(!(a!=null&&a.backendUrl)||a.parentOrigin&&u&&a.parentOrigin!==u)return;f(a),k(null);return}if(s.type==="set-token"&&typeof s.value=="string"){c(s.value),k(null);return}if(s.type==="set-dark-mode"&&typeof s.value=="boolean"){U(s.value);return}}};return window.addEventListener("message",d),()=>window.removeEventListener("message",d)},[u]);const C=o.useMemo(()=>D(()=>e,()=>t),[e,t]),L=o.useMemo(()=>({settings:e,token:t,isDarkMode:y,ready:M,state:P,error:h,client:C}),[e,t,y,M,P,h,C]);return m.jsx(g.Provider,{value:L,children:l})}function p(){const l=o.useContext(g);if(!l)throw new Error("usePromte must be used inside <PromteAppProvider>");return l}function S(){return p().settings}function j(){return p().token}function T(){return p().isDarkMode}function A(){return p().client}function D(l,u){async function w(n,e){const f=l(),t=u();if(!f)throw new Error("Promte settings not received yet");if(!t)throw new Error("Promte token not received yet");const c=new URL(f.backendUrl+"/"+n).toString();return await fetch(c,{...e,headers:{...e.headers||{},Authorization:`Bearer ${t}`}})}return{isReady(){return!!l()&&!!u()},getBackendUrl(){var n;return((n=l())==null?void 0:n.backendUrl)??null},async chatCompletions(n){var c;const e=await w("/openai/chat/completions",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({...n,stream:!1})}),t=(e.headers.get("content-type")||"").includes("application/json")?await e.json():await e.text();if(!e.ok)throw new Error(typeof t=="string"?t:((c=t==null?void 0:t.error)==null?void 0:c.message)||`Request failed (${e.status})`);return t},async chatText(n){var f,t,c;const e=await this.chatCompletions(n);return((c=(t=(f=e==null?void 0:e.choices)==null?void 0:f[0])==null?void 0:t.message)==null?void 0:c.content)??""}}}r.PromteAppProvider=E,r.usePromte=p,r.usePromteClient=A,r.usePromteDarkMode=T,r.usePromteSettings=S,r.usePromteToken=j,Object.defineProperty(r,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.1",
+  "version": "0.1.3",
   "private": false,
   "type": "module",
   "files": [