@chipmobilesdk/rn-ai 0.4.0 → 0.5.0

package/lib/commonjs/index.js

@@ -0,0 +1,102 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "AiError", {
+  enumerable: true,
+  get: function () {
+    return _errors.AiError;
+  }
+});
+Object.defineProperty(exports, "GATEWAY_ERROR_STATUS", {
+  enumerable: true,
+  get: function () {
+    return _gateway.GATEWAY_ERROR_STATUS;
+  }
+});
+Object.defineProperty(exports, "QUOTA_HEADERS", {
+  enumerable: true,
+  get: function () {
+    return _gateway.QUOTA_HEADERS;
+  }
+});
+Object.defineProperty(exports, "SSE_DONE_SENTINEL", {
+  enumerable: true,
+  get: function () {
+    return _gateway.SSE_DONE_SENTINEL;
+  }
+});
+Object.defineProperty(exports, "SUPPORTED_SCHEMA_VERSION", {
+  enumerable: true,
+  get: function () {
+    return _behaviorConfig.SUPPORTED_SCHEMA_VERSION;
+  }
+});
+Object.defineProperty(exports, "aiMessage", {
+  enumerable: true,
+  get: function () {
+    return _messageKeys.aiMessage;
+  }
+});
+Object.defineProperty(exports, "aiMessageSet", {
+  enumerable: true,
+  get: function () {
+    return _messageKeys.aiMessageSet;
+  }
+});
+Object.defineProperty(exports, "aiMessages", {
+  enumerable: true,
+  get: function () {
+    return _messageKeys.aiMessages;
+  }
+});
+Object.defineProperty(exports, "configCacheFromKeyValue", {
+  enumerable: true,
+  get: function () {
+    return _behaviorConfig.configCacheFromKeyValue;
+  }
+});
+Object.defineProperty(exports, "createAiClient", {
+  enumerable: true,
+  get: function () {
+    return _aiClient.createAiClient;
+  }
+});
+Object.defineProperty(exports, "isAiError", {
+  enumerable: true,
+  get: function () {
+    return _errors.isAiError;
+  }
+});
+Object.defineProperty(exports, "messageKeyForError", {
+  enumerable: true,
+  get: function () {
+    return _messageKeys.messageKeyForError;
+  }
+});
+Object.defineProperty(exports, "useAiBehaviorState", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useAiBehaviorState;
+  }
+});
+Object.defineProperty(exports, "useAiChat", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useAiChat;
+  }
+});
+Object.defineProperty(exports, "useAiQuota", {
+  enumerable: true,
+  get: function () {
+    return _hooks.useAiQuota;
+  }
+});
+var _aiClient = require("./core/aiClient.js");
+var _behaviorConfig = require("./config/behaviorConfig.js");
+var _gateway = require("./contract/gateway.js");
+var _hooks = require("./react/hooks.js");
+var _errors = require("./diagnostics/errors.js");
+var _messageKeys = require("./diagnostics/messageKeys.js");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_aiClient","require","_behaviorConfig","_gateway","_hooks","_errors","_messageKeys"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,IAAAA,SAAA,GAAAC,OAAA;AAiBA,IAAAC,eAAA,GAAAD,OAAA;AAaA,IAAAE,QAAA,GAAAF,OAAA;AAUA,IAAAG,MAAA,GAAAH,OAAA;AAQA,IAAAI,OAAA,GAAAJ,OAAA;AAEA,IAAAK,YAAA,GAAAL,OAAA","ignoreList":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/commonjs/react/hooks.js

@@ -0,0 +1,170 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useAiBehaviorState = useAiBehaviorState;
+exports.useAiChat = useAiChat;
+exports.useAiQuota = useAiQuota;
+var _react = require("@chipmobilesdk/rn-core/react");
+var _react2 = require("react");
+const DEFAULT_FLUSH_MS = 50;
+function useAiChat(client, options = {}) {
+  const [status, setStatus] = (0, _react2.useState)('idle');
+  const [text, setText] = (0, _react2.useState)('');
+  const [error, setError] = (0, _react2.useState)();
+  const [retryAt, setRetryAt] = (0, _react2.useState)();
+  const fromClient = useAiQuotaValue(client);
+  // The figure this chat was told, for a client of the app's own that keeps none.
+  const [reported, setReported] = (0, _react2.useState)();
+  const quota = fromClient ?? reported;
+  const handleRef = (0, _react2.useRef)(null);
+  // Bumped by every send, cancel and unmount. A callback from an older request
+  // is dropped, so it can never overwrite the state of the one on screen —
+  // defence in depth behind the client's own cancel guard.
+  const requestRef = (0, _react2.useRef)(0);
+
+  // Deltas land here and reach React on a timer, so the transcript renders at a
+  // steady rate however fast the model answers.
+  const pending = (0, _react2.useRef)('');
+  const flushTimer = (0, _react2.useRef)(undefined);
+  const flushMs = options.flushIntervalMs ?? DEFAULT_FLUSH_MS;
+  const stopFlushing = (0, _react2.useCallback)(() => {
+    if (flushTimer.current !== undefined) {
+      clearTimeout(flushTimer.current);
+      flushTimer.current = undefined;
+    }
+  }, []);
+  const flush = (0, _react2.useCallback)(() => {
+    flushTimer.current = undefined;
+    const buffered = pending.current;
+    if (buffered === '') {
+      return;
+    }
+    pending.current = '';
+    setText(previous => previous + buffered);
+  }, []);
+  (0, _react2.useEffect)(() => stopFlushing, [stopFlushing]);
+  const send = (0, _react2.useCallback)(request => {
+    handleRef.current?.cancel();
+    const id = ++requestRef.current;
+    const current = () => requestRef.current === id;
+    stopFlushing();
+    pending.current = '';
+    setText('');
+    setError(undefined);
+    setRetryAt(undefined);
+    setStatus('loading');
+    handleRef.current = client.chat(request, {
+      onDelta: delta => {
+        if (!current()) return;
+        pending.current += delta;
+        if (flushMs <= 0) {
+          flush();
+        } else if (flushTimer.current === undefined) {
+          flushTimer.current = setTimeout(flush, flushMs);
+        }
+        // Only the first delta is a state change; the rest are text.
+        setStatus(previous => previous === 'streaming' ? previous : 'streaming');
+      },
+      onDone: result => {
+        if (!current()) return;
+        stopFlushing();
+        flush();
+        if (result.quota) setReported(result.quota);
+        setStatus('done');
+      },
+      onError: aiError => {
+        if (!current()) return;
+        stopFlushing();
+        // Whatever arrived before the failure is kept: a half-answer is
+        // still what the user was reading.
+        flush();
+        setError(aiError);
+        if (aiError.code === 'rate-limited') {
+          setStatus('rate-limited');
+          if (aiError.retryAfterSeconds !== undefined) {
+            setRetryAt(new Date(Date.now() + aiError.retryAfterSeconds * 1000));
+          }
+        } else {
+          setStatus('error');
+        }
+      }
+    });
+  }, [client, flush, flushMs, stopFlushing]);
+  const cancel = (0, _react2.useCallback)(() => {
+    requestRef.current += 1;
+    stopFlushing();
+    handleRef.current?.cancel();
+    setStatus('idle');
+  }, [stopFlushing]);
+  (0, _react2.useEffect)(() => () => {
+    requestRef.current += 1;
+    handleRef.current?.cancel();
+  }, []);
+  return {
+    send,
+    cancel,
+    status,
+    text,
+    error,
+    retryAt,
+    quota
+  };
+}
+const noSubscription = () => () => undefined;
+
+/**
+ * The quota the client last saw, from a chat's `done` event or from
+ * `getQuota()`. One source, so a figure on screen is not stale the moment a
+ * chat finishes (AI-13).
+ */
+function useAiQuotaValue(client) {
+  return (0, _react.useExternalStore)(client.subscribe ?? noSubscription, client.lastQuota ?? (() => undefined));
+}
+function useAiQuota(client) {
+  const fromClient = useAiQuotaValue(client);
+  // A client of the app's own may not keep the last quota; then this is it.
+  const [fetched, setFetched] = (0, _react2.useState)();
+  const quota = fromClient ?? fetched;
+  const [status, setStatus] = (0, _react2.useState)('loading');
+  const alive = (0, _react2.useRef)(true);
+  // Only the latest refresh may settle the state; an older, slower one that
+  // lands afterwards is stale.
+  const latest = (0, _react2.useRef)(0);
+  const refresh = (0, _react2.useCallback)(() => {
+    const id = ++latest.current;
+    const current = () => alive.current && latest.current === id;
+    setStatus('loading');
+    client.getQuota().then(snapshot => {
+      if (!current()) return;
+      setFetched(snapshot);
+      setStatus('ready');
+    }).catch(() => {
+      if (current()) setStatus('error');
+    });
+  }, [client]);
+  (0, _react2.useEffect)(() => {
+    alive.current = true;
+    refresh();
+    return () => {
+      alive.current = false;
+    };
+  }, [refresh]);
+
+  // A quota that arrived through a chat is an answer too: nothing is loading.
+  return {
+    quota,
+    status: status === 'loading' && quota ? 'ready' : status,
+    refresh
+  };
+}
+
+/**
+ * The client's behavior state (config source and whether AI is enabled), live:
+ * re-renders when the kill switch flips or the config state moves (AI-09).
+ */
+function useAiBehaviorState(client) {
+  return (0, _react.useExternalStore)(client.subscribe ?? noSubscription, client.getBehaviorState);
+}
+//# sourceMappingURL=hooks.js.map

package/lib/commonjs/react/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_react2","DEFAULT_FLUSH_MS","useAiChat","client","options","status","setStatus","useState","text","setText","error","setError","retryAt","setRetryAt","fromClient","useAiQuotaValue","reported","setReported","quota","handleRef","useRef","requestRef","pending","flushTimer","undefined","flushMs","flushIntervalMs","stopFlushing","useCallback","current","clearTimeout","flush","buffered","previous","useEffect","send","request","cancel","id","chat","onDelta","delta","setTimeout","onDone","result","onError","aiError","code","retryAfterSeconds","Date","now","noSubscription","useExternalStore","subscribe","lastQuota","useAiQuota","fetched","setFetched","alive","latest","refresh","getQuota","then","snapshot","catch","useAiBehaviorState","getBehaviorState"],"sourceRoot":"../../../src","sources":["react/hooks.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/transport/sseClient.js

@@ -0,0 +1,151 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.drainSseEvents = drainSseEvents;
+exports.requestSse = requestSse;
+/**
+ * Minimal SSE reader over XMLHttpRequest (research R2).
+ *
+ * React Native's fetch does not reliably expose ReadableStream on Hermes, so
+ * we use XHR incremental text delivery (readyState LOADING + onprogress) —
+ * the same mechanism community SSE libraries use — with zero dependencies.
+ * The gateway never compresses SSE responses (contract), which keeps
+ * incremental delivery intact on both platforms.
+ */
+
+/** What the response said besides its body. Absent for a failure with no response. */
+
+/**
+ * The transport port: how this package makes a streaming request.
+ *
+ * A published port rather than `typeof requestSse`, so the default reader's
+ * own signature is not part of the public API (AI-18): an app may inject its
+ * own transport, and this package may change how `requestSse` is written
+ * without that being a breaking change.
+ */
+
+/**
+ * Parse complete `data:` events out of `text` starting at `fromIndex`.
+ *
+ * Both line endings are accepted. A proxy that normalises to CRLF — an API
+ * gateway or a corporate middlebox — used to make every event invisible until
+ * the stream closed, because only `\n\n` counted as a separator (AI-22).
+ */
+function drainSseEvents(text, fromIndex, emit) {
+  let cursor = fromIndex;
+  for (;;) {
+    const separator = /\r\n\r\n|\n\n|\r\r/.exec(text.slice(cursor));
+    if (!separator) {
+      return cursor; // incomplete event stays buffered
+    }
+    const rawEvent = text.slice(cursor, cursor + separator.index);
+    cursor += separator.index + separator[0].length;
+    const dataLines = rawEvent.split(/\r\n|\n|\r/).filter(line => line.startsWith('data:')).map(line => line.slice(5).trimStart());
+    if (dataLines.length > 0) {
+      emit(dataLines.join('\n'));
+    }
+  }
+}
+function requestSse(request, handlers) {
+  const xhr = new XMLHttpRequest();
+  let seen = 0;
+  let finished = false;
+  let cancelled = false;
+
+  // One timer, re-armed as the request progresses: the connect limit until
+  // headers arrive, then the idle limit, restarted by every chunk.
+  let stallTimer;
+  const disarm = () => {
+    if (stallTimer !== undefined) {
+      clearTimeout(stallTimer);
+      stallTimer = undefined;
+    }
+  };
+
+  /** The response's own headers, for `Retry-After` on a 429 (AI-11). */
+  const response = {
+    getHeader(name) {
+      try {
+        return xhr.getResponseHeader(name);
+      } catch {
+        // Headers are unavailable before they arrive, and on some polyfills.
+        return null;
+      }
+    }
+  };
+  const finish = fn => {
+    disarm();
+    if (!finished && !cancelled) {
+      finished = true;
+      fn();
+    }
+  };
+  const stalled = () => {
+    stallTimer = undefined;
+    if (finished || cancelled) return;
+    finished = true;
+    try {
+      xhr.abort();
+    } catch {
+      // already settled
+    }
+    handlers.onError(0, 'timeout');
+  };
+  const arm = ms => {
+    disarm();
+    if (ms && !finished && !cancelled) stallTimer = setTimeout(stalled, ms);
+  };
+
+  /**
+   * Drains whatever has arrived. `onprogress` and `readyState === 3` both fire
+   * for the same chunk, and which of the two fires at all has been platform
+   * dependent, so both stay registered; the length check makes the second call
+   * for one chunk free rather than another full `responseText` drain (AI-V1).
+   */
+  let drained = -1;
+  const pump = () => {
+    if (xhr.status !== 200) return; // error path handled on load/error
+    const text = xhr.responseText ?? '';
+    if (text.length === drained) return;
+    drained = text.length;
+    arm(request.idleTimeoutMs);
+    seen = drainSseEvents(text, seen, handlers.onData);
+  };
+  xhr.open(request.method ?? 'POST', request.url, true);
+  for (const [k, v] of Object.entries(request.headers ?? {})) {
+    xhr.setRequestHeader(k, v);
+  }
+  xhr.setRequestHeader('Accept', 'text/event-stream');
+  if (request.timeoutMs) xhr.timeout = request.timeoutMs;
+  xhr.onprogress = pump;
+  xhr.onreadystatechange = () => {
+    if (xhr.readyState === 2) arm(request.connectTimeoutMs); // HEADERS_RECEIVED
+    if (xhr.readyState === 3) pump(); // LOADING: incremental text
+  };
+  xhr.onload = () => {
+    if (xhr.status === 200) {
+      pump();
+      finish(handlers.onEnd);
+    } else {
+      finish(() => handlers.onError(xhr.status, xhr.responseText ?? '', response));
+    }
+  };
+  xhr.onerror = () => finish(() => handlers.onError(0, 'network error'));
+  xhr.ontimeout = () => finish(() => handlers.onError(0, 'timeout'));
+  xhr.send(request.body);
+  arm(request.connectTimeoutMs);
+  return {
+    cancel() {
+      cancelled = true;
+      disarm();
+      try {
+        xhr.abort();
+      } catch {
+        // aborting a settled XHR is a no-op
+      }
+    }
+  };
+}
+//# sourceMappingURL=sseClient.js.map

package/lib/commonjs/transport/sseClient.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["drainSseEvents","text","fromIndex","emit","cursor","separator","exec","slice","rawEvent","index","length","dataLines","split","filter","line","startsWith","map","trimStart","join","requestSse","request","handlers","xhr","XMLHttpRequest","seen","finished","cancelled","stallTimer","disarm","undefined","clearTimeout","response","getHeader","name","getResponseHeader","finish","fn","stalled","abort","onError","arm","ms","setTimeout","drained","pump","status","responseText","idleTimeoutMs","onData","open","method","url","k","v","Object","entries","headers","setRequestHeader","timeoutMs","timeout","onprogress","onreadystatechange","readyState","connectTimeoutMs","onload","onEnd","onerror","ontimeout","send","body","cancel"],"sourceRoot":"../../../src","sources":["transport/sseClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/transport/timeouts.js

@@ -0,0 +1,46 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.DEFAULT_AI_TIMEOUTS = void 0;
+exports.withTimeout = withTimeout;
+/**
+ * Time limits for every network call the client makes (AI-04).
+ *
+ * Without them a stalled mobile connection left `useAiChat` in `loading` or
+ * `streaming`, and `useAiQuota` in `loading`, until the user gave up.
+ */
+
+/**
+ * The gateway sends headers only once the model has answered, so `connectMs`
+ * also covers time to first token on a large image prompt.
+ */
+const DEFAULT_AI_TIMEOUTS = exports.DEFAULT_AI_TIMEOUTS = {
+  connectMs: 30_000,
+  idleMs: 30_000,
+  configMs: 10_000,
+  quotaMs: 10_000
+};
+
+/**
+ * Runs `run` with an abort signal and rejects with `onTimeout()` after `ms`.
+ * The race matters as much as the signal: an injected `fetchFn` (or an old
+ * polyfill) may ignore the signal entirely.
+ */
+async function withTimeout(ms, run, onTimeout) {
+  const controller = typeof AbortController === 'undefined' ? undefined : new AbortController();
+  let timer;
+  const expired = new Promise((_, reject) => {
+    timer = setTimeout(() => {
+      controller?.abort();
+      reject(onTimeout());
+    }, ms);
+  });
+  try {
+    return await Promise.race([run(controller?.signal), expired]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+//# sourceMappingURL=timeouts.js.map

package/lib/commonjs/transport/timeouts.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_AI_TIMEOUTS","exports","connectMs","idleMs","configMs","quotaMs","withTimeout","ms","run","onTimeout","controller","AbortController","undefined","timer","expired","Promise","_","reject","setTimeout","abort","race","signal","clearTimeout"],"sourceRoot":"../../../src","sources":["transport/timeouts.ts"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;AACA;AACO,MAAMA,mBAA+B,GAAAC,OAAA,CAAAD,mBAAA,GAAG;EAC9CE,SAAS,EAAE,MAAM;EACjBC,MAAM,EAAE,MAAM;EACdC,QAAQ,EAAE,MAAM;EAChBC,OAAO,EAAE;AACV,CAAC;;AAED;AACA;AACA;AACA;AACA;AACO,eAAeC,WAAWA,CAChCC,EAAU,EACVC,GAAoD,EACpDC,SAAsB,EACT;EACb,MAAMC,UAAU,GAAG,OAAOC,eAAe,KAAK,WAAW,GAAGC,SAAS,GAAG,IAAID,eAAe,CAAC,CAAC;EAC7F,IAAIE,KAAgD;EACpD,MAAMC,OAAO,GAAG,IAAIC,OAAO,CAAQ,CAACC,CAAC,EAAEC,MAAM,KAAK;IACjDJ,KAAK,GAAGK,UAAU,CAAC,MAAM;MACxBR,UAAU,EAAES,KAAK,CAAC,CAAC;MACnBF,MAAM,CAACR,SAAS,CAAC,CAAC,CAAC;IACpB,CAAC,EAAEF,EAAE,CAAC;EACP,CAAC,CAAC;EACF,IAAI;IACH,OAAO,MAAMQ,OAAO,CAACK,IAAI,CAAC,CAACZ,GAAG,CAACE,UAAU,EAAEW,MAAM,CAAC,EAAEP,OAAO,CAAC,CAAC;EAC9D,CAAC,SAAS;IACTQ,YAAY,CAACT,KAAK,CAAC;EACpB;AACD","ignoreList":[]}