@aippy/runtime 0.4.2-dev.1 → 0.4.2-dev.3

package/README.md

@@ -127,9 +127,25 @@ const image = await generateImage({
 console.log(image.image?.base64);
 ```
 
-The AI module adds `getCredits` and `deductCredits` in the unreleased source; published `@aippy/runtime@0.4.1` does not include them. Use them only after installing a published release containing both exports (`>= 0.4.2`), and verify the installed module declarations before importing.
+### Credits
 
-The server checks the balance atomically and prevents duplicate charges for the same event and amount; changed charge details return HTTP 409. Insufficient balance uses the existing runtime error and host notification. Call credits functions from UI handlers with error handling. Use explicit deductions for custom actions; model generation already charges credits. See the [AI module](./src/ai/README.md) and `aippy-ai-sdk` skill for usage.
+`@aippy/runtime/credits` provides `getCredits` and `deductCredits` for balance
+queries and user-approved custom credit charges, including non-AI actions.
+The new subpath is unreleased in this change; published `@aippy/runtime@0.4.1`
+does not include it. Install a published release whose package exports and
+installed declarations provide `./credits` and both functions before importing.
+A release that only provides the old AI exports is not sufficient.
+
+```typescript
+import { getCredits, deductCredits } from '@aippy/runtime/credits';
+```
+
+The functions and their options types are no longer exported from
+`@aippy/runtime/ai`; update existing AI imports to the credits subpath. They
+remain available from the root runtime entry. No AI configuration is needed.
+Call them from UI handlers with error handling; model generation already charges
+credits. See the [credits module](./src/credits/README.md) and the
+`aippy-credits-sdk` skill for usage, retry constraints, and host behavior.
 
 ## Packages
 
@@ -138,6 +154,7 @@ The server checks the balance atomically and prevents duplicate charges for the
 - `@aippy/runtime/utils` - Platform detection, performance monitoring, PWA utilities
 - `@aippy/runtime/audio` - iOS-compatible Web Audio API wrapper
 - `@aippy/runtime/ai` - AI SDK adapter wrapping `ai` package, routes through backend proxy
+- `@aippy/runtime/credits` - Current-user credit balance and explicit deductions
 
 ## Publishing
 

package/dist/ai/errors.d.ts

@@ -2,6 +2,7 @@ import { AISDKError } from 'ai';
 /**
  * Normalizes a backend error response into an AISDKError.
  * Extracts and sends appMessage to container if present in the error response.
+ * Insufficient credits also asks the native host to open the recharge sheet.
  * Uses [Aippy Runtime] prefix - these errors are NOT reported to LLM.
  */
 export declare function normalizeError(response: Response, body?: unknown): AISDKError;

package/dist/ai/index.d.ts

@@ -41,6 +41,5 @@ export type { AippyOpenAIConfig } from './openai';
 export { aippyChatConfig, type AippyUseChatOptions, type AippyUIConfig, type AippyChatConfig, UI_CHAT_ENDPOINT, } from './ui';
 export { DEFAULT_BASE_URL, DEFAULT_UI_BASE_URL, DEFAULT_CHAT_MODEL, DEFAULT_CHAT_SYSTEM, resolveOpenAIConfig, resolveUIConfig, } from './shared';
 export { normalizeError } from './errors';
-export { getCredits, deductCredits, type CreditsRequestOptions, type DeductCreditsOptions, } from './credits';
 export { generateCharacter3D, generateMotion, type GenerateCharacter3DInput, type GenerateMotionInput, type ViggleAsset, } from './viggle/generate';
 export { type AIConfig, type AIConfigValue, type AIConfigItem, type NumberAIConfigItem, type BooleanAIConfigItem, type TextAIConfigItem, type EnumAIConfigItem, type AIConfigError, type AIConfigValues, validateAIConfig, parseAIConfig, loadAIConfig, getAIConfigValue, sendAIConfigToContainer, createAIConfig, } from './config';

package/dist/ai/index.js

@@ -1,25 +1,24 @@
-import { D as r, d as i, e as n, c as A, U as C, a as t, b as g, m as I, h as f, i as _, j as p, k as E, g as T, l as U, n as d, p as D, r as l, f as L, s as m, v } from "../helper-CALy6Ol_.js";
+import { D as r, d as i, e as n, c as A, U as C, a as g, b as t, j as f, g as I, h as p, i as _, l as E, p as T, r as U, f as D, s as l, v as L } from "../helper-BQmXeuDs.js";
 import "react";
 import "../bridge-CtB9L5kL.js";
+import { n as m } from "../fetch-lzas52mc.js";
 export {
   r as DEFAULT_BASE_URL,
   i as DEFAULT_CHAT_MODEL,
   n as DEFAULT_CHAT_SYSTEM,
   A as DEFAULT_UI_BASE_URL,
   C as UI_CHAT_ENDPOINT,
-  t as aippyAIProvider,
-  g as aippyChatConfig,
-  I as createAIConfig,
-  f as deductCredits,
-  _ as generateCharacter3D,
+  g as aippyAIProvider,
+  t as aippyChatConfig,
+  f as createAIConfig,
+  I as generateCharacter3D,
   p as generateMotion,
-  E as getAIConfigValue,
-  T as getCredits,
-  U as loadAIConfig,
-  d as normalizeError,
-  D as parseAIConfig,
-  l as resolveOpenAIConfig,
-  L as resolveUIConfig,
-  m as sendAIConfigToContainer,
-  v as validateAIConfig
+  _ as getAIConfigValue,
+  E as loadAIConfig,
+  m as normalizeError,
+  T as parseAIConfig,
+  U as resolveOpenAIConfig,
+  D as resolveUIConfig,
+  l as sendAIConfigToContainer,
+  L as validateAIConfig
 };

package/dist/{container-message-C2rC9u_k.js → container-message-D1_iPvJX.js}

@@ -1,6 +1,6 @@
 import "react";
 import { g as a } from "./bridge-CtB9L5kL.js";
-const r = "0.4.2-dev.1", i = {
+const r = "0.4.2-dev.3", i = {
   version: r
 }, o = i.version, c = "@aippy/runtime";
 function w() {

package/dist/core/index.js

@@ -1,7 +1,7 @@
 import { D as r, g as s, m as o } from "../config-B0A7gHQM.js";
 import { _ as t, r as i } from "../bridge-CtB9L5kL.js";
 import { A as R, a as E, E as c, b as m, c as A } from "../errors-B3bDbQbD.js";
-import { S as f, V as g, c as l, a as y, g as _, s as d } from "../container-message-C2rC9u_k.js";
+import { S as f, V as g, c as l, a as y, g as _, s as d } from "../container-message-D1_iPvJX.js";
 import { A as D, C as O, R as F, a as I, p as S } from "../runtime-CmoG3v2m.js";
 export {
   D as AippyRuntime,

package/dist/{ai → credits}/credits.d.ts

@@ -1,5 +1,6 @@
-import { AippyOpenAIConfig } from './shared';
-export interface CreditsRequestOptions extends AippyOpenAIConfig {
+export interface CreditsRequestOptions {
+    /** Backend API base URL, including /aisdk/v1/; resolved from the page by default. */
+    baseUrl?: string;
     signal?: AbortSignal;
 }
 export interface DeductCreditsOptions extends CreditsRequestOptions {

package/dist/credits/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @aippy/runtime/credits — balance and explicit deductions for Aippy credits.
+ */
+export { getCredits, deductCredits, type CreditsRequestOptions, type DeductCreditsOptions, } from './credits';

package/dist/credits/index.js

@@ -0,0 +1,5 @@
+import { d as t, g as r } from "../credits-IWtJtN8O.js";
+export {
+  t as deductCredits,
+  r as getCredits
+};

package/dist/credits-IWtJtN8O.js

@@ -0,0 +1,53 @@
+import { AISDKError as o } from "ai";
+import { c as m } from "./fetch-lzas52mc.js";
+import { r as p } from "./bridge-CtB9L5kL.js";
+import { E as c } from "./errors-B3bDbQbD.js";
+import { j as v } from "./url-c26cuIpu.js";
+async function w(r = {}) {
+  const e = await d("GET", "credits", r);
+  return (!e || typeof e != "object" || !("credits" in e) || !Number.isSafeInteger(e.credits)) && a(), e.credits;
+}
+async function E(r, e) {
+  (!Number.isSafeInteger(r) || r <= 0) && n("deductCredits amount must be a positive safe integer"), (typeof e?.eventId != "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
+    e.eventId
+  )) && n("deductCredits eventId must be a UUID");
+  const t = await d("POST", "credits/deduct", e, {
+    amount: r,
+    eventId: e.eventId.toLowerCase()
+  });
+  (!t || typeof t != "object" || !("success" in t) || t.success !== !0) && a();
+}
+async function d(r, e, t, i) {
+  const f = t.baseUrl ?? `${p()}/aisdk/v1/`, u = await m()(v(f, e), {
+    method: r,
+    cache: "no-store",
+    signal: t.signal,
+    headers: i === void 0 ? void 0 : { "Content-Type": "application/json" },
+    body: i === void 0 ? void 0 : JSON.stringify(i)
+  });
+  try {
+    return await u.json();
+  } catch (s) {
+    if (t.signal?.aborted)
+      throw t.signal.reason ?? s;
+    if (s instanceof Error && s.name === "AbortError")
+      throw s;
+    a();
+  }
+}
+function n(r) {
+  throw new o({
+    name: "AippyAIError_credits_input",
+    message: `${c.CODE} ${r}`
+  });
+}
+function a() {
+  throw new o({
+    name: "AippyAIError_credits_response",
+    message: `${c.RUNTIME} Invalid credits response`
+  });
+}
+export {
+  E as d,
+  w as g
+};

package/dist/credits.d.ts

@@ -0,0 +1,2 @@
+export * from './credits/index'
+export {}

package/dist/fetch-lzas52mc.js

@@ -0,0 +1,66 @@
+import { s as i, a as u } from "./container-message-D1_iPvJX.js";
+import { AISDKError as c } from "ai";
+import { E as p } from "./errors-B3bDbQbD.js";
+const f = 100003, m = "insufficient_quota";
+function g(s, r) {
+  const t = s.status;
+  if (r && typeof r == "object" && "error" in r) {
+    const e = r, a = e.error.code, o = a != null ? `AippyAIError_${a}` : `AippyAIError_${t}`, n = r;
+    return "appMessage" in n && n.appMessage !== void 0 && i(n.appMessage), l(e.error) && E(), new c({
+      name: o,
+      message: `${p.RUNTIME} ${e.error.message}`,
+      cause: {
+        type: e.error.type ?? void 0,
+        param: e.error.param ?? void 0,
+        status: t
+      }
+    });
+  }
+  if (r && typeof r == "object" && r !== null) {
+    const e = r;
+    "appMessage" in e && e.appMessage !== void 0 && i(e.appMessage);
+  }
+  return new c({
+    name: `AippyAIError_${t}`,
+    message: `${p.RUNTIME} Request failed with status ${t}`,
+    cause: { status: t }
+  });
+}
+function l(s) {
+  return s.code === f || s.type === m;
+}
+function E() {
+  if (!(typeof window > "u"))
+    try {
+      const s = window.webkit?.messageHandlers?.aippyListener;
+      if (!s)
+        return;
+      s.postMessage({ command: "wallet.showRecharge" });
+    } catch (s) {
+      console.warn(
+        "⚠️ [Container Message] Failed to request native recharge:",
+        s
+      );
+    }
+}
+function d() {
+  return async (s, r) => {
+    const t = await u(r?.headers), e = await globalThis.fetch(s, { ...r, headers: t });
+    if (!e.ok) {
+      const a = await e.text().catch(() => null);
+      let o = null;
+      if (a)
+        try {
+          o = JSON.parse(a);
+        } catch {
+          o = { message: a };
+        }
+      throw g(e, o);
+    }
+    return e;
+  };
+}
+export {
+  d as c,
+  g as n
+};

package/dist/helper-BQmXeuDs.js

@@ -0,0 +1,299 @@
+import { createOpenAICompatible as I } from "@ai-sdk/openai-compatible";
+import { c as d } from "./fetch-lzas52mc.js";
+import { j as C } from "./url-c26cuIpu.js";
+import { DefaultChatTransport as O, AISDKError as h } from "ai";
+import { E as y, b as p, a as f } from "./errors-B3bDbQbD.js";
+import { r as m } from "./bridge-CtB9L5kL.js";
+const v = `${m()}/aisdk/v1/`, K = `${m()}/aisdk/v1/ui/`, S = "gpt-5-nano", _ = "";
+function E(t = {}) {
+  return {
+    baseUrl: t.baseUrl ?? `${m()}/aisdk/v1/`
+  };
+}
+function T(t = {}) {
+  return {
+    baseUrl: t.baseUrl ?? `${m()}/aisdk/v1/ui/`
+  };
+}
+const U = [
+  "gpt-image-1",
+  "gpt-image-1-mini",
+  "gpt-image-1.5"
+];
+function D(t) {
+  try {
+    const e = JSON.parse(t);
+    if (e.model && U.some((n) => e.model.startsWith(n))) {
+      const { response_format: n, ...o } = e;
+      return JSON.stringify(o);
+    }
+  } catch {
+  }
+  return t;
+}
+function X(t = {}) {
+  const { baseUrl: e } = E(t), n = d();
+  return I({
+    name: "aippy",
+    baseURL: e,
+    fetch: async (s, r) => s.toString().includes("/images/generations") && r?.method?.toUpperCase() === "POST" && r?.body ? n(s, {
+      ...r,
+      body: D(r.body)
+    }) : n(s, r),
+    // Enable structured outputs support (json_schema response format)
+    // This is required for Output.object() and Output.array() to work properly
+    supportsStructuredOutputs: !0
+  });
+}
+const M = "/chat";
+function Y(t = {}) {
+  const { baseUrl: e } = T(t), n = t.model ?? S, o = t.system ?? _, s = t.api ?? C(e, M), r = { model: n, system: o }, a = d();
+  return {
+    transport: new O({
+      api: s,
+      body: r,
+      // Ensure token is fetched fresh for every request
+      fetch: a
+    })
+  };
+}
+function l(t) {
+  return [...t].length;
+}
+const L = 3e3, N = 5e3, F = 300 * 1e3, R = 360 * 1e3;
+async function Q(t) {
+  const e = t.prompt?.trim() ?? "", n = t.imageUrl?.trim() ?? "", o = t.image;
+  l(e) > 1e3 && u("generateCharacter3D prompt must be at most 1000 characters"), o != null && !(o instanceof Blob) && u("generateCharacter3D image must be a file"), o instanceof Blob && o.size === 0 && u("generateCharacter3D image is empty");
+  const s = t;
+  return A(
+    "viggle/characters",
+    o instanceof Blob ? $(o, e) : j(n, e),
+    s.pollIntervalMs ?? L,
+    s.timeoutMs ?? F,
+    t.signal
+  );
+}
+function $(t, e) {
+  const n = new FormData(), o = t instanceof File && t.name ? t.name : "image.png";
+  return n.append("image", t, o), e && n.append("prompt", e), { body: n };
+}
+function j(t, e) {
+  !e && !t && u(
+    "generateCharacter3D requires an image, an https imageUrl, or a prompt"
+  ), t && !t.startsWith("https://") && u("generateCharacter3D imageUrl must be an https URL");
+  const n = {};
+  return t && (n.imageUrl = t), e && (n.prompt = e), {
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(n)
+  };
+}
+async function Z(t) {
+  const e = t.text?.trim() ?? "";
+  (l(e) < 1 || l(e) > 400) && u("generateMotion text must be 1 to 400 characters"), t.durationSeconds != null && (!Number.isInteger(t.durationSeconds) || t.durationSeconds < 3 || t.durationSeconds > 60) && u("generateMotion durationSeconds must be an integer from 3 to 60");
+  const n = { text: e };
+  t.durationSeconds != null && (n.durationSeconds = t.durationSeconds);
+  const o = t;
+  return A(
+    "viggle/motions",
+    {
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(n)
+    },
+    o.pollIntervalMs ?? N,
+    o.timeoutMs ?? R,
+    t.signal
+  );
+}
+async function A(t, e, n, o, s) {
+  const r = d(), a = Date.now();
+  let i = await b(r, t, {
+    method: "POST",
+    ...e,
+    signal: s
+  });
+  for (; i.status !== "ready"; )
+    i.status === "failed" && g(i.error || "Viggle generation failed"), Date.now() - a > o && g("Viggle generation timed out"), await P(n, s), i = await b(r, `${t}/${i.id}`, {
+      method: "GET",
+      signal: s
+    });
+  return i.url || g("Viggle generation finished without a file URL"), { url: i.url, thumbnailUrl: i.thumbnailUrl };
+}
+async function b(t, e, n) {
+  return await (await t(x(v, e), {
+    ...n,
+    cache: "no-store"
+  })).json();
+}
+function x(t, e) {
+  return `${t.replace(/\/$/, "")}/${e.replace(/^\//, "")}`;
+}
+function P(t, e) {
+  if (e?.aborted)
+    throw e.reason ?? new DOMException("The operation was aborted", "AbortError");
+  return new Promise((n, o) => {
+    const s = setTimeout(n, t);
+    e?.addEventListener(
+      "abort",
+      () => {
+        clearTimeout(s), o(
+          e.reason ?? new DOMException("The operation was aborted", "AbortError")
+        );
+      },
+      { once: !0 }
+    );
+  });
+}
+function u(t) {
+  throw new h({
+    name: "AippyAIError_viggle_input",
+    message: `${y.CODE} ${t}`
+  });
+}
+function g(t) {
+  throw new h({
+    name: "AippyAIError_viggle",
+    message: `${y.RUNTIME} ${t}`
+  });
+}
+function w(t) {
+  const e = [];
+  if (!t || typeof t != "object")
+    throw p("AIConfig must be an object", f.INVALID_CONFIG);
+  const n = t;
+  for (const [o, s] of Object.entries(n)) {
+    if (!s || typeof s != "object") {
+      e.push({ key: o, message: "Item must be an object" });
+      continue;
+    }
+    const r = s;
+    typeof r.index != "number" && e.push({ key: o, message: "index must be a number" }), typeof r.name != "string" && e.push({ key: o, message: "name must be a string" }), typeof r.description != "string" && e.push({ key: o, message: "description must be a string" });
+    const a = r.type;
+    if (!["number", "boolean", "text", "enum"].includes(a)) {
+      e.push({
+        key: o,
+        message: `type must be one of: number, boolean, text, enum (got: ${a})`
+      });
+      continue;
+    }
+    if (a === "number")
+      typeof r.value != "number" && e.push({ key: o, message: 'value must be a number for type "number"' }), r.min !== void 0 && typeof r.min != "number" && e.push({ key: o, message: "min must be a number" }), r.max !== void 0 && typeof r.max != "number" && e.push({ key: o, message: "max must be a number" }), r.step !== void 0 && typeof r.step != "number" && e.push({ key: o, message: "step must be a number" });
+    else if (a === "boolean")
+      typeof r.value != "boolean" && e.push({ key: o, message: 'value must be a boolean for type "boolean"' });
+    else if (a === "text")
+      typeof r.value != "string" && e.push({ key: o, message: 'value must be a string for type "text"' });
+    else if (a === "enum") {
+      if (!Array.isArray(r.options))
+        e.push({ key: o, message: 'options must be an array for type "enum"' });
+      else if (r.options.length === 0)
+        e.push({ key: o, message: 'options array cannot be empty for type "enum"' });
+      else
+        for (let c = 0; c < r.options.length; c++)
+          typeof r.options[c] != "string" && e.push({
+            key: o,
+            message: `options[${c}] must be a string`
+          });
+      typeof r.value != "string" ? e.push({ key: o, message: 'value must be a string for type "enum"' }) : Array.isArray(r.options) && !r.options.includes(r.value) && e.push({
+        key: o,
+        message: `value "${r.value}" is not in options: [${r.options.join(", ")}]`
+      });
+    }
+    r.group !== void 0 && typeof r.group != "string" && e.push({ key: o, message: "group must be a string" });
+  }
+  if (e.length > 0)
+    throw p(
+      `AIConfig validation failed with ${e.length} error(s)`,
+      f.INVALID_CONFIG,
+      { errors: e }
+    );
+}
+function ee(t) {
+  let e;
+  try {
+    e = JSON.parse(t);
+  } catch (n) {
+    throw p(
+      `Invalid JSON: ${n instanceof Error ? n.message : String(n)}`,
+      f.INVALID_CONFIG
+    );
+  }
+  return w(e), e;
+}
+function B(t) {
+  return w(t), t;
+}
+function J(t, e) {
+  const n = t[e];
+  if (!n)
+    throw p(
+      `AIConfig key "${e}" not found`,
+      f.INVALID_CONFIG,
+      { key: e }
+    );
+  return n.value;
+}
+function V(t) {
+  if (!(typeof window > "u"))
+    try {
+      const e = window.webkit?.messageHandlers?.aippyListener;
+      if (e)
+        try {
+          const n = {
+            command: "ai.initialize",
+            parameters: JSON.stringify(t)
+          };
+          e.postMessage(n);
+        } catch (n) {
+          console.warn("❌ [Aippy AI Config] Failed to send config to iOS app:", n);
+        }
+      if (window.parent && window.parent !== window)
+        try {
+          const n = {
+            type: "ai.initialize",
+            config: JSON.stringify(t)
+          };
+          window.parent.postMessage(n, "*");
+        } catch (n) {
+          console.warn("❌ [Aippy AI Config] Failed to send config to parent window:", n);
+        }
+    } catch (e) {
+      console.warn("⚠️ [Aippy AI Config] Failed to send config:", e);
+    }
+}
+function te(t) {
+  const e = B(t);
+  return V(e), new Proxy({}, {
+    get(n, o) {
+      if (typeof o == "string")
+        try {
+          return J(e, o);
+        } catch {
+          return;
+        }
+    },
+    has(n, o) {
+      return typeof o != "string" ? !1 : o in e;
+    },
+    ownKeys(n) {
+      return Object.keys(e);
+    }
+  });
+}
+export {
+  v as D,
+  M as U,
+  X as a,
+  Y as b,
+  K as c,
+  S as d,
+  _ as e,
+  T as f,
+  Q as g,
+  Z as h,
+  J as i,
+  te as j,
+  B as l,
+  ee as p,
+  E as r,
+  V as s,
+  w as v
+};

package/dist/index/index.js

@@ -1,18 +1,20 @@
 import { D as r, g as s, m as o } from "../config-B0A7gHQM.js";
 import { _ as i, g as n, r as p } from "../bridge-CtB9L5kL.js";
-import { A as m, a as c, E as f, b as C, c as g } from "../errors-B3bDbQbD.js";
-import { S as d, V as l, c as I, a as E, g as S, s as x } from "../container-message-C2rC9u_k.js";
+import { A as m, a as f, E as c, b as C, c as g } from "../errors-B3bDbQbD.js";
+import { S as u, V as l, c as I, a as E, g as S, s as x } from "../container-message-D1_iPvJX.js";
 import { A as U, C as _, R as D, a as T, p as h } from "../runtime-CmoG3v2m.js";
-import { CameraAPI as y, FileSystemAPI as F, GeolocationAPI as M, SensorsAPI as P, camera as O, fileSystem as b, geolocation as L, isMotionSupported as w, isOrientationSupported as H, requestMotionPermission as N, sensors as V, vibrate as k, watchMotion as B, watchOrientation as j } from "../device/index.js";
+import { CameraAPI as y, FileSystemAPI as F, GeolocationAPI as M, SensorsAPI as P, camera as O, fileSystem as b, geolocation as L, isMotionSupported as w, isOrientationSupported as H, requestMotionPermission as N, sensors as V, vibrate as B, watchMotion as k, watchOrientation as j } from "../device/index.js";
 import { P as G, a as z, c as K, b as W, g as X, i as Y, p as J, r as Q, s as Z } from "../app-version-checker-Bz7FrEZz.js";
 import { a as ee, P as ae, p as re, b as se } from "../pwa-C5nXU0DN.js";
 import { j as te } from "../url-c26cuIpu.js";
 import { a as ne, b as pe } from "../useTweaks-C7BEMpV3.js";
-import { c as me, b as ce, i as fe, p as Ce, u as ge, a as ue } from "../useSound-z_eIn0KH.js";
+import { c as me, b as fe, i as ce, p as Ce, u as ge, a as de } from "../useSound-z_eIn0KH.js";
 import { reportScore as le, sendEvent as Ie, updateScore as Ee } from "../leaderboard/index.js";
-import { D as xe, d as Re, e as Ue, c as _e, U as De, a as Te, b as he, m as ve, h as ye, i as Fe, j as Me, k as Pe, g as Oe, l as be, n as Le, p as we, r as He, f as Ne, s as Ve, v as ke } from "../helper-CALy6Ol_.js";
-import { c as je, u as qe } from "../hooks-D5lkty5r.js";
-import { hasNativeBridge as ze } from "../native-bridge-BnvipFJc.js";
+import { D as xe, d as Re, e as Ue, c as _e, U as De, a as Te, b as he, j as ve, g as ye, h as Fe, i as Me, l as Pe, p as Oe, r as be, f as Le, s as we, v as He } from "../helper-BQmXeuDs.js";
+import { n as Ve } from "../fetch-lzas52mc.js";
+import { d as ke, g as je } from "../credits-IWtJtN8O.js";
+import { c as Ge, u as ze } from "../hooks-D5lkty5r.js";
+import { hasNativeBridge as We } from "../native-bridge-BnvipFJc.js";
 export {
   U as AippyRuntime,
   m as AippyRuntimeError,
@@ -23,15 +25,15 @@ export {
   Ue as DEFAULT_CHAT_SYSTEM,
   r as DEFAULT_CONFIG,
   _e as DEFAULT_UI_BASE_URL,
-  c as ERROR_CODES,
-  f as ERROR_PREFIX,
+  f as ERROR_CODES,
+  c as ERROR_PREFIX,
   F as FileSystemAPI,
   M as GeolocationAPI,
   ee as PWAUtils,
   ae as PerformanceMonitor,
   G as PlatformDetector,
   D as ReceiveChannel,
-  d as SDK_NAME,
+  u as SDK_NAME,
   P as SensorsAPI,
   De as UI_CHAT_ENDPOINT,
   l as VERSION,
@@ -43,7 +45,7 @@ export {
   pe as aippyTweaksRuntime,
   O as camera,
   z as checkFeatureSupport,
-  je as clearUserInfoCache,
+  Ge as clearUserInfoCache,
   K as compareVersions,
   ve as createAIConfig,
   I as createAippyHeaders,
@@ -51,29 +53,29 @@ export {
   C as createCodeError,
   g as createError,
   me as createHiddenMediaElement,
-  ye as deductCredits,
+  ke as deductCredits,
   b as fileSystem,
-  Fe as generateCharacter3D,
-  Me as generateMotion,
+  ye as generateCharacter3D,
+  Fe as generateMotion,
   L as geolocation,
-  Pe as getAIConfigValue,
+  Me as getAIConfigValue,
   n as getAuthTokenAsync,
   W as getAvailableFeatures,
   s as getConfigFromEnv,
-  Oe as getCredits,
+  je as getCredits,
   X as getFeatureVersionRequirements,
   S as getVersionInfo,
-  ze as hasNativeBridge,
-  ce as isIOSDevice,
+  We as hasNativeBridge,
+  fe as isIOSDevice,
   Y as isInIframe,
-  fe as isMediaStreamAudioSupported,
+  ce as isMediaStreamAudioSupported,
   w as isMotionSupported,
   H as isOrientationSupported,
   te as joinUrl,
-  be as loadAIConfig,
+  Pe as loadAIConfig,
   o as mergeConfig,
-  Le as normalizeError,
-  we as parseAIConfig,
+  Ve as normalizeError,
+  Oe as parseAIConfig,
   Ce as patchAudioContext,
   re as performanceMonitor,
   J as platform,
@@ -83,19 +85,19 @@ export {
   N as requestMotionPermission,
   Q as requireFeatureSupport,
   p as resolveApiBaseUrl,
-  He as resolveOpenAIConfig,
-  Ne as resolveUIConfig,
-  Ve as sendAIConfigToContainer,
+  be as resolveOpenAIConfig,
+  Le as resolveUIConfig,
+  we as sendAIConfigToContainer,
   Ie as sendEvent,
   x as sendMessageToContainer,
   V as sensors,
   Z as showAlert,
   Ee as updateScore,
   ge as useAudioContext,
-  ue as useSound,
-  qe as useUserInfo,
-  ke as validateAIConfig,
-  k as vibrate,
-  B as watchMotion,
+  de as useSound,
+  ze as useUserInfo,
+  He as validateAIConfig,
+  B as vibrate,
+  k as watchMotion,
   j as watchOrientation
 };

package/dist/index.d.ts

@@ -5,4 +5,5 @@ export * from './tweaks';
 export * from './audio';
 export * from './leaderboard';
 export * from './ai';
+export * from './credits';
 export * from './user';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aippy/runtime",
-  "version": "0.4.2-dev.1",
+  "version": "0.4.2-dev.3",
   "description": "Aippy Runtime SDK - Runtime SDK for Aippy projects",
   "private": false,
   "type": "module",
@@ -40,6 +40,10 @@
       "import": "./dist/ai/index.js",
       "types": "./dist/ai.d.ts"
     },
+    "./credits": {
+      "types": "./dist/credits/index.d.ts",
+      "import": "./dist/credits/index.js"
+    },
     "./user": {
       "import": "./dist/user/index.js",
       "types": "./dist/user/index.d.ts"
@@ -127,6 +131,7 @@
     "test:openai": "pnpm run build && node --test 'tests/ai/openai/*.test.mjs'",
     "test:ui": "pnpm run build && node --test 'tests/ai/ui/*.test.mjs'",
     "test:file": "pnpm run build && node --test",
+    "test:credits": "pnpm run build && node --test 'tests/credits/*.test.mjs'",
     "test:build": "node -c dist/index.js"
   }
 }

package/dist/helper-CALy6Ol_.js

@@ -1,387 +0,0 @@
-import { createOpenAICompatible as _ } from "@ai-sdk/openai-compatible";
-import { j as v } from "./url-c26cuIpu.js";
-import { AISDKError as u, DefaultChatTransport as T } from "ai";
-import { E as p, b as m, a as d } from "./errors-B3bDbQbD.js";
-import { r as g } from "./bridge-CtB9L5kL.js";
-import { s as I, a as U } from "./container-message-C2rC9u_k.js";
-const M = `${g()}/aisdk/v1/`, te = `${g()}/aisdk/v1/ui/`, N = "gpt-5-nano", $ = "";
-function C(t = {}) {
-  return {
-    baseUrl: t.baseUrl ?? `${g()}/aisdk/v1/`
-  };
-}
-function D(t = {}) {
-  return {
-    baseUrl: t.baseUrl ?? `${g()}/aisdk/v1/ui/`
-  };
-}
-function R(t, e) {
-  const r = t.status;
-  if (e && typeof e == "object" && "error" in e) {
-    const n = e, o = n.error.code, s = o != null ? `AippyAIError_${o}` : `AippyAIError_${r}`, a = e;
-    return "appMessage" in a && a.appMessage !== void 0 && I(a.appMessage), new u({
-      name: s,
-      message: `${p.RUNTIME} ${n.error.message}`,
-      cause: {
-        type: n.error.type ?? void 0,
-        param: n.error.param ?? void 0,
-        status: r
-      }
-    });
-  }
-  if (e && typeof e == "object" && e !== null) {
-    const n = e;
-    "appMessage" in n && n.appMessage !== void 0 && I(n.appMessage);
-  }
-  return new u({
-    name: `AippyAIError_${r}`,
-    message: `${p.RUNTIME} Request failed with status ${r}`,
-    cause: { status: r }
-  });
-}
-function l() {
-  return async (t, e) => {
-    const r = await U(e?.headers), n = await globalThis.fetch(t, { ...e, headers: r });
-    if (!n.ok) {
-      const o = await n.text().catch(() => null);
-      let s = null;
-      if (o)
-        try {
-          s = JSON.parse(o);
-        } catch {
-          s = { message: o };
-        }
-      throw R(n, s);
-    }
-    return n;
-  };
-}
-const L = [
-  "gpt-image-1",
-  "gpt-image-1-mini",
-  "gpt-image-1.5"
-];
-function j(t) {
-  try {
-    const e = JSON.parse(t);
-    if (e.model && L.some((r) => e.model.startsWith(r))) {
-      const { response_format: r, ...n } = e;
-      return JSON.stringify(n);
-    }
-  } catch {
-  }
-  return t;
-}
-function re(t = {}) {
-  const { baseUrl: e } = C(t), r = l();
-  return _({
-    name: "aippy",
-    baseURL: e,
-    fetch: async (o, s) => o.toString().includes("/images/generations") && s?.method?.toUpperCase() === "POST" && s?.body ? r(o, {
-      ...s,
-      body: j(s.body)
-    }) : r(o, s),
-    // Enable structured outputs support (json_schema response format)
-    // This is required for Output.object() and Output.array() to work properly
-    supportsStructuredOutputs: !0
-  });
-}
-const F = "/chat";
-function ne(t = {}) {
-  const { baseUrl: e } = D(t), r = t.model ?? N, n = t.system ?? $, o = t.api ?? v(e, F), s = { model: r, system: n }, a = l();
-  return {
-    transport: new T({
-      api: o,
-      body: s,
-      // Ensure token is fetched fresh for every request
-      fetch: a
-    })
-  };
-}
-async function se(t = {}) {
-  const e = await E("GET", "credits", t);
-  return (!e || typeof e != "object" || !("credits" in e) || !Number.isSafeInteger(e.credits)) && b(), e.credits;
-}
-async function oe(t, e) {
-  (!Number.isSafeInteger(t) || t <= 0) && w("deductCredits amount must be a positive safe integer"), (typeof e?.eventId != "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(
-    e.eventId
-  )) && w("deductCredits eventId must be a UUID");
-  const r = await E("POST", "credits/deduct", e, {
-    amount: t,
-    eventId: e.eventId.toLowerCase()
-  });
-  (!r || typeof r != "object" || !("success" in r) || r.success !== !0) && b();
-}
-async function E(t, e, r, n) {
-  const { baseUrl: o } = C(r), s = await l()(v(o, e), {
-    method: t,
-    cache: "no-store",
-    signal: r.signal,
-    headers: n === void 0 ? void 0 : { "Content-Type": "application/json" },
-    body: n === void 0 ? void 0 : JSON.stringify(n)
-  });
-  try {
-    return await s.json();
-  } catch (a) {
-    if (r.signal?.aborted)
-      throw r.signal.reason ?? a;
-    if (a instanceof Error && a.name === "AbortError")
-      throw a;
-    b();
-  }
-}
-function w(t) {
-  throw new u({
-    name: "AippyAIError_credits_input",
-    message: `${p.CODE} ${t}`
-  });
-}
-function b() {
-  throw new u({
-    name: "AippyAIError_credits_response",
-    message: `${p.RUNTIME} Invalid credits response`
-  });
-}
-function y(t) {
-  return [...t].length;
-}
-const x = 3e3, B = 5e3, J = 300 * 1e3, P = 360 * 1e3;
-async function ae(t) {
-  const e = t.prompt?.trim() ?? "", r = t.imageUrl?.trim() ?? "", n = t.image;
-  y(e) > 1e3 && c("generateCharacter3D prompt must be at most 1000 characters"), n != null && !(n instanceof Blob) && c("generateCharacter3D image must be a file"), n instanceof Blob && n.size === 0 && c("generateCharacter3D image is empty");
-  const o = t;
-  return O(
-    "viggle/characters",
-    n instanceof Blob ? H(n, e) : V(r, e),
-    o.pollIntervalMs ?? x,
-    o.timeoutMs ?? J,
-    t.signal
-  );
-}
-function H(t, e) {
-  const r = new FormData(), n = t instanceof File && t.name ? t.name : "image.png";
-  return r.append("image", t, n), e && r.append("prompt", e), { body: r };
-}
-function V(t, e) {
-  !e && !t && c(
-    "generateCharacter3D requires an image, an https imageUrl, or a prompt"
-  ), t && !t.startsWith("https://") && c("generateCharacter3D imageUrl must be an https URL");
-  const r = {};
-  return t && (r.imageUrl = t), e && (r.prompt = e), {
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(r)
-  };
-}
-async function ie(t) {
-  const e = t.text?.trim() ?? "";
-  (y(e) < 1 || y(e) > 400) && c("generateMotion text must be 1 to 400 characters"), t.durationSeconds != null && (!Number.isInteger(t.durationSeconds) || t.durationSeconds < 3 || t.durationSeconds > 60) && c("generateMotion durationSeconds must be an integer from 3 to 60");
-  const r = { text: e };
-  t.durationSeconds != null && (r.durationSeconds = t.durationSeconds);
-  const n = t;
-  return O(
-    "viggle/motions",
-    {
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(r)
-    },
-    n.pollIntervalMs ?? B,
-    n.timeoutMs ?? P,
-    t.signal
-  );
-}
-async function O(t, e, r, n, o) {
-  const s = l(), a = Date.now();
-  let i = await A(s, t, {
-    method: "POST",
-    ...e,
-    signal: o
-  });
-  for (; i.status !== "ready"; )
-    i.status === "failed" && h(i.error || "Viggle generation failed"), Date.now() - a > n && h("Viggle generation timed out"), await G(r, o), i = await A(s, `${t}/${i.id}`, {
-      method: "GET",
-      signal: o
-    });
-  return i.url || h("Viggle generation finished without a file URL"), { url: i.url, thumbnailUrl: i.thumbnailUrl };
-}
-async function A(t, e, r) {
-  return await (await t(k(M, e), {
-    ...r,
-    cache: "no-store"
-  })).json();
-}
-function k(t, e) {
-  return `${t.replace(/\/$/, "")}/${e.replace(/^\//, "")}`;
-}
-function G(t, e) {
-  if (e?.aborted)
-    throw e.reason ?? new DOMException("The operation was aborted", "AbortError");
-  return new Promise((r, n) => {
-    const o = setTimeout(r, t);
-    e?.addEventListener(
-      "abort",
-      () => {
-        clearTimeout(o), n(
-          e.reason ?? new DOMException("The operation was aborted", "AbortError")
-        );
-      },
-      { once: !0 }
-    );
-  });
-}
-function c(t) {
-  throw new u({
-    name: "AippyAIError_viggle_input",
-    message: `${p.CODE} ${t}`
-  });
-}
-function h(t) {
-  throw new u({
-    name: "AippyAIError_viggle",
-    message: `${p.RUNTIME} ${t}`
-  });
-}
-function S(t) {
-  const e = [];
-  if (!t || typeof t != "object")
-    throw m("AIConfig must be an object", d.INVALID_CONFIG);
-  const r = t;
-  for (const [n, o] of Object.entries(r)) {
-    if (!o || typeof o != "object") {
-      e.push({ key: n, message: "Item must be an object" });
-      continue;
-    }
-    const s = o;
-    typeof s.index != "number" && e.push({ key: n, message: "index must be a number" }), typeof s.name != "string" && e.push({ key: n, message: "name must be a string" }), typeof s.description != "string" && e.push({ key: n, message: "description must be a string" });
-    const a = s.type;
-    if (!["number", "boolean", "text", "enum"].includes(a)) {
-      e.push({
-        key: n,
-        message: `type must be one of: number, boolean, text, enum (got: ${a})`
-      });
-      continue;
-    }
-    if (a === "number")
-      typeof s.value != "number" && e.push({ key: n, message: 'value must be a number for type "number"' }), s.min !== void 0 && typeof s.min != "number" && e.push({ key: n, message: "min must be a number" }), s.max !== void 0 && typeof s.max != "number" && e.push({ key: n, message: "max must be a number" }), s.step !== void 0 && typeof s.step != "number" && e.push({ key: n, message: "step must be a number" });
-    else if (a === "boolean")
-      typeof s.value != "boolean" && e.push({ key: n, message: 'value must be a boolean for type "boolean"' });
-    else if (a === "text")
-      typeof s.value != "string" && e.push({ key: n, message: 'value must be a string for type "text"' });
-    else if (a === "enum") {
-      if (!Array.isArray(s.options))
-        e.push({ key: n, message: 'options must be an array for type "enum"' });
-      else if (s.options.length === 0)
-        e.push({ key: n, message: 'options array cannot be empty for type "enum"' });
-      else
-        for (let f = 0; f < s.options.length; f++)
-          typeof s.options[f] != "string" && e.push({
-            key: n,
-            message: `options[${f}] must be a string`
-          });
-      typeof s.value != "string" ? e.push({ key: n, message: 'value must be a string for type "enum"' }) : Array.isArray(s.options) && !s.options.includes(s.value) && e.push({
-        key: n,
-        message: `value "${s.value}" is not in options: [${s.options.join(", ")}]`
-      });
-    }
-    s.group !== void 0 && typeof s.group != "string" && e.push({ key: n, message: "group must be a string" });
-  }
-  if (e.length > 0)
-    throw m(
-      `AIConfig validation failed with ${e.length} error(s)`,
-      d.INVALID_CONFIG,
-      { errors: e }
-    );
-}
-function ce(t) {
-  let e;
-  try {
-    e = JSON.parse(t);
-  } catch (r) {
-    throw m(
-      `Invalid JSON: ${r instanceof Error ? r.message : String(r)}`,
-      d.INVALID_CONFIG
-    );
-  }
-  return S(e), e;
-}
-function q(t) {
-  return S(t), t;
-}
-function z(t, e) {
-  const r = t[e];
-  if (!r)
-    throw m(
-      `AIConfig key "${e}" not found`,
-      d.INVALID_CONFIG,
-      { key: e }
-    );
-  return r.value;
-}
-function W(t) {
-  if (!(typeof window > "u"))
-    try {
-      const e = window.webkit?.messageHandlers?.aippyListener;
-      if (e)
-        try {
-          const r = {
-            command: "ai.initialize",
-            parameters: JSON.stringify(t)
-          };
-          e.postMessage(r);
-        } catch (r) {
-          console.warn("❌ [Aippy AI Config] Failed to send config to iOS app:", r);
-        }
-      if (window.parent && window.parent !== window)
-        try {
-          const r = {
-            type: "ai.initialize",
-            config: JSON.stringify(t)
-          };
-          window.parent.postMessage(r, "*");
-        } catch (r) {
-          console.warn("❌ [Aippy AI Config] Failed to send config to parent window:", r);
-        }
-    } catch (e) {
-      console.warn("⚠️ [Aippy AI Config] Failed to send config:", e);
-    }
-}
-function ue(t) {
-  const e = q(t);
-  return W(e), new Proxy({}, {
-    get(r, n) {
-      if (typeof n == "string")
-        try {
-          return z(e, n);
-        } catch {
-          return;
-        }
-    },
-    has(r, n) {
-      return typeof n != "string" ? !1 : n in e;
-    },
-    ownKeys(r) {
-      return Object.keys(e);
-    }
-  });
-}
-export {
-  M as D,
-  F as U,
-  re as a,
-  ne as b,
-  te as c,
-  N as d,
-  $ as e,
-  D as f,
-  se as g,
-  oe as h,
-  ae as i,
-  ie as j,
-  z as k,
-  q as l,
-  ue as m,
-  R as n,
-  ce as p,
-  C as r,
-  W as s,
-  S as v
-};