@chipmobilesdk/rn-ai 0.3.0 → 0.5.0

package/lib/commonjs/contract/gateway.js

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SSE_DONE_SENTINEL = exports.RETRY_AFTER_HEADER = exports.QUOTA_HEADERS = exports.GATEWAY_ERROR_STATUS = void 0;
+/**
+ * The gateway↔client contract: error codes, quota headers, stream events.
+ *
+ * One definition, imported by both sides (GW-13). The gateway's own codes and
+ * the client's map of them were two hand-maintained lists, and they had already
+ * drifted: `BAD_REQUEST`, `ENDPOINT_RETIRED` and `INTERNAL` existed on the
+ * server and were unknown to the client, which fell back to a guess from the
+ * status. Adding a code now fails to compile on whichever side has not handled
+ * it.
+ *
+ * Types and plain constants only, and no import of anything: the gateway runs
+ * on Node and imports this file for its types alone.
+ */
+
+/** Every error the gateway answers with (`error.code` in the body). */
+
+/** The HTTP status each code is sent with. */
+const GATEWAY_ERROR_STATUS = exports.GATEWAY_ERROR_STATUS = {
+  BAD_REQUEST: 400,
+  AUTH_INVALID: 401,
+  NOT_ENTITLED: 403,
+  USER_BLOCKED: 403,
+  APP_UNKNOWN: 404,
+  ENDPOINT_RETIRED: 410,
+  PAYLOAD_TOO_LARGE: 413,
+  MODALITY_NOT_ALLOWED: 415,
+  RATE_LIMITED: 429,
+  UPSTREAM_BUSY: 429,
+  UPSTREAM_ERROR: 500,
+  INTERNAL: 500
+};
+
+/** The error body. `message` is safe to log; it never carries upstream detail. */
+
+/** The quota headers, by name. A rename here breaks both sides' compile. */
+const QUOTA_HEADERS = exports.QUOTA_HEADERS = {
+  minuteRemaining: 'X-Quota-Minute-Remaining',
+  dayRemaining: 'X-Quota-Day-Remaining',
+  dayTokensRemaining: 'X-Quota-Day-Tokens-Remaining'
+};
+
+/** The names field by field, so a side declaring its own literals is checked exactly. */
+
+/** What is left of an app's allowance, as the gateway reports it. */
+
+/** What one answer cost. */
+
+/** The `data:` payloads of a chat stream, before the `[DONE]` sentinel. */
+
+/** The last `data:` line of a stream that completed. */
+const SSE_DONE_SENTINEL = exports.SSE_DONE_SENTINEL = '[DONE]';
+/** The `Retry-After` header, which a 429 always carries. */
+const RETRY_AFTER_HEADER = exports.RETRY_AFTER_HEADER = 'Retry-After';
+//# sourceMappingURL=gateway.js.map

package/lib/commonjs/contract/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["GATEWAY_ERROR_STATUS","exports","BAD_REQUEST","AUTH_INVALID","NOT_ENTITLED","USER_BLOCKED","APP_UNKNOWN","ENDPOINT_RETIRED","PAYLOAD_TOO_LARGE","MODALITY_NOT_ALLOWED","RATE_LIMITED","UPSTREAM_BUSY","UPSTREAM_ERROR","INTERNAL","QUOTA_HEADERS","minuteRemaining","dayRemaining","dayTokensRemaining","SSE_DONE_SENTINEL","RETRY_AFTER_HEADER"],"sourceRoot":"../../../src","sources":["contract/gateway.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAeA;AACO,MAAMA,oBAAgE,GAAAC,OAAA,CAAAD,oBAAA,GAAG;EAC/EE,WAAW,EAAE,GAAG;EAChBC,YAAY,EAAE,GAAG;EACjBC,YAAY,EAAE,GAAG;EACjBC,YAAY,EAAE,GAAG;EACjBC,WAAW,EAAE,GAAG;EAChBC,gBAAgB,EAAE,GAAG;EACrBC,iBAAiB,EAAE,GAAG;EACtBC,oBAAoB,EAAE,GAAG;EACzBC,YAAY,EAAE,GAAG;EACjBC,aAAa,EAAE,GAAG;EAClBC,cAAc,EAAE,GAAG;EACnBC,QAAQ,EAAE;AACX,CAAC;;AAED;;AASA;AACO,MAAMC,aAAa,GAAAb,OAAA,CAAAa,aAAA,GAAG;EAC5BC,eAAe,EAAE,0BAA0B;EAC3CC,YAAY,EAAE,uBAAuB;EACrCC,kBAAkB,EAAE;AACrB,CAAU;;AAEV;;AAIA;;AAOA;;AAOA;;AAMA;AACO,MAAMC,iBAAiB,GAAAjB,OAAA,CAAAiB,iBAAA,GAAG,QAAQ;AAGzC;AACO,MAAMC,kBAAkB,GAAAlB,OAAA,CAAAkB,kBAAA,GAAG,aAAa","ignoreList":[]}

package/lib/commonjs/core/aiClient.js

@@ -0,0 +1,330 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createAiClient = createAiClient;
+var _rnCore = require("@chipmobilesdk/rn-core");
+var _behaviorConfig = require("../config/behaviorConfig.js");
+var _gateway = require("../contract/gateway.js");
+var _errors = require("../diagnostics/errors.js");
+var _sseClient = require("../transport/sseClient.js");
+var _quotaRequest = require("./quotaRequest.js");
+var _timeouts = require("../transport/timeouts.js");
+/** Every failure a caller receives also goes to the app's SDK sinks (CORE-08). */
+const channel = (0, _rnCore.createDiagnosticChannel)('rn-ai');
+function report(operation, error) {
+  channel.emit(error.code, error.retryable ? 'warn' : 'error', {
+    operation,
+    retryable: error.retryable
+  });
+}
+
+/** Minimal slice of the rn-auth `Auth` controller the client needs. */
+
+/** What one answer cost, as the gateway reports it. */
+
+/** What is left of the app's allowance. */
+
+/** Ceiling on one remote-configured backoff step, so a bad document cannot stall a chat. */
+const MAX_RETRY_BACKOFF_MS = 30_000;
+
+/** The wait before silent retry `index` (0-based); the last configured step repeats. */
+function backoffBefore(steps, index) {
+  const step = steps[Math.min(index, steps.length - 1)] ?? 0;
+  return Math.min(Math.max(0, step), MAX_RETRY_BACKOFF_MS);
+}
+/** A quota from the wire, or nothing: a malformed one is not displayed (AI-13). */
+function asQuota(value) {
+  if (typeof value !== 'object' || value === null) {
+    return undefined;
+  }
+  const candidate = value;
+  const fields = [candidate.minuteRemaining, candidate.dayRemaining, candidate.dayTokensRemaining];
+  if (!fields.every(field => typeof field === 'number' && Number.isFinite(field))) {
+    return undefined;
+  }
+  return {
+    minuteRemaining: candidate.minuteRemaining,
+    dayRemaining: candidate.dayRemaining,
+    dayTokensRemaining: candidate.dayTokensRemaining
+  };
+}
+function createAiClient(clientConfig) {
+  const resourceKey = clientConfig.resourceKey ?? 'ai-gateway';
+  const transport = clientConfig.transport ?? _sseClient.requestSse;
+  const fetchFn = clientConfig.fetchFn ?? fetch;
+  const timeouts = {
+    ..._timeouts.DEFAULT_AI_TIMEOUTS,
+    ...clientConfig.timeouts
+  };
+  const scheduler = clientConfig.scheduler ?? _rnCore.realScheduler;
+  const configManager = new _behaviorConfig.BehaviorConfigManager({
+    configUrl: clientConfig.configUrl,
+    appId: clientConfig.appId,
+    cache: clientConfig.storage,
+    fetchFn: clientConfig.fetchFn,
+    timeoutMs: timeouts.configMs,
+    ...(clientConfig.allowedHosts ? {
+      allowedHosts: clientConfig.allowedHosts
+    } : {})
+  });
+  let lastConfig;
+  const behaviorListeners = (0, _rnCore.createListenerSet)();
+  let snapshot;
+  let quota;
+
+  /** Rebuilt only when a field changes, so useSyncExternalStore sees a stable object. */
+  function behaviorState() {
+    const config = configManager.state;
+    const aiEnabled = lastConfig?.features.aiEnabled ?? true;
+    if (!snapshot || snapshot.config !== config || snapshot.aiEnabled !== aiEnabled) {
+      snapshot = {
+        config,
+        aiEnabled
+      };
+    }
+    return snapshot;
+  }
+  function setLastConfig(next) {
+    const wasEnabled = lastConfig?.features.aiEnabled ?? true;
+    lastConfig = next;
+    if (next.features.aiEnabled !== wasEnabled) behaviorListeners.notify();
+  }
+
+  /** One place records the quota, whichever call learned it (AI-13). */
+  function setQuota(next) {
+    if (!next || quota && shallowSameQuota(quota, next)) {
+      return;
+    }
+    quota = next;
+    behaviorListeners.notify();
+  }
+  async function acquire(options = {}) {
+    const config = await configManager.getConfig();
+    setLastConfig(config);
+    if (!config.features.aiEnabled) {
+      throw new _errors.AiError('config-unavailable', 'AI is disabled for this app', {
+        recoverable: false
+      });
+    }
+    const tokenResult = await clientConfig.auth.requestAccessToken(resourceKey, {
+      forceRefresh: options.forceRefresh === true
+    });
+    if (tokenResult.status !== 'success' || !tokenResult.token) {
+      // What the auth layer called it, kept as the cause: a screen has to tell
+      // "sign in again" from "you are offline" (AI-11).
+      throw tokenError(tokenResult.status, tokenResult.errorCode);
+    }
+    return {
+      config,
+      token: tokenResult.token
+    };
+  }
+  const endpoint = (config, path) => `${config.api.baseUrl}/api/v1/apps/${clientConfig.appId}/${path}`;
+  function chat(request, handlers) {
+    let cancelled = false;
+    let settled = false;
+    let inner;
+
+    // Every callback to the app goes through here. Nothing is delivered after
+    // cancel() — an acquire() or config reload that failed after the user
+    // cancelled (or sent the next message) used to flip that screen to
+    // `error` — and exactly one terminal callback is delivered.
+    const emit = {
+      delta(text) {
+        if (!cancelled && !settled) handlers.onDelta(text);
+      },
+      done(result) {
+        if (cancelled || settled) return;
+        settled = true;
+        setQuota(result.quota);
+        handlers.onDone(result);
+      },
+      error(error) {
+        if (cancelled || settled) return;
+        settled = true;
+        inner?.cancel();
+        report('chat', error);
+        handlers.onError(error);
+      }
+    };
+
+    // Any exception on the way becomes a reported error. Each path used to end
+    // in `.catch(() => undefined)`, so a transport that threw (a bad URL from
+    // remote config, say) left the UI in `loading` with nothing to show.
+    const fail = e => emit.error(e instanceof _errors.AiError ? e : new _errors.AiError('internal', e instanceof Error ? e.message : String(e)));
+    const guarded = fn => (...args) => {
+      try {
+        fn(...args);
+      } catch (e) {
+        fail(e);
+      }
+    };
+    const attempt = async state => {
+      const {
+        config,
+        token
+      } = await acquire({
+        forceRefresh: state.authRetries > 0
+      });
+      if (cancelled) return;
+      let done;
+      let streamErrorCode;
+      inner = transport({
+        url: endpoint(config, 'chat'),
+        method: 'POST',
+        headers: {
+          Authorization: `Bearer ${token}`,
+          'Content-Type': 'application/json'
+        },
+        body: JSON.stringify(request),
+        connectTimeoutMs: timeouts.connectMs,
+        idleTimeoutMs: timeouts.idleMs
+      }, {
+        onData: guarded(payload => {
+          if (payload === _gateway.SSE_DONE_SENTINEL) return;
+          let event;
+          try {
+            event = JSON.parse(payload);
+          } catch {
+            return;
+          }
+          if (event.type === 'delta' && typeof event.text === 'string') {
+            emit.delta(event.text);
+          } else if (event.type === 'done' && event.usage) {
+            done = {
+              usage: event.usage,
+              quota: asQuota(event.quota)
+            };
+          } else if (event.type === 'error') {
+            streamErrorCode = event.code ?? 'UPSTREAM_ERROR';
+          }
+        }),
+        onEnd: guarded(() => {
+          if (streamErrorCode) {
+            emit.error(new _errors.AiError('upstream-error', 'the AI service failed mid-response', {
+              cause: streamErrorCode
+            }));
+          } else if (done) {
+            emit.done(done);
+          } else {
+            // Headers said 200 and the body stopped short: the connection
+            // dropped mid-answer, which is a network failure, not a fault
+            // of the service.
+            emit.error(new _errors.AiError('network', 'the stream ended before it completed'));
+          }
+        }),
+        onError: guarded((status, bodyText, response) => {
+          if (cancelled) return;
+          recover(status, bodyText, state, {
+            ...(response ? {
+              getHeader: name => response.getHeader(name)
+            } : {})
+          }, next => attempt(next).catch(fail), fail, emit.error);
+        })
+      });
+    };
+    attempt({
+      configReloads: 0,
+      authRetries: 0
+    }).catch(fail);
+    return {
+      cancel() {
+        cancelled = true;
+        inner?.cancel();
+      }
+    };
+  }
+
+  /**
+   * The two recoveries the contract promises, in one place so chat and quota
+   * cannot drift (AI-13): a designated status reloads the configuration and
+   * retries after the configured backoff, and a 401 retries once with a token
+   * the provider had to fetch again.
+   */
+  function recover(status, bodyText, state, context, retry, onFailure, onGiveUp) {
+    const config = lastConfig;
+    if (config && config.recovery.reloadOnHttpStatus.includes(status) && state.configReloads < config.recovery.maxSilentRetries) {
+      // Waits `recovery.retryBackoffMs` first (AI-05): a gateway mid-rollout
+      // that answered 410 a moment ago may well answer it again at once.
+      const retryAfter = backoffBefore(config.recovery.retryBackoffMs, state.configReloads);
+      configManager.getConfig({
+        forceReload: true
+      }).then(reloaded => {
+        setLastConfig(reloaded);
+        scheduler.setTimeout(() => retry({
+          ...state,
+          configReloads: state.configReloads + 1
+        }), retryAfter);
+      }, e => onFailure(e instanceof _errors.AiError ? e : new _errors.AiError('config-unavailable', String(e))));
+      return;
+    }
+    // Expired server-side session → one retry with a token the provider
+    // actually re-fetched.
+    if (status === 401 && state.authRetries < 1) {
+      retry({
+        ...state,
+        authRetries: state.authRetries + 1
+      });
+      return;
+    }
+    onGiveUp((0, _errors.errorFromHttp)(status, bodyText, context));
+  }
+  const {
+    getQuota
+  } = (0, _quotaRequest.createQuotaRequest)({
+    fetchFn,
+    timeouts,
+    acquire,
+    endpoint,
+    asQuota,
+    recover,
+    report: error => report('quota', error),
+    setQuota
+  });
+  return {
+    chat,
+    getQuota,
+    lastQuota: () => quota,
+    getBehaviorState: () => behaviorState(),
+    subscribe: listener => {
+      const fromManager = configManager.subscribe(listener);
+      const fromClient = behaviorListeners.add(listener);
+      return () => {
+        fromManager();
+        fromClient();
+      };
+    },
+    reloadConfig: async () => {
+      setLastConfig(await configManager.getConfig({
+        forceReload: true
+      }));
+    }
+  };
+}
+function shallowSameQuota(a, b) {
+  return a.minuteRemaining === b.minuteRemaining && a.dayRemaining === b.dayRemaining && a.dayTokensRemaining === b.dayTokensRemaining;
+}
+
+/**
+ * What the auth layer's refusal means for a chat. The code rn-auth gave is kept
+ * as the cause, and it decides the copy: "sign in again" and "you are offline"
+ * are different answers, and both used to arrive as `auth-invalid` (AI-11).
+ */
+function tokenError(status, errorCode) {
+  const cause = errorCode ? {
+    cause: errorCode
+  } : {};
+  switch (errorCode) {
+    case 'session-expired':
+      return new _errors.AiError('session-expired', 'the session ended; sign in again', cause);
+    case 'network-unavailable':
+      return new _errors.AiError('network', 'no connection to the identity provider', cause);
+    case 'consent-denied':
+      return new _errors.AiError('not-entitled', 'access to the AI resource was denied', cause);
+    default:
+      return new _errors.AiError('auth-invalid', status === 'denied' ? 'access to the AI resource was refused' : 'could not acquire an access token', cause);
+  }
+}
+//# sourceMappingURL=aiClient.js.map

package/lib/commonjs/core/aiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require","_behaviorConfig","_gateway","_errors","_sseClient","_quotaRequest","_timeouts","channel","createDiagnosticChannel","report","operation","error","emit","code","retryable","MAX_RETRY_BACKOFF_MS","backoffBefore","steps","index","step","Math","min","length","max","asQuota","value","undefined","candidate","fields","minuteRemaining","dayRemaining","dayTokensRemaining","every","field","Number","isFinite","createAiClient","clientConfig","resourceKey","transport","requestSse","fetchFn","fetch","timeouts","DEFAULT_AI_TIMEOUTS","scheduler","realScheduler","configManager","BehaviorConfigManager","configUrl","appId","cache","storage","timeoutMs","configMs","allowedHosts","lastConfig","behaviorListeners","createListenerSet","snapshot","quota","behaviorState","config","state","aiEnabled","features","setLastConfig","next","wasEnabled","notify","setQuota","shallowSameQuota","acquire","options","getConfig","AiError","recoverable","tokenResult","auth","requestAccessToken","forceRefresh","status","token","tokenError","errorCode","endpoint","path","api","baseUrl","chat","request","handlers","cancelled","settled","inner","delta","text","onDelta","done","result","onDone","cancel","onError","fail","e","Error","message","String","guarded","fn","args","attempt","authRetries","streamErrorCode","url","method","headers","Authorization","body","JSON","stringify","connectTimeoutMs","connectMs","idleTimeoutMs","idleMs","onData","payload","SSE_DONE_SENTINEL","event","parse","type","usage","onEnd","cause","bodyText","response","recover","getHeader","name","catch","configReloads","context","retry","onFailure","onGiveUp","recovery","reloadOnHttpStatus","includes","maxSilentRetries","retryAfter","retryBackoffMs","forceReload","then","reloaded","setTimeout","errorFromHttp","getQuota","createQuotaRequest","lastQuota","getBehaviorState","subscribe","listener","fromManager","fromClient","add","reloadConfig","a","b"],"sourceRoot":"../../../src","sources":["core/aiClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/core/quotaRequest.js

@@ -0,0 +1,105 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createQuotaRequest = createQuotaRequest;
+var _errors = require("../diagnostics/errors.js");
+var _timeouts = require("../transport/timeouts.js");
+/**
+ * The quota request, and the recovery it shares with a chat (AI-13).
+ *
+ * `getQuota` used to be the one call with no recovery at all: a gateway that
+ * had moved answered 404 for quota while chats silently re-routed, so the
+ * figure on screen failed while the feature worked. It now goes through the
+ * same `recover` the chat stream does — a designated status reloads the
+ * configuration and retries, a 401 retries once with a token the provider had
+ * to fetch again.
+ */
+
+/** Where the quota request is in its recovery, shared with the chat path. */
+
+/** What is left of the app's allowance. */
+
+function createQuotaRequest(deps) {
+  const {
+    fetchFn,
+    timeouts,
+    endpoint,
+    asQuota,
+    recover,
+    setQuota
+  } = deps;
+  const acquire = deps.acquire;
+  async function getQuota() {
+    try {
+      const snapshotValue = await fetchQuotaWithRecovery({
+        configReloads: 0,
+        authRetries: 0
+      });
+      setQuota(snapshotValue);
+      return snapshotValue;
+    } catch (error) {
+      if (error instanceof _errors.AiError) deps.report(error);
+      throw error;
+    }
+  }
+
+  /** Same recovery as a chat: a retired endpoint reloads the config and retries. */
+  function fetchQuotaWithRecovery(state) {
+    return new Promise((resolve, reject) => {
+      fetchQuota(state).then(resolve, error => {
+        if (!(error instanceof HttpFailure)) {
+          reject(error);
+          return;
+        }
+        recover(error.status, error.bodyText, state, {
+          getHeader: name => error.getHeader(name)
+        }, next => fetchQuotaWithRecovery(next).then(resolve, reject), reject, reject);
+      });
+    });
+  }
+
+  /** Carries the response so `recover` can decide; never reaches the caller. */
+  class HttpFailure extends Error {
+    constructor(status, bodyText, headers) {
+      super(`gateway responded ${status}`);
+      this.status = status;
+      this.bodyText = bodyText;
+      this.headers = headers;
+      this.name = 'HttpFailure';
+    }
+    getHeader(name) {
+      return this.headers?.get(name) ?? null;
+    }
+  }
+  async function fetchQuota(state) {
+    const {
+      config,
+      token
+    } = await acquire({
+      forceRefresh: state.authRetries > 0
+    });
+    return (0, _timeouts.withTimeout)(timeouts.quotaMs, async signal => {
+      const response = await fetchFn(endpoint(config, 'quota'), {
+        headers: {
+          Authorization: `Bearer ${token}`
+        },
+        signal
+      });
+      if (!response.ok) {
+        throw new HttpFailure(response.status, await response.text(), response.headers);
+      }
+      const parsed = asQuota(await response.json());
+      if (!parsed) {
+        // A body that is not the contract's: better no figure than a wrong one.
+        throw new _errors.AiError('internal', 'quota response did not match the contract');
+      }
+      return parsed;
+    }, () => new _errors.AiError('network', 'quota request timed out'));
+  }
+  return {
+    getQuota
+  };
+}
+//# sourceMappingURL=quotaRequest.js.map

package/lib/commonjs/core/quotaRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_errors","require","_timeouts","createQuotaRequest","deps","fetchFn","timeouts","endpoint","asQuota","recover","setQuota","acquire","getQuota","snapshotValue","fetchQuotaWithRecovery","configReloads","authRetries","error","AiError","report","state","Promise","resolve","reject","fetchQuota","then","HttpFailure","status","bodyText","getHeader","name","next","Error","constructor","headers","get","config","token","forceRefresh","withTimeout","quotaMs","signal","response","Authorization","ok","text","parsed","json"],"sourceRoot":"../../../src","sources":["core/quotaRequest.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/diagnostics/errors.js

@@ -0,0 +1,108 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.AiError = void 0;
+exports.errorFromHttp = errorFromHttp;
+exports.isAiError = isAiError;
+exports.parseRetryAfter = parseRetryAfter;
+var _rnCore = require("@chipmobilesdk/rn-core");
+var _gateway = require("../contract/gateway.js");
+/** Typed client errors (contracts/rn-ai-public-api.md). */
+
+/** Codes a retry can fix on its own. */
+const RETRYABLE_BY_DEFAULT = new Set(['rate-limited', 'upstream-busy', 'network']);
+
+/** The package's error; an `SdkError` (`@chipmobilesdk/rn-core`) with `pkg: 'rn-ai'`. */
+class AiError extends _rnCore.SdkError {
+  /** The underlying code, when one layer down had a name for the failure. */
+
+  constructor(code, message, options = {}) {
+    super('rn-ai', code, {
+      message,
+      retryable: options.retryable ?? options.recoverable ?? RETRYABLE_BY_DEFAULT.has(code)
+    });
+    this.name = 'AiError';
+    this.retryAfterSeconds = options.retryAfterSeconds;
+    this.cause = options.cause;
+  }
+
+  /** @deprecated Use `retryable`, the name every SDK package shares. */
+  get recoverable() {
+    return this.retryable;
+  }
+}
+exports.AiError = AiError;
+function isAiError(value) {
+  return value instanceof AiError;
+}
+
+/**
+ * Every gateway code, mapped. Typed as a total record, so a code added to the
+ * shared contract does not compile until the client says what it means (GW-13).
+ */
+const HTTP_CODE_MAP = {
+  BAD_REQUEST: 'internal',
+  AUTH_INVALID: 'auth-invalid',
+  NOT_ENTITLED: 'not-entitled',
+  USER_BLOCKED: 'user-blocked',
+  APP_UNKNOWN: 'app-unknown',
+  // The endpoint moved: the client's configuration is the stale part.
+  ENDPOINT_RETIRED: 'config-unavailable',
+  PAYLOAD_TOO_LARGE: 'payload-too-large',
+  MODALITY_NOT_ALLOWED: 'modality-not-allowed',
+  RATE_LIMITED: 'rate-limited',
+  UPSTREAM_BUSY: 'upstream-busy',
+  UPSTREAM_ERROR: 'upstream-error',
+  INTERNAL: 'internal'
+};
+function isGatewayCode(value) {
+  return typeof value === 'string' && value in HTTP_CODE_MAP;
+}
+
+/** `Retry-After` in seconds, from either form the header may take. */
+function parseRetryAfter(value) {
+  if (!value) {
+    return undefined;
+  }
+  const seconds = Number(value);
+  if (Number.isFinite(seconds) && seconds >= 0) {
+    return seconds;
+  }
+  const date = Date.parse(value);
+  if (Number.isFinite(date)) {
+    return Math.max(0, Math.round((date - Date.now()) / 1000));
+  }
+  return undefined;
+}
+/** Map a gateway error response (status + JSON body) to a typed AiError. */
+function errorFromHttp(status, bodyText, context = {}) {
+  // Status 0 is not an answer at all: the request never arrived, or the
+  // connection dropped. That is a network failure a retry may well fix, not an
+  // upstream fault (AI-11).
+  if (status === 0) {
+    return new AiError('network', bodyText === 'timeout' ? 'the request timed out' : 'no connection');
+  }
+  let code = status >= 500 ? 'upstream-error' : 'internal';
+  let message = `gateway responded ${status}`;
+  let gatewayCode;
+  let retryAfterSeconds = parseRetryAfter(context.getHeader?.(_gateway.RETRY_AFTER_HEADER));
+  try {
+    const parsed = JSON.parse(bodyText);
+    if (isGatewayCode(parsed.error?.code)) {
+      gatewayCode = parsed.error.code;
+      code = HTTP_CODE_MAP[gatewayCode];
+    }
+    // The gateway's text can quote upstream detail; keep it readable but shaped.
+    if (parsed.error?.message) message = (0, _rnCore.redactPatterns)(parsed.error.message);
+    retryAfterSeconds = parsed.error?.retryAfterSeconds ?? retryAfterSeconds;
+  } catch {
+    // A body that is not the contract's: the status is all there is to go on.
+  }
+  return new AiError(code, message, {
+    retryAfterSeconds,
+    cause: gatewayCode
+  });
+}
+//# sourceMappingURL=errors.js.map

package/lib/commonjs/diagnostics/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_rnCore","require","_gateway","RETRYABLE_BY_DEFAULT","Set","AiError","SdkError","constructor","code","message","options","retryable","recoverable","has","name","retryAfterSeconds","cause","exports","isAiError","value","HTTP_CODE_MAP","BAD_REQUEST","AUTH_INVALID","NOT_ENTITLED","USER_BLOCKED","APP_UNKNOWN","ENDPOINT_RETIRED","PAYLOAD_TOO_LARGE","MODALITY_NOT_ALLOWED","RATE_LIMITED","UPSTREAM_BUSY","UPSTREAM_ERROR","INTERNAL","isGatewayCode","parseRetryAfter","undefined","seconds","Number","isFinite","date","Date","parse","Math","max","round","now","errorFromHttp","status","bodyText","context","gatewayCode","getHeader","RETRY_AFTER_HEADER","parsed","JSON","error","redactPatterns"],"sourceRoot":"../../../src","sources":["diagnostics/errors.ts"],"mappings":"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","ignoreList":[]}