@promte/app-library 0.1.6 → 0.1.8

package/README.md

@@ -60,6 +60,23 @@ await client.data().ref("sessions/session-1/events").push({
 });
 ```
 
+## Backend functions
+
+Call an approved app function or a configured shared-function alias after the provider is ready:
+
+```ts
+const { ready } = usePromte();
+const client = usePromteClient();
+if (ready) {
+  const output = await client.functions.invoke("hello", { name: "Ada" });
+  // output is the handler result, not the administration run envelope.
+}
+```
+
+The running app is bound to its authorized release. In coding preview, calls use the saved draft and the test environment, which can contact real test APIs. Personal sign-in, workspace access and current function governance are required. Credentials stay in administrator-managed connections and must never be placed in browser code.
+
+See [App backend functions](../docs/app-functions.md) for manifests, handlers, controlled connections, data scopes, testing, releases, sharing and schedules.
+
 ## Models/capabilities
 
 You can fetch configured models/capabilities from backend:

package/dist/index.d.ts

@@ -14,15 +14,49 @@ export declare type AppDataScope = "private" | "public";
 
 export declare type AppDataUpdateMap = Record<string, any>;
 
+/** A stored file. Names may contain folders, e.g. "corpus/2024/report.pdf". */
+export declare type AppFile = {
+    id: string;
+    name: string;
+    contentType: string;
+    size: number;
+    sha256: string;
+    createdAt: string;
+    updatedAt: string;
+};
+
+/**
+ * File storage for larger or binary content (documents, images, exports).
+ * "private" files belong to the signed-in user; "public" files are shared in the
+ * app workspace and only workspace administrators can change them.
+ * Uploading a file with an existing name replaces it.
+ */
+export declare type AppFiles = {
+    upload(file: Blob, options?: {
+        name?: string;
+        contentType?: string;
+        signal?: AbortSignal;
+    }): Promise<AppFile>;
+    list(options?: {
+        prefix?: string;
+    }): Promise<AppFile[]>;
+    download(id: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<Blob>;
+    remove(id: string): Promise<void>;
+};
+
 export declare type AudioSttRequest = {
     file: File | Blob;
     language?: string;
     prompt?: string;
+    responseFormat?: "json" | "verbose_json";
     ext?: string;
 };
 
 export declare type AudioSttResponse = {
     text: string;
+    language?: string;
     raw: any;
 };
 
@@ -68,9 +102,20 @@ export declare type ChatCompletionsRequest = {
 
 export declare type ChatCompletionsResponse = any;
 
+export declare type ChatContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "auto" | "low" | "high" | "original";
+    };
+};
+
 export declare type ChatMessage = {
     role: "system" | "user" | "assistant" | "tool";
-    content: string;
+    content: string | ChatContentPart[];
 };
 
 export declare type EmbeddingItem = {
@@ -149,6 +194,9 @@ export declare type PromteAppProviderProps = {
 
 export declare type PromteClient = {
     isReady(): boolean;
+    functions: {
+        invoke<TInput = unknown, TResult = unknown>(name: string, input: TInput): Promise<TResult>;
+    };
     getBackendUrl(): string | null;
     models(req?: PromteModelsRequest): Promise<PromteModelInfo[]>;
     chatCompletions(req: ChatCompletionsRequest): Promise<ChatCompletionsResponse>;
@@ -157,6 +205,16 @@ export declare type PromteClient = {
         create(req: EmbeddingsRequest): Promise<EmbeddingsResponse>;
     };
     audio: {
+        speechToken(): Promise<{
+            token: string;
+            region: string;
+        }>;
+        voiceLiveSession(): Promise<{
+            sessionToken: string;
+            websocketUrl: string;
+            model: string;
+            transcriptionModel: string;
+        }>;
         tts(req: AudioTtsRequest): Promise<AudioTtsResponse>;
         stt(req: AudioSttRequest): Promise<AudioSttResponse>;
         voices(req?: AudioVoicesRequest): Promise<AudioVoiceInfo[]>;
@@ -167,7 +225,20 @@ export declare type PromteClient = {
     knowledge: {
         search(req: KnowledgeSearchRequest): Promise<KnowledgeSearchResponse>;
     };
+    translatorLiveShare: {
+        create(displayLanguage: string): Promise<{
+            shareId: string;
+            token: string;
+            expiresAt: string;
+        }>;
+        update(shareId: string, snapshot: TranslatorLiveShareSnapshot): Promise<void>;
+        revoke(shareId: string): Promise<void>;
+    };
+    guardrails: {
+        check(value: unknown): Promise<PromteGuardrailsResult>;
+    };
     data(scope?: AppDataScope): AppDataRef;
+    files(scope?: AppDataScope): AppFiles;
 };
 
 declare type PromteCtxValue = {
@@ -181,6 +252,19 @@ declare type PromteCtxValue = {
     client: PromteClient;
 };
 
+export declare type PromteGuardrailsResult = {
+    enabled: boolean;
+    allowed: boolean;
+    outcome: "allow" | "warn" | "block";
+    checks: Array<{
+        id: string;
+        mode: "warn" | "block";
+        result: "violation" | "inconclusive";
+        matches?: number;
+    }>;
+    revision: string;
+};
+
 export declare type PromteHandshakeState = "booting" | "waiting_for_settings" | "waiting_for_token" | "ready";
 
 export declare type PromteModelInfo = {
@@ -198,12 +282,28 @@ export declare type PromteModelsRequest = {
 
 export declare type PromteModelType = "llm" | "embedding" | "image" | "stt" | "tts";
 
+/**
+ * Provides the same Promte runtime to first-party, in-process features without
+ * duplicating the app client or emulating the iframe postMessage handshake.
+ */
+export declare function PromteNativeProvider({ children, settings, token, isDarkMode, user, }: PromteNativeProviderProps): JSX_2.Element;
+
+export declare type PromteNativeProviderProps = {
+    children: default_2.ReactNode;
+    settings: PromteSettings;
+    token: string | null;
+    isDarkMode: boolean;
+    user: PromteUser | null;
+};
+
 export declare type PromteSettings = {
     workspaceId: string;
     version: number;
     backendUrl: string;
     parentOrigin?: string;
     user?: PromteUser;
+    /** Set by Promte pages that can send backend requests for the app. */
+    fetchProxy?: boolean;
 };
 
 export declare type PromteUser = {
@@ -238,6 +338,23 @@ export declare type ScrapeUrlResponse = {
     };
 };
 
+export declare type TranslatorLiveShareLine = {
+    id: string;
+    speaker: string;
+    language?: string;
+    text: string;
+    pending?: boolean;
+    edited?: boolean;
+    createdAt: string;
+};
+
+export declare type TranslatorLiveShareSnapshot = {
+    displayLanguage: string;
+    status: "active" | "ended";
+    lines: TranslatorLiveShareLine[];
+    revision: number;
+};
+
 export declare function usePromte(): PromteCtxValue;
 
 export declare function usePromteClient(): PromteClient;
@@ -257,6 +374,10 @@ export declare type UsePromteModelsOptions = PromteModelsRequest & {
 
 export declare function usePromteSettings(): PromteSettings;
 
+/**
+ * @deprecated Promte sends backend requests for the app and no longer gives
+ * the app a token, so this returns null inside current Promte versions.
+ */
 export declare function usePromteToken(): string;
 
 export declare function usePromteUser(): PromteUser;

package/dist/index.mjs

@@ -1,373 +1,508 @@
-import { jsx as B } from "react/jsx-runtime";
-import { createContext as L, useState as k, useMemo as T, useCallback as M, useEffect as $, useContext as D } from "react";
-const O = L(null);
-function _({
-  children: p,
-  expectedParentOrigin: d,
-  initTargetOrigin: v,
-  retryInit: l = { enabled: !0, intervalMs: 500, maxAttempts: 20 }
+import { jsx as I } from "react/jsx-runtime";
+import { createContext as G, useState as $, useMemo as x, useCallback as _, useEffect as R, useContext as z } from "react";
+const V = "promte-fetch-request", W = "promte-fetch-response", H = /* @__PURE__ */ new Set([101, 103, 204, 205, 304]);
+function Q() {
+  return typeof crypto < "u" && "randomUUID" in crypto ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+}
+function F(i) {
+  return i.reason ?? new DOMException("The operation was aborted.", "AbortError");
+}
+function K(i, p) {
+  if (i == null) return null;
+  if (typeof i == "string" || i instanceof Blob || i instanceof ArrayBuffer || ArrayBuffer.isView(i))
+    return i;
+  if (i instanceof URLSearchParams)
+    return p.has("content-type") || p.set("content-type", "application/x-www-form-urlencoded;charset=UTF-8"), i.toString();
+  if (i instanceof FormData) {
+    const w = [];
+    return i.forEach((h, a) => w.push([a, h])), { form: w };
+  }
+  throw new TypeError("This request body cannot be sent through Promte.");
+}
+function X({ target: i, origin: p }, w, h) {
+  return new Promise((a, y) => {
+    const l = h.signal;
+    if (l != null && l.aborted) return y(F(l));
+    const P = Q(), g = new Headers(h.headers);
+    g.delete("authorization");
+    let v;
+    try {
+      v = K(h.body, g);
+    } catch (r) {
+      return y(r);
+    }
+    const S = () => {
+      window.removeEventListener("message", t), l == null || l.removeEventListener("abort", k);
+    }, k = () => {
+      S(), y(F(l));
+    }, t = (r) => {
+      if (r.source !== i || r.origin !== p) return;
+      const e = r.data;
+      if (!e || e.type !== W || e.id !== P) return;
+      if (S(), typeof e.error == "string")
+        return y(new TypeError(e.error));
+      const o = Number(e.status);
+      if (!Number.isInteger(o) || o < 200 || o > 599)
+        return y(new TypeError("Promte returned an invalid response."));
+      try {
+        a(
+          new Response(H.has(o) ? null : e.body ?? null, {
+            status: o,
+            statusText: typeof e.statusText == "string" ? e.statusText : "",
+            headers: Array.isArray(e.headers) ? e.headers : []
+          })
+        );
+      } catch {
+        y(new TypeError("Promte returned an invalid response."));
+      }
+    };
+    window.addEventListener("message", t), l == null || l.addEventListener("abort", k, { once: !0 });
+    const n = [];
+    g.forEach((r, e) => n.push([e, r]));
+    try {
+      i.postMessage(
+        {
+          type: V,
+          id: P,
+          path: w,
+          method: (h.method || "GET").toUpperCase(),
+          headers: n,
+          body: v
+        },
+        p
+      );
+    } catch (r) {
+      S(), y(r);
+    }
+  });
+}
+const j = G(null);
+function tt({
+  children: i,
+  expectedParentOrigin: p,
+  initTargetOrigin: w,
+  retryInit: h = { enabled: !0, intervalMs: 500, maxAttempts: 20 }
 }) {
-  const [m, x] = k(null), [h, S] = k(null), [y, b] = k(null), [E, t] = k(null), [r, e] = k(null), n = T(() => r ? "booting" : m ? h ? "ready" : "waiting_for_token" : "waiting_for_settings", [m, h, r]), s = n === "ready", c = T(() => v || d || "*", [v, d]), a = M(() => {
-    var o;
+  const [a, y] = $(null), [l, P] = $(null), [g, v] = $(null), [S, k] = $(null), [t, n] = $(null), [r, e] = $(null), o = x(() => t ? "booting" : a ? !l && !a.fetchProxy ? "waiting_for_token" : "ready" : "waiting_for_settings", [a, l, t]), u = o === "ready", d = x(() => w || p || "*", [w, p]), c = _(() => {
+    var T;
     try {
-      const w = { type: "init" };
-      (o = window.parent) == null || o.postMessage(w, c);
-    } catch (w) {
-      e((w == null ? void 0 : w.message) || "Failed to post init");
+      const s = { type: "init", fetchProxy: !0 };
+      (T = window.parent) == null || T.postMessage(s, d);
+    } catch (s) {
+      n((s == null ? void 0 : s.message) || "Failed to post init");
     }
-  }, [c]);
-  $(() => {
-    a();
-  }, [a]), $(() => {
-    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);
+  }, [d]);
+  R(() => {
+    c();
+  }, [c]), R(() => {
+    if (!(h != null && h.enabled) || a) return;
+    const T = h.intervalMs ?? 500, s = h.maxAttempts ?? 20;
+    let m = 0;
+    const E = window.setInterval(() => {
+      if (a) {
+        window.clearInterval(E);
         return;
       }
-      if (i += 1, i > w) {
-        window.clearInterval(f);
+      if (m += 1, m > s) {
+        window.clearInterval(E);
         return;
       }
-      a();
-    }, o);
-    return () => window.clearInterval(f);
-  }, [l, m, a]), $(() => {
-    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)
+      c();
+    }, T);
+    return () => window.clearInterval(E);
+  }, [h, a, c]), R(() => {
+    const T = (s) => {
+      if (p && s.origin !== p) return;
+      const m = s.data;
+      if (!(!m || typeof m != "object")) {
+        if (m.type === "set-settings") {
+          const E = m.value;
+          if (!(E != null && E.backendUrl) || E.parentOrigin && p && E.parentOrigin !== p)
             return;
-          x(f), f != null && f.user && t(f.user), e(null);
+          y(E), e(s.source === window.parent ? s.origin : null), E != null && E.user && k(E.user), n(null);
           return;
         }
-        if (i.type === "set-token" && typeof i.value == "string") {
-          S(i.value), e(null);
+        if (m.type === "set-token" && typeof m.value == "string") {
+          P(m.value), n(null);
           return;
         }
-        if (i.type === "set-dark-mode" && typeof i.value == "boolean") {
-          b(i.value);
+        if (m.type === "set-dark-mode" && typeof m.value == "boolean") {
+          v(m.value);
           return;
         }
-        if (i.type === "set-user" && typeof i.value == "object") {
-          t(i.value);
+        if (m.type === "set-user" && typeof m.value == "object") {
+          k(m.value);
           return;
         }
       }
     };
-    return window.addEventListener("message", o), () => window.removeEventListener("message", o);
-  }, [d]);
-  const u = T(() => F(
-    () => m,
-    () => h
-  ), [m, h]), g = T(
+    return window.addEventListener("message", T), () => window.removeEventListener("message", T);
+  }, [p]);
+  const f = x(() => J(
+    () => a,
+    () => l,
+    () => a != null && a.fetchProxy && r && window.parent !== window ? { target: window.parent, origin: r } : null
+  ), [a, l, r]), b = x(
     () => ({
-      settings: m,
-      token: h,
-      isDarkMode: y,
-      user: E,
-      ready: s,
-      state: n,
-      error: r,
-      client: u
+      settings: a,
+      token: l,
+      isDarkMode: g,
+      user: S,
+      ready: u,
+      state: o,
+      error: t,
+      client: f
     }),
-    [m, h, y, E, s, n, r, u]
+    [a, l, g, S, u, o, t, f]
   );
-  return /* @__PURE__ */ B(O.Provider, { value: g, children: p });
+  return /* @__PURE__ */ I(j.Provider, { value: b, children: i });
 }
-function j() {
-  const p = D(O);
-  if (!p)
-    throw new Error("usePromte must be used inside <PromteAppProvider>");
-  return p;
+function et({
+  children: i,
+  settings: p,
+  token: w,
+  isDarkMode: h,
+  user: a
+}) {
+  const y = x(
+    () => J(() => p, () => w),
+    [p, w]
+  ), l = !!w, P = x(
+    () => ({
+      settings: p,
+      token: w,
+      isDarkMode: h,
+      user: a,
+      ready: l,
+      state: l ? "ready" : "waiting_for_token",
+      error: null,
+      client: y
+    }),
+    [y, h, l, p, w, a]
+  );
+  return /* @__PURE__ */ I(j.Provider, { value: P, children: i });
 }
-function G() {
-  return j().settings;
+function C() {
+  const i = z(j);
+  if (!i)
+    throw new Error(
+      "usePromte must be used inside <PromteAppProvider> or <PromteNativeProvider>"
+    );
+  return i;
 }
-function z() {
-  return j().token;
+function rt() {
+  return C().settings;
 }
-function V() {
-  return j().isDarkMode;
+function nt() {
+  return C().token;
 }
-function Q() {
-  return j().user;
+function ot() {
+  return C().isDarkMode;
+}
+function st() {
+  return C().user;
 }
-function I() {
-  return j().client;
+function Y() {
+  return C().client;
 }
-function W(p = {}) {
-  const { ready: d } = j(), v = I(), [l, m] = k([]), [x, h] = k(!1), [S, y] = k(null), b = T(() => (Array.isArray(p.type) ? p.type : p.type ? [p.type] : []).filter(Boolean).map((n) => String(n)).join(","), [p.type]), E = p.configuredOnly === !0, t = p.auto !== !1, r = M(async () => {
-    if (!d) return [];
-    h(!0), y(null);
+function at(i = {}) {
+  const { ready: p } = C(), w = Y(), [h, a] = $([]), [y, l] = $(!1), [P, g] = $(null), v = x(() => (Array.isArray(i.type) ? i.type : i.type ? [i.type] : []).filter(Boolean).map((r) => String(r)).join(","), [i.type]), S = i.configuredOnly === !0, k = i.auto !== !1, t = _(async () => {
+    if (!p) return [];
+    l(!0), g(null);
     try {
-      const e = b ? b.split(",").filter(Boolean) : void 0, n = await v.models({ type: e, configuredOnly: E });
-      return m(n), n;
-    } catch (e) {
-      const n = e instanceof Error ? e.message : String(e);
-      throw y(n), e;
+      const n = v ? v.split(",").filter(Boolean) : void 0, r = await w.models({ type: n, configuredOnly: S });
+      return a(r), r;
+    } catch (n) {
+      const r = n instanceof Error ? n.message : String(n);
+      throw g(r), n;
     } finally {
-      h(!1);
+      l(!1);
     }
-  }, [v, E, d, b]);
-  return $(() => {
-    !t || !d || r().catch(() => {
+  }, [w, S, p, v]);
+  return R(() => {
+    !k || !p || t().catch(() => {
     });
-  }, [t, d, r]), { models: l, loading: x, error: S, reload: r };
+  }, [k, p, t]), { models: h, loading: y, error: P, reload: t };
 }
-function F(p, d) {
-  const v = (t) => typeof t == "string" && t.startsWith("gpt-5");
-  async function l(t, r) {
-    const e = p(), n = d();
-    if (!e) throw new Error("Promte settings not received yet");
-    if (!n) throw new Error("Promte token not received yet");
-    const s = e.backendUrl.replace(/\/+$/, ""), c = String(t || "").replace(/^\/+/, ""), a = `${s}/${c}`;
-    return await fetch(a, {
-      ...r,
+function J(i, p, w = () => null) {
+  const h = (t) => typeof t == "string" && (t.startsWith("gpt-5") || t.startsWith("gpt-6"));
+  async function a(t, n) {
+    const r = i(), e = p();
+    if (!r) throw new Error("Promte settings not received yet");
+    const o = r.backendUrl.replace(/\/+$/, ""), u = String(t || "").replace(/^\/+/, ""), d = `${o}/${u}`, c = w();
+    if (!c && !e) throw new Error("Promte token not received yet");
+    const f = c ? await X(c, u, n) : await fetch(d, {
+      ...n,
       headers: {
-        ...r.headers || {},
-        Authorization: `Bearer ${n}`
+        ...n.headers || {},
+        Authorization: `Bearer ${e}`
       }
     });
+    return f.headers.get("X-Promte-Governance-Warning") && (typeof window < "u" && window.dispatchEvent(new CustomEvent("promte:governance-warning", { detail: { endpoint: t } })), console.warn("Promte governance: this request triggered a warning policy.")), f;
   }
-  async function m(t, r) {
-    const e = await l(`/app-api/data/${t}`, {
+  async function y(t, n) {
+    const r = await a(`/app-api/data/${t}`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(r)
-    }), n = await e.json().catch(() => ({}));
-    if (!e.ok)
+      body: JSON.stringify(n)
+    }), e = await r.json().catch(() => ({}));
+    if (!r.ok)
       throw new Error(
-        (n == null ? void 0 : n.error) || `Request failed (${e.status})`
+        (e == null ? void 0 : e.error) || `Request failed (${r.status})`
       );
-    return n == null ? void 0 : n.value;
+    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 e = await l(`/app-api/data?${r.toString()}`, {
+  async function l(t) {
+    const n = new URLSearchParams();
+    t.scope && n.set("scope", t.scope), t.path && n.set("path", t.path);
+    const r = await a(`/app-api/data?${n.toString()}`, {
       method: "GET"
-    }), n = await e.json().catch(() => ({}));
-    if (!e.ok)
-      throw new Error((n == null ? void 0 : n.error) || `Request failed (${e.status})`);
-    return n == null ? void 0 : n.value;
+    }), e = await r.json().catch(() => ({}));
+    if (!r.ok)
+      throw new Error((e == null ? void 0 : e.error) || `Request failed (${r.status})`);
+    return e == null ? void 0 : e.value;
   }
-  async function h(t) {
-    const r = new URLSearchParams(), e = Array.isArray(t == null ? void 0 : t.type) ? t == null ? void 0 : t.type : t != null && t.type ? [t.type] : [];
-    e.length > 0 && r.set("type", e.join(",")), t != null && t.configuredOnly && r.set("configuredOnly", "true");
-    const n = await l(
-      `/app-api/models${r.toString() ? `?${r.toString()}` : ""}`,
+  async function P(t) {
+    const n = new URLSearchParams(), r = t == null ? void 0 : t.type, e = Array.isArray(r) ? r : r ? [r] : [];
+    e.length > 0 && n.set("type", e.join(",")), t != null && t.configuredOnly && n.set("configuredOnly", "true");
+    const o = await a(
+      `/app-api/models${n.toString() ? `?${n.toString()}` : ""}`,
       { method: "GET" }
-    ), s = await n.json().catch(() => ({}));
-    if (!n.ok)
-      throw new Error((s == null ? void 0 : s.error) || `Request failed (${n.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
+    ), u = await o.json().catch(() => ({}));
+    if (!o.ok)
+      throw new Error((u == null ? void 0 : u.error) || `Request failed (${o.status})`);
+    return (Array.isArray(u == null ? void 0 : u.models) ? u.models : []).map((c) => {
+      if (!c || typeof c != "object") return null;
+      const f = typeof c.id == "string" ? c.id.trim() : "", b = typeof c.label == "string" ? c.label.trim() : f, T = c.type, s = c.configured === !0, m = typeof c.source == "string" && c.source.trim() ? c.source.trim() : void 0;
+      return !f || T !== "llm" && T !== "embedding" && T !== "image" && T !== "stt" && T !== "tts" ? null : {
+        id: f,
+        label: b || f,
+        type: T,
+        configured: s,
+        source: m
       };
     }).filter(
-      (a) => !!a
+      (c) => !!c
     );
   }
-  async function S(t, r) {
-    const e = await l(t, r), s = (e.headers.get("content-type") || "").includes("application/json") ? await e.json().catch(() => ({})) : await e.text();
-    if (!e.ok)
+  async function g(t, n) {
+    const r = await a(t, n), o = (r.headers.get("content-type") || "").includes("application/json") ? await r.json().catch(() => ({})) : await r.text();
+    if (!r.ok)
       throw new Error(
-        typeof s == "string" ? s || `Request failed (${e.status})` : (s == null ? void 0 : s.error) || (s == null ? void 0 : s.message) || `Request failed (${e.status})`
+        typeof o == "string" ? o || `Request failed (${r.status})` : (o == null ? void 0 : o.error) || (o == null ? void 0 : o.message) || `Request failed (${r.status})`
       );
-    return s;
+    return o;
   }
-  const y = (t) => t ? t.split("/").map((r) => r.trim()).filter(Boolean).join("/") : "", b = (t, r) => {
-    const e = y(t), n = y(r);
-    return e ? n ? `${e}/${n}` : e : n;
-  }, E = (t, r) => {
-    const e = { scope: t };
+  const v = (t) => t ? t.split("/").map((n) => n.trim()).filter(Boolean).join("/") : "", S = (t, n) => {
+    const r = v(t), e = v(n);
+    return r ? e ? `${r}/${e}` : r : e;
+  }, k = (t, n) => {
+    const r = { scope: t };
     return {
       async get() {
-        const n = y(r);
-        return x({ ...e, path: n || void 0 });
+        const e = v(n);
+        return l({ ...r, path: e || void 0 });
       },
-      async set(n) {
-        const s = y(r);
-        return m("set", {
-          ...e,
-          path: s || void 0,
-          value: n
+      async set(e) {
+        const o = v(n);
+        return y("set", {
+          ...r,
+          path: o || void 0,
+          value: e
         });
       },
-      async update(n) {
-        if (!n || typeof n != "object")
+      async update(e) {
+        if (!e || typeof e != "object")
           throw new Error("update requires an object");
-        const s = {};
-        for (const [c, a] of Object.entries(n)) {
-          const u = b(r, c);
-          if (!u)
+        const o = {};
+        for (const [u, d] of Object.entries(e)) {
+          const c = S(n, u);
+          if (!c)
             throw new Error("update paths must be non-empty");
-          s[u] = a;
+          o[c] = d;
         }
-        return m("update", { ...e, updates: s });
+        return y("update", { ...r, updates: o });
       },
       async remove() {
-        const n = y(r);
-        return m("remove", { ...e, path: n || void 0 });
+        const e = v(n);
+        return y("remove", { ...r, path: e || void 0 });
       },
-      async push(n) {
-        const s = y(r);
-        if (!s) throw new Error("push requires a path");
-        return m("array-push", { ...e, path: s, value: n });
+      async push(e) {
+        const o = v(n);
+        if (!o) throw new Error("push requires a path");
+        return y("array-push", { ...r, path: o, value: e });
       },
-      ref(n) {
-        const s = b(r, n);
-        if (!s) throw new Error("ref requires a path");
-        return E(t, s);
+      ref(e) {
+        const o = S(n, e);
+        if (!o) throw new Error("ref requires a path");
+        return k(t, o);
       }
     };
   };
   return {
+    functions: {
+      async invoke(t, n) {
+        if (!/^[a-z][a-z0-9-]{0,63}$/.test(t)) throw new Error("Choose a valid function name or configured binding alias.");
+        const r = await a("/app-api/functions/invoke", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ name: t, input: n })
+        }), e = await r.json().catch(() => ({}));
+        if (!r.ok) throw new Error((e == null ? void 0 : e.error) || `Function call failed (${r.status})`);
+        return e.output;
+      }
+    },
     isReady() {
-      return !!p() && !!d();
+      return !!i() && (!!p() || !!w());
     },
     getBackendUrl() {
       var t;
-      return ((t = p()) == null ? void 0 : t.backendUrl) ?? null;
+      return ((t = i()) == null ? void 0 : t.backendUrl) ?? null;
     },
     async models(t) {
-      return h(t);
+      return P(t);
     },
     async chatCompletions(t) {
-      var o;
+      var b;
       const {
-        reasoningEffort: r,
-        reasoning_effort: e,
-        ...n
-      } = t, s = r ?? e, c = {
-        ...n,
+        reasoningEffort: n,
+        reasoning_effort: r,
+        ...e
+      } = t, o = n ?? r, u = {
+        ...e,
         stream: !1
       };
-      s && v(t.model) && (c.reasoning_effort = s);
-      const a = await l("/openai/chat/completions", {
+      o && h(t.model) && (u.reasoning_effort = o);
+      const d = await a("/openai/chat/completions", {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(c)
-      }), g = (a.headers.get("content-type") || "").includes("application/json") ? await a.json() : await a.text();
-      if (!a.ok)
+        body: JSON.stringify(u)
+      }), f = (d.headers.get("content-type") || "").includes("application/json") ? await d.json() : await d.text();
+      if (!d.ok)
         throw new Error(
-          typeof g == "string" ? g : ((o = g == null ? void 0 : g.error) == null ? void 0 : o.message) || `Request failed (${a.status})`
+          typeof f == "string" ? f : (typeof (f == null ? void 0 : f.error) == "string" ? f.error : (b = f == null ? void 0 : f.error) == null ? void 0 : b.message) || `Request failed (${d.status})`
         );
-      return g;
+      return f;
     },
     async chatText(t) {
-      var e, n, s;
-      const r = await this.chatCompletions(t);
-      return ((s = (n = (e = r == null ? void 0 : r.choices) == null ? void 0 : e[0]) == null ? void 0 : n.message) == null ? void 0 : s.content) ?? "";
+      var r, e, o;
+      const n = await this.chatCompletions(t);
+      return ((o = (e = (r = n == null ? void 0 : n.choices) == null ? void 0 : r[0]) == null ? void 0 : e.message) == null ? void 0 : o.content) ?? "";
     },
     embeddings: {
       async create(t) {
-        var s;
-        const r = (s = t == null ? void 0 : t.model) == null ? void 0 : s.trim();
-        if (!r) throw new Error("embeddings.create requires a model");
-        const e = t == null ? void 0 : t.input;
-        if (!(typeof e == "string" ? e.length > 0 : Array.isArray(e) && e.length > 0 && e.every((c) => typeof c == "string")))
+        var o;
+        const n = (o = t == null ? void 0 : t.model) == null ? void 0 : o.trim();
+        if (!n) throw new Error("embeddings.create requires a model");
+        const r = t == null ? void 0 : t.input;
+        if (!(typeof r == "string" ? r.length > 0 : Array.isArray(r) && r.length > 0 && r.every((u) => typeof u == "string")))
           throw new Error(
             "embeddings.create requires input as a string or string[]"
           );
-        return S("/openai/embeddings", {
+        return g("/openai/embeddings", {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({
             ...t,
-            model: r,
-            input: e
+            model: n,
+            input: r
           })
         });
       }
     },
     audio: {
+      async speechToken() {
+        const t = await a("/app-api/audio/speech-token", { method: "POST" });
+        if (!t.ok) throw new Error("Live talegenkendelse er ikke tilgængelig. Kontakt administratoren.");
+        return t.json();
+      },
+      async voiceLiveSession() {
+        const t = await a("/app-api/audio/voice-live-session", {
+          method: "POST"
+        });
+        if (!t.ok) {
+          const n = await t.text();
+          throw new Error(n || "Voice Live er ikke tilgængelig.");
+        }
+        return t.json();
+      },
       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 e = await l("/app-api/audio/tts", {
+        var o;
+        const n = (o = t == null ? void 0 : t.text) == null ? void 0 : o.trim();
+        if (!n) throw new Error("audio.tts requires non-empty text");
+        const r = await a("/app-api/audio/tts", {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({
-            text: r,
+            text: n,
             voice: t.voice,
             lang: t.lang
           })
         });
-        if (!e.ok) {
-          const c = await e.text();
-          throw new Error(c || `Request failed (${e.status})`);
+        if (!r.ok) {
+          const u = await r.text();
+          throw new Error(u || `Request failed (${r.status})`);
         }
         return {
-          audio: await e.arrayBuffer(),
-          contentType: e.headers.get("content-type")
+          audio: await r.arrayBuffer(),
+          contentType: r.headers.get("content-type")
         };
       },
       async stt(t) {
-        var i, f, P;
+        var U, O, L, A;
         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(), U = A.split("-")[0];
-          return U.length === 2 ? U : A;
-        }, e = typeof File < "u" && t.file instanceof File, n = e && t.file.name.split(".").pop() || "webm", s = t.ext || n, c = new FormData();
-        e ? 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)}`,
+        const n = (U = t.language) == null ? void 0 : U.trim(), r = (M) => {
+          if (!M) return;
+          const N = M.trim();
+          if (!N) return;
+          const B = N.toLowerCase(), D = B.split("-")[0];
+          return D.length === 2 ? D : B;
+        }, e = typeof File < "u" && t.file instanceof File, o = e && t.file.name.split(".").pop() || "webm", u = t.ext || o, d = new FormData();
+        e ? d.set("file", t.file) : d.set("file", t.file, `audio.${u}`);
+        const c = r(n);
+        c && d.set("language", c), t.prompt && d.set("prompt", t.prompt), t.responseFormat && d.set("response_format", t.responseFormat);
+        const f = new URLSearchParams({ ext: u });
+        n && f.set("locale", n);
+        const b = await a(
+          `/app-api/audio/stt?${f.toString()}`,
           {
             method: "POST",
-            body: c
+            body: d
           }
-        ), o = (u.headers.get("content-type") || "").includes("application/json") ? await u.json() : await u.text();
-        if (!u.ok)
+        ), s = (b.headers.get("content-type") || "").includes("application/json") ? await b.json() : await b.text();
+        if (!b.ok)
           throw new Error(
-            typeof o == "string" ? o : ((i = o == null ? void 0 : o.error) == null ? void 0 : i.message) || `Request failed (${u.status})`
+            typeof s == "string" ? s : (typeof (s == null ? void 0 : s.error) == "string" ? s.error : (O = s == null ? void 0 : s.error) == null ? void 0 : O.message) || `Request failed (${b.status})`
           );
-        return { text: typeof o == "string" ? o : (o == null ? void 0 : o.text) || (o == null ? void 0 : o.original) || ((P = (f = o == null ? void 0 : o.results) == null ? void 0 : f[0]) == null ? void 0 : P.text) || "", raw: o };
+        const m = typeof s == "string" ? s : (s == null ? void 0 : s.text) || (s == null ? void 0 : s.original) || ((A = (L = s == null ? void 0 : s.results) == null ? void 0 : L[0]) == null ? void 0 : A.text) || "", E = typeof s == "object" && typeof (s == null ? void 0 : s.language) == "string" ? s.language : void 0;
+        return { text: m, language: E, raw: s };
       },
       async voices(t) {
-        const r = new URLSearchParams();
-        t != null && t.locale && r.set("locale", t.locale);
-        const e = await l(
-          `/app-api/audio/tts/voices${r.toString() ? `?${r}` : ""}`,
+        const n = new URLSearchParams();
+        t != null && t.locale && n.set("locale", t.locale);
+        const r = await a(
+          `/app-api/audio/tts/voices${n.toString() ? `?${n}` : ""}`,
           { method: "GET" }
-        ), n = await e.json().catch(() => []);
-        if (!e.ok)
+        ), e = await r.json().catch(() => []);
+        if (!r.ok)
           throw new Error(
-            (n == null ? void 0 : n.error) || `Request failed (${e.status})`
+            (e == null ? void 0 : e.error) || `Request failed (${r.status})`
           );
-        return Array.isArray(n) ? n : (n == null ? void 0 : n.voices) || [];
+        return Array.isArray(e) ? e : (e == null ? void 0 : e.voices) || [];
       }
     },
     web: {
       async scrapeUrl(t) {
-        var e;
-        const r = (e = t == null ? void 0 : t.url) == null ? void 0 : e.trim();
-        if (!r) throw new Error("web.scrapeUrl requires a url");
-        return S(
+        var r;
+        const n = (r = t == null ? void 0 : t.url) == null ? void 0 : r.trim();
+        if (!n) throw new Error("web.scrapeUrl requires a url");
+        return g(
           "/app-api/web/scrape-url",
           {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({
-              url: r,
+              url: n,
               maxChars: t.maxChars
             })
           }
@@ -376,17 +511,17 @@ function F(p, d) {
     },
     knowledge: {
       async search(t) {
-        var e;
-        const r = (e = t == null ? void 0 : t.query) == null ? void 0 : e.trim();
-        if (!r) throw new Error("knowledge.search requires a query");
-        return S(
+        var r;
+        const n = (r = t == null ? void 0 : t.query) == null ? void 0 : r.trim();
+        if (!n) throw new Error("knowledge.search requires a query");
+        return g(
           "/app-api/knowledge/search",
           {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({
               workspaceId: t.workspaceId,
-              query: r,
+              query: n,
               maxResults: t.maxResults,
               generateSearchQuery: t.generateSearchQuery,
               sourceId: t.sourceId,
@@ -397,18 +532,91 @@ function F(p, d) {
         );
       }
     },
+    translatorLiveShare: {
+      async create(t) {
+        return g("/app-api/translator/live-share", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ displayLanguage: t })
+        });
+      },
+      async update(t, n) {
+        await g(`/app-api/translator/live-share/${encodeURIComponent(t)}`, {
+          method: "PUT",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(n)
+        });
+      },
+      async revoke(t) {
+        await g(`/app-api/translator/live-share/${encodeURIComponent(t)}`, {
+          method: "DELETE"
+        });
+      }
+    },
+    guardrails: {
+      async check(t) {
+        return g("/app-api/guardrails/check", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ value: t })
+        });
+      }
+    },
     data(t = "private") {
-      return E(t, "");
+      return k(t, "");
+    },
+    files(t = "private") {
+      const n = (e = {}) => new URLSearchParams({ scope: t, ...e }).toString(), r = async (e) => {
+        const o = await e.json().catch(() => ({}));
+        return new Error((o == null ? void 0 : o.error) || `Request failed (${e.status})`);
+      };
+      return {
+        async upload(e, o = {}) {
+          const u = o.name || e.name;
+          if (!u) throw new Error("A file name is required.");
+          const d = o.contentType || e.type || "application/octet-stream", c = await a(`/app-api/files?${n({ name: u, contentType: d })}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/octet-stream" },
+            body: e,
+            signal: o.signal
+          });
+          if (!c.ok) throw await r(c);
+          return (await c.json()).file;
+        },
+        async list(e = {}) {
+          const o = await a(
+            `/app-api/files?${n(e.prefix ? { prefix: e.prefix } : {})}`,
+            { method: "GET" }
+          );
+          if (!o.ok) throw await r(o);
+          return (await o.json()).files;
+        },
+        async download(e, o = {}) {
+          const u = await a(`/app-api/files/${encodeURIComponent(e)}?${n()}`, {
+            method: "GET",
+            signal: o.signal
+          });
+          if (!u.ok) throw await r(u);
+          return u.blob();
+        },
+        async remove(e) {
+          const o = await a(`/app-api/files/${encodeURIComponent(e)}?${n()}`, {
+            method: "DELETE"
+          });
+          if (!o.ok) throw await r(o);
+        }
+      };
     }
   };
 }
 export {
-  _ as PromteAppProvider,
-  j as usePromte,
-  I as usePromteClient,
-  V as usePromteDarkMode,
-  W as usePromteModels,
-  G as usePromteSettings,
-  z as usePromteToken,
-  Q as usePromteUser
+  tt as PromteAppProvider,
+  et as PromteNativeProvider,
+  C as usePromte,
+  Y as usePromteClient,
+  ot as usePromteDarkMode,
+  at as usePromteModels,
+  rt as usePromteSettings,
+  nt as usePromteToken,
+  st as usePromteUser
 };

package/dist/index.umd.cjs

@@ -1 +1 @@
-(function(h,T){typeof exports=="object"&&typeof module<"u"?T(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],T):(h=typeof globalThis<"u"?globalThis:h||self,T(h.PromteAppLibrary={},h.jsxRuntime,h.react))})(this,function(h,T,i){"use strict";const R=i.createContext(null);function L({children:d,expectedParentOrigin:m,initTargetOrigin:S,retryInit:f={enabled:!0,intervalMs:500,maxAttempts:20}}){const[y,$]=i.useState(null),[v,j]=i.useState(null),[g,E]=i.useState(null),[k,t]=i.useState(null),[s,e]=i.useState(null),n=i.useMemo(()=>s?"booting":y?v?"ready":"waiting_for_token":"waiting_for_settings",[y,v,s]),r=n==="ready",c=i.useMemo(()=>S||m||"*",[S,m]),a=i.useCallback(()=>{var o;try{const w={type:"init"};(o=window.parent)==null||o.postMessage(w,c)}catch(w){e((w==null?void 0:w.message)||"Failed to post init")}},[c]);i.useEffect(()=>{a()},[a]),i.useEffect(()=>{if(!(f!=null&&f.enabled)||y)return;const o=f.intervalMs??500,w=f.maxAttempts??20;let u=0;const p=window.setInterval(()=>{if(y){window.clearInterval(p);return}if(u+=1,u>w){window.clearInterval(p);return}a()},o);return()=>window.clearInterval(p)},[f,y,a]),i.useEffect(()=>{const o=w=>{if(m&&w.origin!==m)return;const u=w.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;$(p),p!=null&&p.user&&t(p.user),e(null);return}if(u.type==="set-token"&&typeof u.value=="string"){j(u.value),e(null);return}if(u.type==="set-dark-mode"&&typeof u.value=="boolean"){E(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 l=i.useMemo(()=>N(()=>y,()=>v),[y,v]),b=i.useMemo(()=>({settings:y,token:v,isDarkMode:g,user:k,ready:r,state:n,error:s,client:l}),[y,v,g,k,r,n,s,l]);return T.jsx(R.Provider,{value:b,children:d})}function P(){const d=i.useContext(R);if(!d)throw new Error("usePromte must be used inside <PromteAppProvider>");return d}function B(){return P().settings}function D(){return P().token}function I(){return P().isDarkMode}function F(){return P().user}function x(){return P().client}function J(d={}){const{ready:m}=P(),S=x(),[f,y]=i.useState([]),[$,v]=i.useState(!1),[j,g]=i.useState(null),E=i.useMemo(()=>(Array.isArray(d.type)?d.type:d.type?[d.type]:[]).filter(Boolean).map(n=>String(n)).join(","),[d.type]),k=d.configuredOnly===!0,t=d.auto!==!1,s=i.useCallback(async()=>{if(!m)return[];v(!0),g(null);try{const e=E?E.split(",").filter(Boolean):void 0,n=await S.models({type:e,configuredOnly:k});return y(n),n}catch(e){const n=e instanceof Error?e.message:String(e);throw g(n),e}finally{v(!1)}},[S,k,m,E]);return i.useEffect(()=>{!t||!m||s().catch(()=>{})},[t,m,s]),{models:f,loading:$,error:j,reload:s}}function N(d,m){const S=t=>typeof t=="string"&&t.startsWith("gpt-5");async function f(t,s){const e=d(),n=m();if(!e)throw new Error("Promte settings not received yet");if(!n)throw new Error("Promte token not received yet");const r=e.backendUrl.replace(/\/+$/,""),c=String(t||"").replace(/^\/+/,""),a=`${r}/${c}`;return await fetch(a,{...s,headers:{...s.headers||{},Authorization:`Bearer ${n}`}})}async function y(t,s){const e=await f(`/app-api/data/${t}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s)}),n=await e.json().catch(()=>({}));if(!e.ok)throw new Error((n==null?void 0:n.error)||`Request failed (${e.status})`);return n==null?void 0:n.value}async function $(t){const s=new URLSearchParams;t.scope&&s.set("scope",t.scope),t.path&&s.set("path",t.path);const e=await f(`/app-api/data?${s.toString()}`,{method:"GET"}),n=await e.json().catch(()=>({}));if(!e.ok)throw new Error((n==null?void 0:n.error)||`Request failed (${e.status})`);return n==null?void 0:n.value}async function v(t){const s=new URLSearchParams,e=Array.isArray(t==null?void 0:t.type)?t==null?void 0:t.type:t!=null&&t.type?[t.type]:[];e.length>0&&s.set("type",e.join(",")),t!=null&&t.configuredOnly&&s.set("configuredOnly","true");const n=await f(`/app-api/models${s.toString()?`?${s.toString()}`:""}`,{method:"GET"}),r=await n.json().catch(()=>({}));if(!n.ok)throw new Error((r==null?void 0:r.error)||`Request failed (${n.status})`);return(Array.isArray(r==null?void 0:r.models)?r.models:[]).map(a=>{if(!a||typeof a!="object")return null;const l=typeof a.id=="string"?a.id.trim():"",b=typeof a.label=="string"?a.label.trim():l,o=a.type,w=a.configured===!0,u=typeof a.source=="string"&&a.source.trim()?a.source.trim():void 0;return!l||o!=="llm"&&o!=="embedding"&&o!=="image"&&o!=="stt"&&o!=="tts"?null:{id:l,label:b||l,type:o,configured:w,source:u}}).filter(a=>!!a)}async function j(t,s){const e=await f(t,s),r=(e.headers.get("content-type")||"").includes("application/json")?await e.json().catch(()=>({})):await e.text();if(!e.ok)throw new Error(typeof r=="string"?r||`Request failed (${e.status})`:(r==null?void 0:r.error)||(r==null?void 0:r.message)||`Request failed (${e.status})`);return r}const g=t=>t?t.split("/").map(s=>s.trim()).filter(Boolean).join("/"):"",E=(t,s)=>{const e=g(t),n=g(s);return e?n?`${e}/${n}`:e:n},k=(t,s)=>{const e={scope:t};return{async get(){const n=g(s);return $({...e,path:n||void 0})},async set(n){const r=g(s);return y("set",{...e,path:r||void 0,value:n})},async update(n){if(!n||typeof n!="object")throw new Error("update requires an object");const r={};for(const[c,a]of Object.entries(n)){const l=E(s,c);if(!l)throw new Error("update paths must be non-empty");r[l]=a}return y("update",{...e,updates:r})},async remove(){const n=g(s);return y("remove",{...e,path:n||void 0})},async push(n){const r=g(s);if(!r)throw new Error("push requires a path");return y("array-push",{...e,path:r,value:n})},ref(n){const r=E(s,n);if(!r)throw new Error("ref requires a path");return k(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:e,...n}=t,r=s??e,c={...n,stream:!1};r&&S(t.model)&&(c.reasoning_effort=r);const a=await f("/openai/chat/completions",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(c)}),b=(a.headers.get("content-type")||"").includes("application/json")?await a.json():await a.text();if(!a.ok)throw new Error(typeof b=="string"?b:((o=b==null?void 0:b.error)==null?void 0:o.message)||`Request failed (${a.status})`);return b},async chatText(t){var e,n,r;const s=await this.chatCompletions(t);return((r=(n=(e=s==null?void 0:s.choices)==null?void 0:e[0])==null?void 0:n.message)==null?void 0:r.content)??""},embeddings:{async create(t){var r;const s=(r=t==null?void 0:t.model)==null?void 0:r.trim();if(!s)throw new Error("embeddings.create requires a model");const e=t==null?void 0:t.input;if(!(typeof e=="string"?e.length>0:Array.isArray(e)&&e.length>0&&e.every(c=>typeof c=="string")))throw new Error("embeddings.create requires input as a string or string[]");return j("/openai/embeddings",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({...t,model:s,input:e})})}},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 e=await f("/app-api/audio/tts",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({text:s,voice:t.voice,lang:t.lang})});if(!e.ok){const c=await e.text();throw new Error(c||`Request failed (${e.status})`)}return{audio:await e.arrayBuffer(),contentType:e.headers.get("content-type")}},async stt(t){var u,p,C;if(!(t!=null&&t.file))throw new Error("audio.stt requires a file");const s=M=>{if(!M)return;const A=M.trim();if(!A)return;const U=A.toLowerCase(),O=U.split("-")[0];return O.length===2?O:U},e=typeof File<"u"&&t.file instanceof File,n=e&&t.file.name.split(".").pop()||"webm",r=t.ext||n,c=new FormData;e?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 l=await f(`/app-api/audio/stt?ext=${encodeURIComponent(r)}`,{method:"POST",body:c}),o=(l.headers.get("content-type")||"").includes("application/json")?await l.json():await l.text();if(!l.ok)throw new Error(typeof o=="string"?o:((u=o==null?void 0:o.error)==null?void 0:u.message)||`Request failed (${l.status})`);return{text:typeof o=="string"?o:(o==null?void 0:o.text)||(o==null?void 0:o.original)||((C=(p=o==null?void 0:o.results)==null?void 0:p[0])==null?void 0:C.text)||"",raw:o}},async voices(t){const s=new URLSearchParams;t!=null&&t.locale&&s.set("locale",t.locale);const e=await f(`/app-api/audio/tts/voices${s.toString()?`?${s}`:""}`,{method:"GET"}),n=await e.json().catch(()=>[]);if(!e.ok)throw new Error((n==null?void 0:n.error)||`Request failed (${e.status})`);return Array.isArray(n)?n:(n==null?void 0:n.voices)||[]}},web:{async scrapeUrl(t){var e;const s=(e=t==null?void 0:t.url)==null?void 0:e.trim();if(!s)throw new Error("web.scrapeUrl requires a url");return j("/app-api/web/scrape-url",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({url:s,maxChars:t.maxChars})})}},knowledge:{async search(t){var e;const s=(e=t==null?void 0:t.query)==null?void 0:e.trim();if(!s)throw new Error("knowledge.search requires a query");return j("/app-api/knowledge/search",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({workspaceId:t.workspaceId,query:s,maxResults:t.maxResults,generateSearchQuery:t.generateSearchQuery,sourceId:t.sourceId,includeSourceUrls:t.includeSourceUrls,queries:t.queries})})}},data(t="private"){return k(t,"")}}}h.PromteAppProvider=L,h.usePromte=P,h.usePromteClient=x,h.usePromteDarkMode=I,h.usePromteModels=J,h.usePromteSettings=B,h.usePromteToken=D,h.usePromteUser=F,Object.defineProperty(h,Symbol.toStringTag,{value:"Module"})});
+(function(E,R){typeof exports=="object"&&typeof module<"u"?R(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],R):(E=typeof globalThis<"u"?globalThis:E||self,R(E.PromteAppLibrary={},E.jsxRuntime,E.react))})(this,function(E,R,l){"use strict";const J="promte-fetch-request",G="promte-fetch-response",z=new Set([101,103,204,205,304]);function V(){return typeof crypto<"u"&&"randomUUID"in crypto?crypto.randomUUID():`${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`}function x(i){return i.reason??new DOMException("The operation was aborted.","AbortError")}function W(i,f){if(i==null)return null;if(typeof i=="string"||i instanceof Blob||i instanceof ArrayBuffer||ArrayBuffer.isView(i))return i;if(i instanceof URLSearchParams)return f.has("content-type")||f.set("content-type","application/x-www-form-urlencoded;charset=UTF-8"),i.toString();if(i instanceof FormData){const w=[];return i.forEach((m,a)=>w.push([a,m])),{form:w}}throw new TypeError("This request body cannot be sent through Promte.")}function H({target:i,origin:f},w,m){return new Promise((a,g)=>{const p=m.signal;if(p!=null&&p.aborted)return g(x(p));const $=V(),v=new Headers(m.headers);v.delete("authorization");let T;try{T=W(m.body,v)}catch(n){return g(n)}const b=()=>{window.removeEventListener("message",e),p==null||p.removeEventListener("abort",j)},j=()=>{b(),g(x(p))},e=n=>{if(n.source!==i||n.origin!==f)return;const t=n.data;if(!t||t.type!==G||t.id!==$)return;if(b(),typeof t.error=="string")return g(new TypeError(t.error));const o=Number(t.status);if(!Number.isInteger(o)||o<200||o>599)return g(new TypeError("Promte returned an invalid response."));try{a(new Response(z.has(o)?null:t.body??null,{status:o,statusText:typeof t.statusText=="string"?t.statusText:"",headers:Array.isArray(t.headers)?t.headers:[]}))}catch{g(new TypeError("Promte returned an invalid response."))}};window.addEventListener("message",e),p==null||p.addEventListener("abort",j,{once:!0});const r=[];v.forEach((n,t)=>r.push([t,n]));try{i.postMessage({type:J,id:$,path:w,method:(m.method||"GET").toUpperCase(),headers:r,body:T},f)}catch(n){b(),g(n)}})}const U=l.createContext(null);function Q({children:i,expectedParentOrigin:f,initTargetOrigin:w,retryInit:m={enabled:!0,intervalMs:500,maxAttempts:20}}){const[a,g]=l.useState(null),[p,$]=l.useState(null),[v,T]=l.useState(null),[b,j]=l.useState(null),[e,r]=l.useState(null),[n,t]=l.useState(null),o=l.useMemo(()=>e?"booting":a?!p&&!a.fetchProxy?"waiting_for_token":"ready":"waiting_for_settings",[a,p,e]),u=o==="ready",h=l.useMemo(()=>w||f||"*",[w,f]),c=l.useCallback(()=>{var P;try{const s={type:"init",fetchProxy:!0};(P=window.parent)==null||P.postMessage(s,h)}catch(s){r((s==null?void 0:s.message)||"Failed to post init")}},[h]);l.useEffect(()=>{c()},[c]),l.useEffect(()=>{if(!(m!=null&&m.enabled)||a)return;const P=m.intervalMs??500,s=m.maxAttempts??20;let y=0;const S=window.setInterval(()=>{if(a){window.clearInterval(S);return}if(y+=1,y>s){window.clearInterval(S);return}c()},P);return()=>window.clearInterval(S)},[m,a,c]),l.useEffect(()=>{const P=s=>{if(f&&s.origin!==f)return;const y=s.data;if(!(!y||typeof y!="object")){if(y.type==="set-settings"){const S=y.value;if(!(S!=null&&S.backendUrl)||S.parentOrigin&&f&&S.parentOrigin!==f)return;g(S),t(s.source===window.parent?s.origin:null),S!=null&&S.user&&j(S.user),r(null);return}if(y.type==="set-token"&&typeof y.value=="string"){$(y.value),r(null);return}if(y.type==="set-dark-mode"&&typeof y.value=="boolean"){T(y.value);return}if(y.type==="set-user"&&typeof y.value=="object"){j(y.value);return}}};return window.addEventListener("message",P),()=>window.removeEventListener("message",P)},[f]);const d=l.useMemo(()=>L(()=>a,()=>p,()=>a!=null&&a.fetchProxy&&n&&window.parent!==window?{target:window.parent,origin:n}:null),[a,p,n]),k=l.useMemo(()=>({settings:a,token:p,isDarkMode:v,user:b,ready:u,state:o,error:e,client:d}),[a,p,v,b,u,o,e,d]);return R.jsx(U.Provider,{value:k,children:i})}function K({children:i,settings:f,token:w,isDarkMode:m,user:a}){const g=l.useMemo(()=>L(()=>f,()=>w),[f,w]),p=!!w,$=l.useMemo(()=>({settings:f,token:w,isDarkMode:m,user:a,ready:p,state:p?"ready":"waiting_for_token",error:null,client:g}),[g,m,p,f,w,a]);return R.jsx(U.Provider,{value:$,children:i})}function C(){const i=l.useContext(U);if(!i)throw new Error("usePromte must be used inside <PromteAppProvider> or <PromteNativeProvider>");return i}function X(){return C().settings}function Y(){return C().token}function Z(){return C().isDarkMode}function q(){return C().user}function O(){return C().client}function ee(i={}){const{ready:f}=C(),w=O(),[m,a]=l.useState([]),[g,p]=l.useState(!1),[$,v]=l.useState(null),T=l.useMemo(()=>(Array.isArray(i.type)?i.type:i.type?[i.type]:[]).filter(Boolean).map(n=>String(n)).join(","),[i.type]),b=i.configuredOnly===!0,j=i.auto!==!1,e=l.useCallback(async()=>{if(!f)return[];p(!0),v(null);try{const r=T?T.split(",").filter(Boolean):void 0,n=await w.models({type:r,configuredOnly:b});return a(n),n}catch(r){const n=r instanceof Error?r.message:String(r);throw v(n),r}finally{p(!1)}},[w,b,f,T]);return l.useEffect(()=>{!j||!f||e().catch(()=>{})},[j,f,e]),{models:m,loading:g,error:$,reload:e}}function L(i,f,w=()=>null){const m=e=>typeof e=="string"&&(e.startsWith("gpt-5")||e.startsWith("gpt-6"));async function a(e,r){const n=i(),t=f();if(!n)throw new Error("Promte settings not received yet");const o=n.backendUrl.replace(/\/+$/,""),u=String(e||"").replace(/^\/+/,""),h=`${o}/${u}`,c=w();if(!c&&!t)throw new Error("Promte token not received yet");const d=c?await H(c,u,r):await fetch(h,{...r,headers:{...r.headers||{},Authorization:`Bearer ${t}`}});return d.headers.get("X-Promte-Governance-Warning")&&(typeof window<"u"&&window.dispatchEvent(new CustomEvent("promte:governance-warning",{detail:{endpoint:e}})),console.warn("Promte governance: this request triggered a warning policy.")),d}async function g(e,r){const n=await a(`/app-api/data/${e}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(r)}),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 p(e){const r=new URLSearchParams;e.scope&&r.set("scope",e.scope),e.path&&r.set("path",e.path);const n=await a(`/app-api/data?${r.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}async function $(e){const r=new URLSearchParams,n=e==null?void 0:e.type,t=Array.isArray(n)?n:n?[n]:[];t.length>0&&r.set("type",t.join(",")),e!=null&&e.configuredOnly&&r.set("configuredOnly","true");const o=await a(`/app-api/models${r.toString()?`?${r.toString()}`:""}`,{method:"GET"}),u=await o.json().catch(()=>({}));if(!o.ok)throw new Error((u==null?void 0:u.error)||`Request failed (${o.status})`);return(Array.isArray(u==null?void 0:u.models)?u.models:[]).map(c=>{if(!c||typeof c!="object")return null;const d=typeof c.id=="string"?c.id.trim():"",k=typeof c.label=="string"?c.label.trim():d,P=c.type,s=c.configured===!0,y=typeof c.source=="string"&&c.source.trim()?c.source.trim():void 0;return!d||P!=="llm"&&P!=="embedding"&&P!=="image"&&P!=="stt"&&P!=="tts"?null:{id:d,label:k||d,type:P,configured:s,source:y}}).filter(c=>!!c)}async function v(e,r){const n=await a(e,r),o=(n.headers.get("content-type")||"").includes("application/json")?await n.json().catch(()=>({})):await n.text();if(!n.ok)throw new Error(typeof o=="string"?o||`Request failed (${n.status})`:(o==null?void 0:o.error)||(o==null?void 0:o.message)||`Request failed (${n.status})`);return o}const T=e=>e?e.split("/").map(r=>r.trim()).filter(Boolean).join("/"):"",b=(e,r)=>{const n=T(e),t=T(r);return n?t?`${n}/${t}`:n:t},j=(e,r)=>{const n={scope:e};return{async get(){const t=T(r);return p({...n,path:t||void 0})},async set(t){const o=T(r);return g("set",{...n,path:o||void 0,value:t})},async update(t){if(!t||typeof t!="object")throw new Error("update requires an object");const o={};for(const[u,h]of Object.entries(t)){const c=b(r,u);if(!c)throw new Error("update paths must be non-empty");o[c]=h}return g("update",{...n,updates:o})},async remove(){const t=T(r);return g("remove",{...n,path:t||void 0})},async push(t){const o=T(r);if(!o)throw new Error("push requires a path");return g("array-push",{...n,path:o,value:t})},ref(t){const o=b(r,t);if(!o)throw new Error("ref requires a path");return j(e,o)}}};return{functions:{async invoke(e,r){if(!/^[a-z][a-z0-9-]{0,63}$/.test(e))throw new Error("Choose a valid function name or configured binding alias.");const n=await a("/app-api/functions/invoke",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({name:e,input:r})}),t=await n.json().catch(()=>({}));if(!n.ok)throw new Error((t==null?void 0:t.error)||`Function call failed (${n.status})`);return t.output}},isReady(){return!!i()&&(!!f()||!!w())},getBackendUrl(){var e;return((e=i())==null?void 0:e.backendUrl)??null},async models(e){return $(e)},async chatCompletions(e){var k;const{reasoningEffort:r,reasoning_effort:n,...t}=e,o=r??n,u={...t,stream:!1};o&&m(e.model)&&(u.reasoning_effort=o);const h=await a("/openai/chat/completions",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(u)}),d=(h.headers.get("content-type")||"").includes("application/json")?await h.json():await h.text();if(!h.ok)throw new Error(typeof d=="string"?d:(typeof(d==null?void 0:d.error)=="string"?d.error:(k=d==null?void 0:d.error)==null?void 0:k.message)||`Request failed (${h.status})`);return d},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)??""},embeddings:{async create(e){var o;const r=(o=e==null?void 0:e.model)==null?void 0:o.trim();if(!r)throw new Error("embeddings.create requires a model");const n=e==null?void 0:e.input;if(!(typeof n=="string"?n.length>0:Array.isArray(n)&&n.length>0&&n.every(u=>typeof u=="string")))throw new Error("embeddings.create requires input as a string or string[]");return v("/openai/embeddings",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({...e,model:r,input:n})})}},audio:{async speechToken(){const e=await a("/app-api/audio/speech-token",{method:"POST"});if(!e.ok)throw new Error("Live talegenkendelse er ikke tilgængelig. Kontakt administratoren.");return e.json()},async voiceLiveSession(){const e=await a("/app-api/audio/voice-live-session",{method:"POST"});if(!e.ok){const r=await e.text();throw new Error(r||"Voice Live er ikke tilgængelig.")}return e.json()},async tts(e){var o;const r=(o=e==null?void 0:e.text)==null?void 0:o.trim();if(!r)throw new Error("audio.tts requires non-empty text");const n=await a("/app-api/audio/tts",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({text:r,voice:e.voice,lang:e.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(e){var A,M,N,D;if(!(e!=null&&e.file))throw new Error("audio.stt requires a file");const r=(A=e.language)==null?void 0:A.trim(),n=B=>{if(!B)return;const F=B.trim();if(!F)return;const I=F.toLowerCase(),_=I.split("-")[0];return _.length===2?_:I},t=typeof File<"u"&&e.file instanceof File,o=t&&e.file.name.split(".").pop()||"webm",u=e.ext||o,h=new FormData;t?h.set("file",e.file):h.set("file",e.file,`audio.${u}`);const c=n(r);c&&h.set("language",c),e.prompt&&h.set("prompt",e.prompt),e.responseFormat&&h.set("response_format",e.responseFormat);const d=new URLSearchParams({ext:u});r&&d.set("locale",r);const k=await a(`/app-api/audio/stt?${d.toString()}`,{method:"POST",body:h}),s=(k.headers.get("content-type")||"").includes("application/json")?await k.json():await k.text();if(!k.ok)throw new Error(typeof s=="string"?s:(typeof(s==null?void 0:s.error)=="string"?s.error:(M=s==null?void 0:s.error)==null?void 0:M.message)||`Request failed (${k.status})`);const y=typeof s=="string"?s:(s==null?void 0:s.text)||(s==null?void 0:s.original)||((D=(N=s==null?void 0:s.results)==null?void 0:N[0])==null?void 0:D.text)||"",S=typeof s=="object"&&typeof(s==null?void 0:s.language)=="string"?s.language:void 0;return{text:y,language:S,raw:s}},async voices(e){const r=new URLSearchParams;e!=null&&e.locale&&r.set("locale",e.locale);const n=await a(`/app-api/audio/tts/voices${r.toString()?`?${r}`:""}`,{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)||[]}},web:{async scrapeUrl(e){var n;const r=(n=e==null?void 0:e.url)==null?void 0:n.trim();if(!r)throw new Error("web.scrapeUrl requires a url");return v("/app-api/web/scrape-url",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({url:r,maxChars:e.maxChars})})}},knowledge:{async search(e){var n;const r=(n=e==null?void 0:e.query)==null?void 0:n.trim();if(!r)throw new Error("knowledge.search requires a query");return v("/app-api/knowledge/search",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({workspaceId:e.workspaceId,query:r,maxResults:e.maxResults,generateSearchQuery:e.generateSearchQuery,sourceId:e.sourceId,includeSourceUrls:e.includeSourceUrls,queries:e.queries})})}},translatorLiveShare:{async create(e){return v("/app-api/translator/live-share",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({displayLanguage:e})})},async update(e,r){await v(`/app-api/translator/live-share/${encodeURIComponent(e)}`,{method:"PUT",headers:{"Content-Type":"application/json"},body:JSON.stringify(r)})},async revoke(e){await v(`/app-api/translator/live-share/${encodeURIComponent(e)}`,{method:"DELETE"})}},guardrails:{async check(e){return v("/app-api/guardrails/check",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({value:e})})}},data(e="private"){return j(e,"")},files(e="private"){const r=(t={})=>new URLSearchParams({scope:e,...t}).toString(),n=async t=>{const o=await t.json().catch(()=>({}));return new Error((o==null?void 0:o.error)||`Request failed (${t.status})`)};return{async upload(t,o={}){const u=o.name||t.name;if(!u)throw new Error("A file name is required.");const h=o.contentType||t.type||"application/octet-stream",c=await a(`/app-api/files?${r({name:u,contentType:h})}`,{method:"POST",headers:{"Content-Type":"application/octet-stream"},body:t,signal:o.signal});if(!c.ok)throw await n(c);return(await c.json()).file},async list(t={}){const o=await a(`/app-api/files?${r(t.prefix?{prefix:t.prefix}:{})}`,{method:"GET"});if(!o.ok)throw await n(o);return(await o.json()).files},async download(t,o={}){const u=await a(`/app-api/files/${encodeURIComponent(t)}?${r()}`,{method:"GET",signal:o.signal});if(!u.ok)throw await n(u);return u.blob()},async remove(t){const o=await a(`/app-api/files/${encodeURIComponent(t)}?${r()}`,{method:"DELETE"});if(!o.ok)throw await n(o)}}}}}E.PromteAppProvider=Q,E.PromteNativeProvider=K,E.usePromte=C,E.usePromteClient=O,E.usePromteDarkMode=Z,E.usePromteModels=ee,E.usePromteSettings=X,E.usePromteToken=Y,E.usePromteUser=q,Object.defineProperty(E,Symbol.toStringTag,{value:"Module"})});

package/package.json

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