@promte/app-library 0.1.7 → 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,6 +14,38 @@ 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;
@@ -162,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>;
@@ -199,7 +234,11 @@ export declare type PromteClient = {
         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 = {
@@ -213,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 = {
@@ -250,6 +302,8 @@ export declare type PromteSettings = {
     backendUrl: string;
     parentOrigin?: string;
     user?: PromteUser;
+    /** Set by Promte pages that can send backend requests for the app. */
+    fetchProxy?: boolean;
 };
 
 export declare type PromteUser = {
@@ -320,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,418 +1,508 @@
-import { jsx as B } from "react/jsx-runtime";
-import { createContext as J, useState as T, useMemo as P, useCallback as _, useEffect as $, useContext as D } from "react";
-const x = J(null);
-function W({
-  children: f,
-  expectedParentOrigin: l,
-  initTargetOrigin: g,
-  retryInit: c = { 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 [p, k] = T(null), [y, v] = T(null), [b, E] = T(null), [S, t] = T(null), [r, e] = T(null), n = P(() => r ? "booting" : p ? y ? "ready" : "waiting_for_token" : "waiting_for_settings", [p, y, r]), o = n === "ready", a = P(() => g || l || "*", [g, l]), u = _(() => {
-    var d;
+  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 h = { type: "init" };
-      (d = window.parent) == null || d.postMessage(h, a);
-    } catch (h) {
-      e((h == null ? void 0 : h.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");
     }
-  }, [a]);
-  $(() => {
-    u();
-  }, [u]), $(() => {
-    if (!(c != null && c.enabled) || p) return;
-    const d = c.intervalMs ?? 500, h = c.maxAttempts ?? 20;
-    let s = 0;
-    const m = window.setInterval(() => {
-      if (p) {
-        window.clearInterval(m);
+  }, [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 (s += 1, s > h) {
-        window.clearInterval(m);
+      if (m += 1, m > s) {
+        window.clearInterval(E);
         return;
       }
-      u();
-    }, d);
-    return () => window.clearInterval(m);
-  }, [c, p, u]), $(() => {
-    const d = (h) => {
-      if (l && h.origin !== l) return;
-      const s = h.data;
-      if (!(!s || typeof s != "object")) {
-        if (s.type === "set-settings") {
-          const m = s.value;
-          if (!(m != null && m.backendUrl) || m.parentOrigin && l && m.parentOrigin !== l)
+      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;
-          k(m), m != null && m.user && t(m.user), e(null);
+          y(E), e(s.source === window.parent ? s.origin : null), E != null && E.user && k(E.user), n(null);
           return;
         }
-        if (s.type === "set-token" && typeof s.value == "string") {
-          v(s.value), e(null);
+        if (m.type === "set-token" && typeof m.value == "string") {
+          P(m.value), n(null);
           return;
         }
-        if (s.type === "set-dark-mode" && typeof s.value == "boolean") {
-          E(s.value);
+        if (m.type === "set-dark-mode" && typeof m.value == "boolean") {
+          v(m.value);
           return;
         }
-        if (s.type === "set-user" && typeof s.value == "object") {
-          t(s.value);
+        if (m.type === "set-user" && typeof m.value == "object") {
+          k(m.value);
           return;
         }
       }
     };
-    return window.addEventListener("message", d), () => window.removeEventListener("message", d);
-  }, [l]);
-  const i = P(() => F(
-    () => p,
-    () => y
-  ), [p, y]), w = P(
+    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: p,
-      token: y,
-      isDarkMode: b,
+      settings: a,
+      token: l,
+      isDarkMode: g,
       user: S,
-      ready: o,
-      state: n,
-      error: r,
-      client: i
+      ready: u,
+      state: o,
+      error: t,
+      client: f
     }),
-    [p, y, b, S, o, n, r, i]
+    [a, l, g, S, u, o, t, f]
   );
-  return /* @__PURE__ */ B(x.Provider, { value: w, children: f });
+  return /* @__PURE__ */ I(j.Provider, { value: b, children: i });
 }
-function K({
-  children: f,
-  settings: l,
-  token: g,
-  isDarkMode: c,
-  user: p
+function et({
+  children: i,
+  settings: p,
+  token: w,
+  isDarkMode: h,
+  user: a
 }) {
-  const k = P(
-    () => F(() => l, () => g),
-    [l, g]
-  ), y = !!g, v = P(
+  const y = x(
+    () => J(() => p, () => w),
+    [p, w]
+  ), l = !!w, P = x(
     () => ({
-      settings: l,
-      token: g,
-      isDarkMode: c,
-      user: p,
-      ready: y,
-      state: y ? "ready" : "waiting_for_token",
+      settings: p,
+      token: w,
+      isDarkMode: h,
+      user: a,
+      ready: l,
+      state: l ? "ready" : "waiting_for_token",
       error: null,
-      client: k
+      client: y
     }),
-    [k, c, y, l, g, p]
+    [y, h, l, p, w, a]
   );
-  return /* @__PURE__ */ B(x.Provider, { value: v, children: f });
+  return /* @__PURE__ */ I(j.Provider, { value: P, children: i });
 }
-function j() {
-  const f = D(x);
-  if (!f)
+function C() {
+  const i = z(j);
+  if (!i)
     throw new Error(
       "usePromte must be used inside <PromteAppProvider> or <PromteNativeProvider>"
     );
-  return f;
+  return i;
 }
-function Q() {
-  return j().settings;
+function rt() {
+  return C().settings;
 }
-function H() {
-  return j().token;
+function nt() {
+  return C().token;
 }
-function X() {
-  return j().isDarkMode;
+function ot() {
+  return C().isDarkMode;
 }
-function Y() {
-  return j().user;
+function st() {
+  return C().user;
 }
-function G() {
-  return j().client;
+function Y() {
+  return C().client;
 }
-function Z(f = {}) {
-  const { ready: l } = j(), g = G(), [c, p] = T([]), [k, y] = T(!1), [v, b] = T(null), E = P(() => (Array.isArray(f.type) ? f.type : f.type ? [f.type] : []).filter(Boolean).map((n) => String(n)).join(","), [f.type]), S = f.configuredOnly === !0, t = f.auto !== !1, r = _(async () => {
-    if (!l) return [];
-    y(!0), b(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 = E ? E.split(",").filter(Boolean) : void 0, n = await g.models({ type: e, configuredOnly: S });
-      return p(n), n;
-    } catch (e) {
-      const n = e instanceof Error ? e.message : String(e);
-      throw b(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 {
-      y(!1);
+      l(!1);
     }
-  }, [g, S, l, E]);
-  return $(() => {
-    !t || !l || r().catch(() => {
+  }, [w, S, p, v]);
+  return R(() => {
+    !k || !p || t().catch(() => {
     });
-  }, [t, l, r]), { models: c, loading: k, error: v, reload: r };
+  }, [k, p, t]), { models: h, loading: y, error: P, reload: t };
 }
-function F(f, l) {
-  const g = (t) => typeof t == "string" && (t.startsWith("gpt-5") || t.startsWith("gpt-6"));
-  async function c(t, r) {
-    const e = f(), n = l();
-    if (!e) throw new Error("Promte settings not received yet");
-    if (!n) throw new Error("Promte token not received yet");
-    const o = e.backendUrl.replace(/\/+$/, ""), a = String(t || "").replace(/^\/+/, ""), u = `${o}/${a}`;
-    return await fetch(u, {
-      ...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 p(t, r) {
-    const e = await c(`/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 k(t) {
-    const r = new URLSearchParams();
-    t.scope && r.set("scope", t.scope), t.path && r.set("path", t.path);
-    const e = await c(`/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 y(t) {
-    const r = new URLSearchParams(), e = t == null ? void 0 : t.type, n = Array.isArray(e) ? e : e ? [e] : [];
-    n.length > 0 && r.set("type", n.join(",")), t != null && t.configuredOnly && r.set("configuredOnly", "true");
-    const o = await c(
-      `/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" }
-    ), a = await o.json().catch(() => ({}));
+    ), u = await o.json().catch(() => ({}));
     if (!o.ok)
-      throw new Error((a == null ? void 0 : a.error) || `Request failed (${o.status})`);
-    return (Array.isArray(a == null ? void 0 : a.models) ? a.models : []).map((i) => {
-      if (!i || typeof i != "object") return null;
-      const w = typeof i.id == "string" ? i.id.trim() : "", d = typeof i.label == "string" ? i.label.trim() : w, h = i.type, s = i.configured === !0, m = typeof i.source == "string" && i.source.trim() ? i.source.trim() : void 0;
-      return !w || h !== "llm" && h !== "embedding" && h !== "image" && h !== "stt" && h !== "tts" ? null : {
-        id: w,
-        label: d || w,
-        type: h,
+      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(
-      (i) => !!i
+      (c) => !!c
     );
   }
-  async function v(t, r) {
-    const e = await c(t, r), o = (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 o == "string" ? o || `Request failed (${e.status})` : (o == null ? void 0 : o.error) || (o == null ? void 0 : o.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 o;
   }
-  const b = (t) => t ? t.split("/").map((r) => r.trim()).filter(Boolean).join("/") : "", E = (t, r) => {
-    const e = b(t), n = b(r);
-    return e ? n ? `${e}/${n}` : e : n;
-  }, S = (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 = b(r);
-        return k({ ...e, path: n || void 0 });
+        const e = v(n);
+        return l({ ...r, path: e || void 0 });
       },
-      async set(n) {
-        const o = b(r);
-        return p("set", {
-          ...e,
+      async set(e) {
+        const o = v(n);
+        return y("set", {
+          ...r,
           path: o || void 0,
-          value: n
+          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 o = {};
-        for (const [a, u] of Object.entries(n)) {
-          const i = E(r, a);
-          if (!i)
+        for (const [u, d] of Object.entries(e)) {
+          const c = S(n, u);
+          if (!c)
             throw new Error("update paths must be non-empty");
-          o[i] = u;
+          o[c] = d;
         }
-        return p("update", { ...e, updates: o });
+        return y("update", { ...r, updates: o });
       },
       async remove() {
-        const n = b(r);
-        return p("remove", { ...e, path: n || void 0 });
+        const e = v(n);
+        return y("remove", { ...r, path: e || void 0 });
       },
-      async push(n) {
-        const o = b(r);
+      async push(e) {
+        const o = v(n);
         if (!o) throw new Error("push requires a path");
-        return p("array-push", { ...e, path: o, value: n });
+        return y("array-push", { ...r, path: o, value: e });
       },
-      ref(n) {
-        const o = E(r, n);
+      ref(e) {
+        const o = S(n, e);
         if (!o) throw new Error("ref requires a path");
-        return S(t, o);
+        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 !!f() && !!l();
+      return !!i() && (!!p() || !!w());
     },
     getBackendUrl() {
       var t;
-      return ((t = f()) == null ? void 0 : t.backendUrl) ?? null;
+      return ((t = i()) == null ? void 0 : t.backendUrl) ?? null;
     },
     async models(t) {
-      return y(t);
+      return P(t);
     },
     async chatCompletions(t) {
-      var d;
+      var b;
       const {
-        reasoningEffort: r,
-        reasoning_effort: e,
-        ...n
-      } = t, o = r ?? e, a = {
-        ...n,
+        reasoningEffort: n,
+        reasoning_effort: r,
+        ...e
+      } = t, o = n ?? r, u = {
+        ...e,
         stream: !1
       };
-      o && g(t.model) && (a.reasoning_effort = o);
-      const u = await c("/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(a)
-      }), w = (u.headers.get("content-type") || "").includes("application/json") ? await u.json() : await u.text();
-      if (!u.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 w == "string" ? w : ((d = w == null ? void 0 : w.error) == null ? void 0 : d.message) || `Request failed (${u.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 w;
+      return f;
     },
     async chatText(t) {
-      var e, n, o;
-      const r = await this.chatCompletions(t);
-      return ((o = (n = (e = r == null ? void 0 : r.choices) == null ? void 0 : e[0]) == null ? void 0 : n.message) == null ? void 0 : o.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 o;
-        const r = (o = t == null ? void 0 : t.model) == null ? void 0 : o.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((a) => typeof a == "string")))
+        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 v("/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 c("/app-api/audio/speech-token", { method: "POST" });
+        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 c("/app-api/audio/voice-live-session", {
+        const t = await a("/app-api/audio/voice-live-session", {
           method: "POST"
         });
         if (!t.ok) {
-          const r = await t.text();
-          throw new Error(r || "Voice Live er ikke tilgængelig.");
+          const n = await t.text();
+          throw new Error(n || "Voice Live er ikke tilgængelig.");
         }
         return t.json();
       },
       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 e = await c("/app-api/audio/tts", {
+        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 a = await e.text();
-          throw new Error(a || `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 R, C, U, O;
+        var U, O, L, A;
         if (!(t != null && t.file)) throw new Error("audio.stt requires a file");
-        const r = (R = t.language) == null ? void 0 : R.trim(), e = (A) => {
-          if (!A) return;
-          const L = A.trim();
-          if (!L) return;
-          const M = L.toLowerCase(), N = M.split("-")[0];
-          return N.length === 2 ? N : M;
-        }, n = typeof File < "u" && t.file instanceof File, o = n && t.file.name.split(".").pop() || "webm", a = t.ext || o, u = new FormData();
-        n ? u.set("file", t.file) : u.set("file", t.file, `audio.${a}`);
-        const i = e(r);
-        i && u.set("language", i), t.prompt && u.set("prompt", t.prompt), t.responseFormat && u.set("response_format", t.responseFormat);
-        const w = new URLSearchParams({ ext: a });
-        r && w.set("locale", r);
-        const d = await c(
-          `/app-api/audio/stt?${w.toString()}`,
+        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: u
+            body: d
           }
-        ), s = (d.headers.get("content-type") || "").includes("application/json") ? await d.json() : await d.text();
-        if (!d.ok)
+        ), s = (b.headers.get("content-type") || "").includes("application/json") ? await b.json() : await b.text();
+        if (!b.ok)
           throw new Error(
-            typeof s == "string" ? s : ((C = s == null ? void 0 : s.error) == null ? void 0 : C.message) || `Request failed (${d.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})`
           );
-        const m = typeof s == "string" ? s : (s == null ? void 0 : s.text) || (s == null ? void 0 : s.original) || ((O = (U = s == null ? void 0 : s.results) == null ? void 0 : U[0]) == null ? void 0 : O.text) || "", I = typeof s == "object" && typeof (s == null ? void 0 : s.language) == "string" ? s.language : void 0;
-        return { text: m, language: I, raw: s };
+        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 c(
-          `/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 v(
+        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
             })
           }
@@ -421,17 +511,17 @@ function F(f, l) {
     },
     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 v(
+        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,
@@ -444,38 +534,89 @@ function F(f, l) {
     },
     translatorLiveShare: {
       async create(t) {
-        return v("/app-api/translator/live-share", {
+        return g("/app-api/translator/live-share", {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({ displayLanguage: t })
         });
       },
-      async update(t, r) {
-        await v(`/app-api/translator/live-share/${encodeURIComponent(t)}`, {
+      async update(t, n) {
+        await g(`/app-api/translator/live-share/${encodeURIComponent(t)}`, {
           method: "PUT",
           headers: { "Content-Type": "application/json" },
-          body: JSON.stringify(r)
+          body: JSON.stringify(n)
         });
       },
       async revoke(t) {
-        await v(`/app-api/translator/live-share/${encodeURIComponent(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 S(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 {
-  W as PromteAppProvider,
-  K as PromteNativeProvider,
-  j as usePromte,
-  G as usePromteClient,
-  X as usePromteDarkMode,
-  Z as usePromteModels,
-  Q as usePromteSettings,
-  H as usePromteToken,
-  Y 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(w,$){typeof exports=="object"&&typeof module<"u"?$(exports,require("react/jsx-runtime"),require("react")):typeof define=="function"&&define.amd?define(["exports","react/jsx-runtime","react"],$):(w=typeof globalThis<"u"?globalThis:w||self,$(w.PromteAppLibrary={},w.jsxRuntime,w.react))})(this,function(w,$,u){"use strict";const C=u.createContext(null);function D({children:d,expectedParentOrigin:f,initTargetOrigin:S,retryInit:c={enabled:!0,intervalMs:500,maxAttempts:20}}){const[p,k]=u.useState(null),[v,P]=u.useState(null),[b,E]=u.useState(null),[T,e]=u.useState(null),[r,t]=u.useState(null),n=u.useMemo(()=>r?"booting":p?v?"ready":"waiting_for_token":"waiting_for_settings",[p,v,r]),o=n==="ready",a=u.useMemo(()=>S||f||"*",[S,f]),l=u.useCallback(()=>{var m;try{const h={type:"init"};(m=window.parent)==null||m.postMessage(h,a)}catch(h){t((h==null?void 0:h.message)||"Failed to post init")}},[a]);u.useEffect(()=>{l()},[l]),u.useEffect(()=>{if(!(c!=null&&c.enabled)||p)return;const m=c.intervalMs??500,h=c.maxAttempts??20;let s=0;const y=window.setInterval(()=>{if(p){window.clearInterval(y);return}if(s+=1,s>h){window.clearInterval(y);return}l()},m);return()=>window.clearInterval(y)},[c,p,l]),u.useEffect(()=>{const m=h=>{if(f&&h.origin!==f)return;const s=h.data;if(!(!s||typeof s!="object")){if(s.type==="set-settings"){const y=s.value;if(!(y!=null&&y.backendUrl)||y.parentOrigin&&f&&y.parentOrigin!==f)return;k(y),y!=null&&y.user&&e(y.user),t(null);return}if(s.type==="set-token"&&typeof s.value=="string"){P(s.value),t(null);return}if(s.type==="set-dark-mode"&&typeof s.value=="boolean"){E(s.value);return}if(s.type==="set-user"&&typeof s.value=="object"){e(s.value);return}}};return window.addEventListener("message",m),()=>window.removeEventListener("message",m)},[f]);const i=u.useMemo(()=>M(()=>p,()=>v),[p,v]),g=u.useMemo(()=>({settings:p,token:v,isDarkMode:b,user:T,ready:o,state:n,error:r,client:i}),[p,v,b,T,o,n,r,i]);return $.jsx(C.Provider,{value:g,children:d})}function F({children:d,settings:f,token:S,isDarkMode:c,user:p}){const k=u.useMemo(()=>M(()=>f,()=>S),[f,S]),v=!!S,P=u.useMemo(()=>({settings:f,token:S,isDarkMode:c,user:p,ready:v,state:v?"ready":"waiting_for_token",error:null,client:k}),[k,c,v,f,S,p]);return $.jsx(C.Provider,{value:P,children:d})}function j(){const d=u.useContext(C);if(!d)throw new Error("usePromte must be used inside <PromteAppProvider> or <PromteNativeProvider>");return d}function I(){return j().settings}function J(){return j().token}function G(){return j().isDarkMode}function V(){return j().user}function R(){return j().client}function z(d={}){const{ready:f}=j(),S=R(),[c,p]=u.useState([]),[k,v]=u.useState(!1),[P,b]=u.useState(null),E=u.useMemo(()=>(Array.isArray(d.type)?d.type:d.type?[d.type]:[]).filter(Boolean).map(n=>String(n)).join(","),[d.type]),T=d.configuredOnly===!0,e=d.auto!==!1,r=u.useCallback(async()=>{if(!f)return[];v(!0),b(null);try{const t=E?E.split(",").filter(Boolean):void 0,n=await S.models({type:t,configuredOnly:T});return p(n),n}catch(t){const n=t instanceof Error?t.message:String(t);throw b(n),t}finally{v(!1)}},[S,T,f,E]);return u.useEffect(()=>{!e||!f||r().catch(()=>{})},[e,f,r]),{models:c,loading:k,error:P,reload:r}}function M(d,f){const S=e=>typeof e=="string"&&(e.startsWith("gpt-5")||e.startsWith("gpt-6"));async function c(e,r){const t=d(),n=f();if(!t)throw new Error("Promte settings not received yet");if(!n)throw new Error("Promte token not received yet");const o=t.backendUrl.replace(/\/+$/,""),a=String(e||"").replace(/^\/+/,""),l=`${o}/${a}`;return await fetch(l,{...r,headers:{...r.headers||{},Authorization:`Bearer ${n}`}})}async function p(e,r){const t=await c(`/app-api/data/${e}`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(r)}),n=await t.json().catch(()=>({}));if(!t.ok)throw new Error((n==null?void 0:n.error)||`Request failed (${t.status})`);return n==null?void 0:n.value}async function k(e){const r=new URLSearchParams;e.scope&&r.set("scope",e.scope),e.path&&r.set("path",e.path);const t=await c(`/app-api/data?${r.toString()}`,{method:"GET"}),n=await t.json().catch(()=>({}));if(!t.ok)throw new Error((n==null?void 0:n.error)||`Request failed (${t.status})`);return n==null?void 0:n.value}async function v(e){const r=new URLSearchParams,t=e==null?void 0:e.type,n=Array.isArray(t)?t:t?[t]:[];n.length>0&&r.set("type",n.join(",")),e!=null&&e.configuredOnly&&r.set("configuredOnly","true");const o=await c(`/app-api/models${r.toString()?`?${r.toString()}`:""}`,{method:"GET"}),a=await o.json().catch(()=>({}));if(!o.ok)throw new Error((a==null?void 0:a.error)||`Request failed (${o.status})`);return(Array.isArray(a==null?void 0:a.models)?a.models:[]).map(i=>{if(!i||typeof i!="object")return null;const g=typeof i.id=="string"?i.id.trim():"",m=typeof i.label=="string"?i.label.trim():g,h=i.type,s=i.configured===!0,y=typeof i.source=="string"&&i.source.trim()?i.source.trim():void 0;return!g||h!=="llm"&&h!=="embedding"&&h!=="image"&&h!=="stt"&&h!=="tts"?null:{id:g,label:m||g,type:h,configured:s,source:y}}).filter(i=>!!i)}async function P(e,r){const t=await c(e,r),o=(t.headers.get("content-type")||"").includes("application/json")?await t.json().catch(()=>({})):await t.text();if(!t.ok)throw new Error(typeof o=="string"?o||`Request failed (${t.status})`:(o==null?void 0:o.error)||(o==null?void 0:o.message)||`Request failed (${t.status})`);return o}const b=e=>e?e.split("/").map(r=>r.trim()).filter(Boolean).join("/"):"",E=(e,r)=>{const t=b(e),n=b(r);return t?n?`${t}/${n}`:t:n},T=(e,r)=>{const t={scope:e};return{async get(){const n=b(r);return k({...t,path:n||void 0})},async set(n){const o=b(r);return p("set",{...t,path:o||void 0,value:n})},async update(n){if(!n||typeof n!="object")throw new Error("update requires an object");const o={};for(const[a,l]of Object.entries(n)){const i=E(r,a);if(!i)throw new Error("update paths must be non-empty");o[i]=l}return p("update",{...t,updates:o})},async remove(){const n=b(r);return p("remove",{...t,path:n||void 0})},async push(n){const o=b(r);if(!o)throw new Error("push requires a path");return p("array-push",{...t,path:o,value:n})},ref(n){const o=E(r,n);if(!o)throw new Error("ref requires a path");return T(e,o)}}};return{isReady(){return!!d()&&!!f()},getBackendUrl(){var e;return((e=d())==null?void 0:e.backendUrl)??null},async models(e){return v(e)},async chatCompletions(e){var m;const{reasoningEffort:r,reasoning_effort:t,...n}=e,o=r??t,a={...n,stream:!1};o&&S(e.model)&&(a.reasoning_effort=o);const l=await c("/openai/chat/completions",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(a)}),g=(l.headers.get("content-type")||"").includes("application/json")?await l.json():await l.text();if(!l.ok)throw new Error(typeof g=="string"?g:((m=g==null?void 0:g.error)==null?void 0:m.message)||`Request failed (${l.status})`);return g},async chatText(e){var t,n,o;const r=await this.chatCompletions(e);return((o=(n=(t=r==null?void 0:r.choices)==null?void 0:t[0])==null?void 0:n.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 t=e==null?void 0:e.input;if(!(typeof t=="string"?t.length>0:Array.isArray(t)&&t.length>0&&t.every(a=>typeof a=="string")))throw new Error("embeddings.create requires input as a string or string[]");return P("/openai/embeddings",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({...e,model:r,input:t})})}},audio:{async speechToken(){const e=await c("/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 c("/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 t=await c("/app-api/audio/tts",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({text:r,voice:e.voice,lang:e.lang})});if(!t.ok){const a=await t.text();throw new Error(a||`Request failed (${t.status})`)}return{audio:await t.arrayBuffer(),contentType:t.headers.get("content-type")}},async stt(e){var x,U,A,O;if(!(e!=null&&e.file))throw new Error("audio.stt requires a file");const r=(x=e.language)==null?void 0:x.trim(),t=L=>{if(!L)return;const N=L.trim();if(!N)return;const B=N.toLowerCase(),_=B.split("-")[0];return _.length===2?_:B},n=typeof File<"u"&&e.file instanceof File,o=n&&e.file.name.split(".").pop()||"webm",a=e.ext||o,l=new FormData;n?l.set("file",e.file):l.set("file",e.file,`audio.${a}`);const i=t(r);i&&l.set("language",i),e.prompt&&l.set("prompt",e.prompt),e.responseFormat&&l.set("response_format",e.responseFormat);const g=new URLSearchParams({ext:a});r&&g.set("locale",r);const m=await c(`/app-api/audio/stt?${g.toString()}`,{method:"POST",body:l}),s=(m.headers.get("content-type")||"").includes("application/json")?await m.json():await m.text();if(!m.ok)throw new Error(typeof s=="string"?s:((U=s==null?void 0:s.error)==null?void 0:U.message)||`Request failed (${m.status})`);const y=typeof s=="string"?s:(s==null?void 0:s.text)||(s==null?void 0:s.original)||((O=(A=s==null?void 0:s.results)==null?void 0:A[0])==null?void 0:O.text)||"",W=typeof s=="object"&&typeof(s==null?void 0:s.language)=="string"?s.language:void 0;return{text:y,language:W,raw:s}},async voices(e){const r=new URLSearchParams;e!=null&&e.locale&&r.set("locale",e.locale);const t=await c(`/app-api/audio/tts/voices${r.toString()?`?${r}`:""}`,{method:"GET"}),n=await t.json().catch(()=>[]);if(!t.ok)throw new Error((n==null?void 0:n.error)||`Request failed (${t.status})`);return Array.isArray(n)?n:(n==null?void 0:n.voices)||[]}},web:{async scrapeUrl(e){var t;const r=(t=e==null?void 0:e.url)==null?void 0:t.trim();if(!r)throw new Error("web.scrapeUrl requires a url");return P("/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 t;const r=(t=e==null?void 0:e.query)==null?void 0:t.trim();if(!r)throw new Error("knowledge.search requires a query");return P("/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 P("/app-api/translator/live-share",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({displayLanguage:e})})},async update(e,r){await P(`/app-api/translator/live-share/${encodeURIComponent(e)}`,{method:"PUT",headers:{"Content-Type":"application/json"},body:JSON.stringify(r)})},async revoke(e){await P(`/app-api/translator/live-share/${encodeURIComponent(e)}`,{method:"DELETE"})}},data(e="private"){return T(e,"")}}}w.PromteAppProvider=D,w.PromteNativeProvider=F,w.usePromte=j,w.usePromteClient=R,w.usePromteDarkMode=G,w.usePromteModels=z,w.usePromteSettings=I,w.usePromteToken=J,w.usePromteUser=V,Object.defineProperty(w,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.7",
+  "version": "0.1.8",
   "private": false,
   "type": "module",
   "files": [