@athenaintel/react 0.57.1 → 0.59.0

package/dist/data/athena-api-error.js

@@ -0,0 +1,125 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var _a, _b;
+const AthenaApiErrorKind = {
+  /** Agora answered with an error status (4xx or 5xx). */
+  Http: "http",
+  /** Agora answered a GraphQL operation with errors (a refused read, an invalid query), or with no data. */
+  GraphQL: "graphql",
+  /** No answer came: offline, a refused CORS preflight, a dropped connection. */
+  Network: "network",
+  /** No answer came within the request's `timeoutMs`, so the SDK abandoned it. */
+  Timeout: "timeout",
+  /** The provider could not resolve a credential: its `getToken` threw. */
+  Credential: "credential",
+  /** The answer could not be read: not the JSON it said it was, or cut off. */
+  Response: "response",
+  /** The SDK refused to send the request (the message says why). */
+  Request: "request"
+};
+const ATHENA_API_ERROR = Symbol.for("athena-sdk.AthenaApiError");
+class AthenaApiError extends (_b = Error, _a = ATHENA_API_ERROR, _b) {
+  constructor(options) {
+    super(options.message, options.cause === void 0 ? void 0 : { cause: options.cause });
+    __publicField(this, _a, true);
+    __publicField(this, "kind");
+    /**
+     * The HTTP status agora answered with: a GraphQL error answered with 200 says
+     * 200. `0` when no answer came (`network`, `timeout`, `credential`,
+     * `request`).
+     */
+    __publicField(this, "status");
+    /**
+     * Agora's machine-readable code: the first GraphQL error's
+     * `extensions.code`, or a REST error's `detail.code`. `null` when it gave
+     * none.
+     */
+    __publicField(this, "code");
+    /** Every GraphQL error of the answer; empty for other failures. */
+    __publicField(this, "errors");
+    /** A REST error's `detail` (FastAPI's envelope), else its body as read; `undefined` when there was none. */
+    __publicField(this, "detail");
+    /**
+     * How long agora asked the caller to wait before trying again (`Retry-After`,
+     * or the `retryAfterSeconds` of a rate-limit refusal), in ms; `null` when it
+     * did not say.
+     */
+    __publicField(this, "retryAfterMs");
+    /** The request's method. */
+    __publicField(this, "method");
+    /** The request's path, without its query string. */
+    __publicField(this, "path");
+    this.name = "AthenaApiError";
+    this.kind = options.kind;
+    this.status = options.status ?? 0;
+    this.code = options.code ?? null;
+    this.errors = options.errors ?? [];
+    this.detail = options.detail;
+    this.retryAfterMs = options.retryAfterMs ?? null;
+    this.method = options.method;
+    this.path = options.path;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      kind: this.kind,
+      status: this.status,
+      code: this.code,
+      message: this.message,
+      errors: this.errors,
+      detail: this.detail,
+      retryAfterMs: this.retryAfterMs,
+      method: this.method,
+      path: this.path
+    };
+  }
+}
+function isAthenaApiError(value) {
+  return value instanceof AthenaApiError || typeof value === "object" && value !== null && Reflect.get(value, ATHENA_API_ERROR) === true;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function graphQLErrorEntries(body) {
+  const errors = isRecord(body) ? body.errors : void 0;
+  if (!Array.isArray(errors)) return [];
+  return errors.flatMap((entry) => {
+    if (!isRecord(entry) || typeof entry.message !== "string") return [];
+    const path = Array.isArray(entry.path) ? entry.path.filter((part) => typeof part === "string" || typeof part === "number") : void 0;
+    return [
+      {
+        message: entry.message,
+        ...path ? { path } : {},
+        ...isRecord(entry.extensions) ? { extensions: entry.extensions } : {}
+      }
+    ];
+  });
+}
+function graphQLErrorCode(entry) {
+  var _a2;
+  const code = (_a2 = entry == null ? void 0 : entry.extensions) == null ? void 0 : _a2.code;
+  return typeof code === "string" ? code : null;
+}
+function restErrorDetail(body) {
+  const detail = isRecord(body) && "detail" in body ? body.detail : body;
+  if (typeof detail === "string") {
+    return { detail, code: null, message: detail || null, retryAfterSeconds: null };
+  }
+  if (!isRecord(detail)) return { detail, code: null, message: null, retryAfterSeconds: null };
+  return {
+    detail,
+    code: typeof detail.code === "string" ? detail.code : null,
+    message: typeof detail.message === "string" ? detail.message : null,
+    retryAfterSeconds: typeof detail.retryAfterSeconds === "number" && Number.isFinite(detail.retryAfterSeconds) ? detail.retryAfterSeconds : null
+  };
+}
+export {
+  AthenaApiError,
+  AthenaApiErrorKind,
+  graphQLErrorCode,
+  graphQLErrorEntries,
+  isAthenaApiError,
+  restErrorDetail
+};
+//# sourceMappingURL=athena-api-error.js.map

package/dist/data/athena-api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"athena-api-error.js","sources":["../../src/data/athena-api-error.ts"],"sourcesContent":["/**\n * What the SDK's data layer throws (`useAthenaFetch`, `useAthenaGraphQL`,\n * `useAthenaGraphQLMutation`, `useAthenaRest`, `useSemanticQuery`): one typed\n * error that says how a request failed (`kind`), with the HTTP status, agora's\n * machine-readable code and its message. A request its caller cancelled is the\n * one exception: it rejects with the abort's own reason, as `fetch` does.\n */\n\n/** How a request failed. */\nexport const AthenaApiErrorKind = {\n  /** Agora answered with an error status (4xx or 5xx). */\n  Http: 'http',\n  /** Agora answered a GraphQL operation with errors (a refused read, an invalid query), or with no data. */\n  GraphQL: 'graphql',\n  /** No answer came: offline, a refused CORS preflight, a dropped connection. */\n  Network: 'network',\n  /** No answer came within the request's `timeoutMs`, so the SDK abandoned it. */\n  Timeout: 'timeout',\n  /** The provider could not resolve a credential: its `getToken` threw. */\n  Credential: 'credential',\n  /** The answer could not be read: not the JSON it said it was, or cut off. */\n  Response: 'response',\n  /** The SDK refused to send the request (the message says why). */\n  Request: 'request',\n} as const;\nexport type AthenaApiErrorKind = (typeof AthenaApiErrorKind)[keyof typeof AthenaApiErrorKind];\n\n/** One entry of a GraphQL answer's `errors`. */\nexport interface AthenaGraphQLErrorEntry {\n  message: string;\n  path?: readonly (string | number)[];\n  /** Agora puts its `code` here (`UNAUTHORIZED`, `BAD_USER_INPUT`, `RATE_LIMITED`…). */\n  extensions?: Readonly<Record<string, unknown>>;\n}\n\nexport interface AthenaApiErrorOptions {\n  kind: AthenaApiErrorKind;\n  message: string;\n  /** The HTTP status agora answered with; `0` (the default) when no answer came. */\n  status?: number;\n  code?: string | null;\n  errors?: readonly AthenaGraphQLErrorEntry[];\n  detail?: unknown;\n  retryAfterMs?: number | null;\n  method: string;\n  path: string;\n  cause?: unknown;\n}\n\n/** Marks an `AthenaApiError` across copies of the SDK (a host bundling two builds). */\nconst ATHENA_API_ERROR: unique symbol = Symbol.for('athena-sdk.AthenaApiError');\n\nexport class AthenaApiError extends Error {\n  readonly [ATHENA_API_ERROR] = true;\n  readonly kind: AthenaApiErrorKind;\n  /**\n   * The HTTP status agora answered with: a GraphQL error answered with 200 says\n   * 200. `0` when no answer came (`network`, `timeout`, `credential`,\n   * `request`).\n   */\n  readonly status: number;\n  /**\n   * Agora's machine-readable code: the first GraphQL error's\n   * `extensions.code`, or a REST error's `detail.code`. `null` when it gave\n   * none.\n   */\n  readonly code: string | null;\n  /** Every GraphQL error of the answer; empty for other failures. */\n  readonly errors: readonly AthenaGraphQLErrorEntry[];\n  /** A REST error's `detail` (FastAPI's envelope), else its body as read; `undefined` when there was none. */\n  readonly detail: unknown;\n  /**\n   * How long agora asked the caller to wait before trying again (`Retry-After`,\n   * or the `retryAfterSeconds` of a rate-limit refusal), in ms; `null` when it\n   * did not say.\n   */\n  readonly retryAfterMs: number | null;\n  /** The request's method. */\n  readonly method: string;\n  /** The request's path, without its query string. */\n  readonly path: string;\n\n  constructor(options: AthenaApiErrorOptions) {\n    super(options.message, options.cause === undefined ? undefined : { cause: options.cause });\n    this.name = 'AthenaApiError';\n    this.kind = options.kind;\n    this.status = options.status ?? 0;\n    this.code = options.code ?? null;\n    this.errors = options.errors ?? [];\n    this.detail = options.detail;\n    this.retryAfterMs = options.retryAfterMs ?? null;\n    this.method = options.method;\n    this.path = options.path;\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      kind: this.kind,\n      status: this.status,\n      code: this.code,\n      message: this.message,\n      errors: this.errors,\n      detail: this.detail,\n      retryAfterMs: this.retryAfterMs,\n      method: this.method,\n      path: this.path,\n    };\n  }\n}\n\n/** Whether `value` is an `AthenaApiError`, from this copy of the SDK or another. */\nexport function isAthenaApiError(value: unknown): value is AthenaApiError {\n  return (\n    value instanceof AthenaApiError ||\n    (typeof value === 'object' && value !== null && Reflect.get(value, ATHENA_API_ERROR) === true)\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** The `errors` of a GraphQL answer, read leniently: entries without a string message are dropped. */\nexport function graphQLErrorEntries(body: unknown): AthenaGraphQLErrorEntry[] {\n  const errors = isRecord(body) ? body.errors : undefined;\n  if (!Array.isArray(errors)) return [];\n  return errors.flatMap((entry): AthenaGraphQLErrorEntry[] => {\n    if (!isRecord(entry) || typeof entry.message !== 'string') return [];\n    const path = Array.isArray(entry.path)\n      ? entry.path.filter((part): part is string | number => typeof part === 'string' || typeof part === 'number')\n      : undefined;\n    return [\n      {\n        message: entry.message,\n        ...(path ? { path } : {}),\n        ...(isRecord(entry.extensions) ? { extensions: entry.extensions } : {}),\n      },\n    ];\n  });\n}\n\n/** The string `extensions.code` of a GraphQL error, if it has one. */\nexport function graphQLErrorCode(entry: AthenaGraphQLErrorEntry | undefined): string | null {\n  const code = entry?.extensions?.code;\n  return typeof code === 'string' ? code : null;\n}\n\n/**\n * What a REST error body says: FastAPI's `{ detail }` envelope, whose detail\n * is a string or agora's structured `{ code, message, retryAfterSeconds }`.\n */\nexport function restErrorDetail(body: unknown): {\n  detail: unknown;\n  code: string | null;\n  message: string | null;\n  retryAfterSeconds: number | null;\n} {\n  const detail = isRecord(body) && 'detail' in body ? body.detail : body;\n  if (typeof detail === 'string') {\n    return { detail, code: null, message: detail || null, retryAfterSeconds: null };\n  }\n  if (!isRecord(detail)) return { detail, code: null, message: null, retryAfterSeconds: null };\n  return {\n    detail,\n    code: typeof detail.code === 'string' ? detail.code : null,\n    message: typeof detail.message === 'string' ? detail.message : null,\n    retryAfterSeconds:\n      typeof detail.retryAfterSeconds === 'number' && Number.isFinite(detail.retryAfterSeconds)\n        ? detail.retryAfterSeconds\n        : null,\n  };\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/data/athena-data-client.cjs

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const reactQuery = require("@tanstack/react-query");
+const require$$0 = require("react");
+const accountIdentity = require("../auth/account-identity.cjs");
+const AthenaAuthContext = require("../auth/AthenaAuthContext.cjs");
+const AthenaCredentialSourceContext = require("../auth/AthenaCredentialSourceContext.cjs");
+const AthenaContext = require("../provider/AthenaContext.cjs");
+const athenaApiError = require("./athena-api-error.cjs");
+const athenaRequest = require("./athena-request.cjs");
+const AthenaDataQueryClientContext = require$$0.createContext(null);
+function AthenaDataQueryClientProvider({ children }) {
+  const [client] = require$$0.useState(() => new reactQuery.QueryClient());
+  require$$0.useEffect(() => {
+    client.mount();
+    return () => client.unmount();
+  }, [client]);
+  return /* @__PURE__ */ jsxRuntime.jsx(AthenaDataQueryClientContext.Provider, { value: client, children });
+}
+function useAthenaDataQueryClient() {
+  const own = require$$0.useContext(AthenaDataQueryClientContext);
+  const inContext = require$$0.useContext(reactQuery.QueryClientContext);
+  const fallback = require$$0.useRef(null);
+  if (own) return own;
+  if (inContext) return inContext;
+  fallback.current ?? (fallback.current = new reactQuery.QueryClient());
+  return fallback.current;
+}
+const AthenaDataKind = {
+  GraphQL: "graphql",
+  Rest: "rest",
+  SemanticQuery: "semantic-query"
+};
+function useAthenaDataScope() {
+  var _a, _b;
+  const { backendUrl, apiKey, token } = AthenaContext.useAthenaConfig();
+  const principal = ((_b = (_a = require$$0.useContext(AthenaAuthContext.AthenaAuthContext)) == null ? void 0 : _a.user) == null ? void 0 : _b.userId) ?? "";
+  const scopeEpoch = AthenaCredentialSourceContext.useAthenaCredentialScopeEpoch();
+  const [apiKeyPart, heldTokenPart] = accountIdentity.credentialKeyParts({ apiKey, heldToken: token });
+  return require$$0.useMemo(
+    () => ["athena-sdk", "data", backendUrl, principal, apiKeyPart, heldTokenPart, scopeEpoch],
+    [backendUrl, principal, apiKeyPart, heldTokenPart, scopeEpoch]
+  );
+}
+const ATHENA_DATA_STALE_MS = 3e4;
+const MAX_TRANSIENT_RETRIES = 2;
+const MAX_RETRY_DELAY_MS = 3e4;
+const MAX_HINTED_RETRY_DELAY_MS = 6e4;
+function retryAthenaRead(failureCount, error) {
+  if (!athenaApiError.isAthenaApiError(error) || failureCount >= MAX_TRANSIENT_RETRIES) return false;
+  if (error.kind === athenaApiError.AthenaApiErrorKind.Network) return true;
+  return error.kind === athenaApiError.AthenaApiErrorKind.Http && error.status >= 500;
+}
+function athenaRetryDelay(failureCount, error) {
+  if (athenaApiError.isAthenaApiError(error) && error.retryAfterMs !== null) {
+    return Math.min(error.retryAfterMs, MAX_HINTED_RETRY_DELAY_MS);
+  }
+  return Math.min(1e3 * 2 ** failureCount, MAX_RETRY_DELAY_MS);
+}
+function enabledAnd(enabled, ready) {
+  if (typeof enabled === "function") return (query) => ready && enabled(query);
+  return ready && (enabled ?? true);
+}
+function inScope(queryKey, scope) {
+  return scope.every((part, at) => Object.is(queryKey[at], part));
+}
+function matchesFilter(queryKey, scope, filter) {
+  var _a;
+  if (!filter) return true;
+  const kind = queryKey[scope.length];
+  const subject = queryKey[scope.length + 1];
+  if (typeof subject !== "string") return false;
+  if (kind === AthenaDataKind.GraphQL) {
+    const operationName = queryKey[scope.length + 3];
+    const name = (_a = athenaRequest.selectedGraphQLOperation(subject, typeof operationName === "string" ? operationName : null)) == null ? void 0 : _a.name;
+    return typeof name === "string" && (filter.operationNames ?? []).includes(name);
+  }
+  if (kind === AthenaDataKind.Rest) {
+    return (filter.paths ?? []).some((prefix) => subject.startsWith(prefix));
+  }
+  if (kind === AthenaDataKind.SemanticQuery) {
+    return (filter.semanticModelIds ?? []).includes(subject);
+  }
+  return false;
+}
+function useInvalidateAthenaQueries() {
+  const client = useAthenaDataQueryClient();
+  const scope = useAthenaDataScope();
+  return require$$0.useCallback(
+    (filter) => client.invalidateQueries({
+      predicate: ({ queryKey }) => inScope(queryKey, scope) && matchesFilter(queryKey, scope, filter)
+    }),
+    [client, scope]
+  );
+}
+exports.ATHENA_DATA_STALE_MS = ATHENA_DATA_STALE_MS;
+exports.AthenaDataKind = AthenaDataKind;
+exports.AthenaDataQueryClientProvider = AthenaDataQueryClientProvider;
+exports.athenaRetryDelay = athenaRetryDelay;
+exports.enabledAnd = enabledAnd;
+exports.retryAthenaRead = retryAthenaRead;
+exports.useAthenaDataQueryClient = useAthenaDataQueryClient;
+exports.useAthenaDataScope = useAthenaDataScope;
+exports.useInvalidateAthenaQueries = useInvalidateAthenaQueries;
+//# sourceMappingURL=athena-data-client.cjs.map

package/dist/data/athena-data-client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"athena-data-client.cjs","sources":["../../src/data/athena-data-client.tsx"],"sourcesContent":["/**\n * What every data hook shares: the SDK's own `QueryClient` (one per\n * `AthenaProvider`, so a host needs no `QueryClientProvider` and the hooks\n * never write into a host's cache), the identity every cache key starts with,\n * and the retry rule.\n *\n * Cache isolation: every key starts with the backend, the signed-in person,\n * the credential's fingerprint (the API key's, and who the held token acts as\n * and in which workspace, never the secret) and the provider's credential\n * scope epoch, which moves once a host's `getToken` hands out a token that\n * acts as someone else or is scoped to another workspace or org. A switch of\n * person, key or workspace therefore reads under new keys and never serves the\n * previous identity's answers.\n */\nimport {\n  QueryClient,\n  QueryClientContext,\n  type QueryKey,\n} from '@tanstack/react-query';\nimport {\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { credentialKeyParts } from '../auth/account-identity';\nimport { AthenaAuthContext } from '../auth/AthenaAuthContext';\nimport { useAthenaCredentialScopeEpoch } from '../auth/AthenaCredentialSourceContext';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport { AthenaApiErrorKind, isAthenaApiError } from './athena-api-error';\nimport { selectedGraphQLOperation } from './athena-request';\n\nconst AthenaDataQueryClientContext = createContext<QueryClient | null>(null);\n\n/**\n * Gives the data hooks under it one `QueryClient` of their own for as long as\n * it is mounted (`AthenaProvider` mounts it). Mounted as `QueryClientProvider`\n * mounts a client, so reads refetch on reconnect and, when asked, on focus.\n */\nexport function AthenaDataQueryClientProvider({ children }: { children: ReactNode }) {\n  const [client] = useState(() => new QueryClient());\n  useEffect(() => {\n    client.mount();\n    return () => client.unmount();\n  }, [client]);\n  return (\n    <AthenaDataQueryClientContext.Provider value={client}>{children}</AthenaDataQueryClientContext.Provider>\n  );\n}\n\n/**\n * The data hooks' client: the provider's own, else (a provider-less tree, as in\n * a host's tests) a `QueryClient` in context, else one of the calling hook's.\n */\nexport function useAthenaDataQueryClient(): QueryClient {\n  const own = useContext(AthenaDataQueryClientContext);\n  const inContext = useContext(QueryClientContext);\n  const fallback = useRef<QueryClient | null>(null);\n  if (own) return own;\n  if (inContext) return inContext;\n  fallback.current ??= new QueryClient();\n  return fallback.current;\n}\n\n/**\n * The first parts of every data key: whose reads they are. After the two tags:\n * the backend, the signed-in person (`''` when the provider knows none), the\n * API key's fingerprint, who the held token acts as and where, and the scope\n * epoch.\n */\nexport type AthenaDataScope = readonly ['athena-sdk', 'data', string, string, string, string, number];\n\n/** What a data key holds after its scope. */\nexport const AthenaDataKind = {\n  GraphQL: 'graphql',\n  Rest: 'rest',\n  SemanticQuery: 'semantic-query',\n} as const;\nexport type AthenaDataKind = (typeof AthenaDataKind)[keyof typeof AthenaDataKind];\n\n/** The scope the provider's reads are cached under now (see the module comment). */\nexport function useAthenaDataScope(): AthenaDataScope {\n  const { backendUrl, apiKey, token } = useAthenaConfig();\n  const principal = useContext(AthenaAuthContext)?.user?.userId ?? '';\n  const scopeEpoch = useAthenaCredentialScopeEpoch();\n  const [apiKeyPart, heldTokenPart] = credentialKeyParts({ apiKey, heldToken: token });\n  return useMemo(\n    () => ['athena-sdk', 'data', backendUrl, principal, apiKeyPart, heldTokenPart, scopeEpoch] as const,\n    [backendUrl, principal, apiKeyPart, heldTokenPart, scopeEpoch],\n  );\n}\n\n/** How long an answer serves another read of the same thing before agora is asked again. */\nexport const ATHENA_DATA_STALE_MS = 30_000;\n\nconst MAX_TRANSIENT_RETRIES = 2;\nconst MAX_RETRY_DELAY_MS = 30_000;\nconst MAX_HINTED_RETRY_DELAY_MS = 60_000;\n\n/**\n * Whether a failed read is asked again: only what may answer differently a\n * moment later (no answer at all, or a 5xx), twice at most. A 4xx (a 429 the\n * transport already waited out included), a GraphQL error, a timeout, a\n * credential that could not be resolved and an unreadable answer are not.\n */\nexport function retryAthenaRead(failureCount: number, error: unknown): boolean {\n  if (!isAthenaApiError(error) || failureCount >= MAX_TRANSIENT_RETRIES) return false;\n  if (error.kind === AthenaApiErrorKind.Network) return true;\n  return error.kind === AthenaApiErrorKind.Http && error.status >= 500;\n}\n\n/** The wait before asking again: what agora asked for (`Retry-After`), else 1 s, 2 s, 4 s… */\nexport function athenaRetryDelay(failureCount: number, error: unknown): number {\n  if (isAthenaApiError(error) && error.retryAfterMs !== null) {\n    return Math.min(error.retryAfterMs, MAX_HINTED_RETRY_DELAY_MS);\n  }\n  return Math.min(1_000 * 2 ** failureCount, MAX_RETRY_DELAY_MS);\n}\n\n/** `enabled` as a host passed it, and also `ready`. */\nexport function enabledAnd<TQuery>(\n  enabled: boolean | ((query: TQuery) => boolean) | undefined,\n  ready: boolean,\n): boolean | ((query: TQuery) => boolean) {\n  if (typeof enabled === 'function') return (query: TQuery) => ready && enabled(query);\n  return ready && (enabled ?? true);\n}\n\n/** Which of the current identity's reads to read again; every field is optional, and none means all. */\nexport interface AthenaDataQueryFilter {\n  /** GraphQL reads whose operation has one of these names. */\n  operationNames?: readonly string[];\n  /** REST reads whose path starts with one of these. */\n  paths?: readonly string[];\n  /** Semantic queries of these models. */\n  semanticModelIds?: readonly string[];\n}\n\nfunction inScope(queryKey: QueryKey, scope: AthenaDataScope): boolean {\n  return scope.every((part, at) => Object.is(queryKey[at], part));\n}\n\nfunction matchesFilter(\n  queryKey: QueryKey,\n  scope: AthenaDataScope,\n  filter: AthenaDataQueryFilter | undefined,\n): boolean {\n  if (!filter) return true;\n  const kind = queryKey[scope.length];\n  const subject = queryKey[scope.length + 1];\n  if (typeof subject !== 'string') return false;\n  if (kind === AthenaDataKind.GraphQL) {\n    // The operation the read runs: the one its `operationName` names, else its document's only one.\n    const operationName = queryKey[scope.length + 3];\n    const name = selectedGraphQLOperation(subject, typeof operationName === 'string' ? operationName : null)?.name;\n    return typeof name === 'string' && (filter.operationNames ?? []).includes(name);\n  }\n  if (kind === AthenaDataKind.Rest) {\n    return (filter.paths ?? []).some((prefix) => subject.startsWith(prefix));\n  }\n  if (kind === AthenaDataKind.SemanticQuery) {\n    return (filter.semanticModelIds ?? []).includes(subject);\n  }\n  return false;\n}\n\n/**\n * Answers a function that has the current identity's data reads read again:\n * those `filter` names, or every one without it. Reads on screen are sent at\n * once; the rest read again when next shown. Call it after a write that\n * changes what they answer.\n */\nexport function useInvalidateAthenaQueries(): (filter?: AthenaDataQueryFilter) => Promise<void> {\n  const client = useAthenaDataQueryClient();\n  const scope = useAthenaDataScope();\n  return useCallback(\n    (filter?: AthenaDataQueryFilter) =>\n      client.invalidateQueries({\n        predicate: ({ queryKey }) => inScope(queryKey, scope) && matchesFilter(queryKey, scope, filter),\n      }),\n    [client, scope],\n  );\n}\n"],"names":["createContext","useState","QueryClient","useEffect","useContext","QueryClientContext","useRef","useAthenaConfig","AthenaAuthContext","useAthenaCredentialScopeEpoch","credentialKeyParts","useMemo","isAthenaApiError","AthenaApiErrorKind","selectedGraphQLOperation","useCallback"],"mappings":"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"}

package/dist/data/athena-data-client.d.ts

@@ -0,0 +1,74 @@
+/**
+ * What every data hook shares: the SDK's own `QueryClient` (one per
+ * `AthenaProvider`, so a host needs no `QueryClientProvider` and the hooks
+ * never write into a host's cache), the identity every cache key starts with,
+ * and the retry rule.
+ *
+ * Cache isolation: every key starts with the backend, the signed-in person,
+ * the credential's fingerprint (the API key's, and who the held token acts as
+ * and in which workspace, never the secret) and the provider's credential
+ * scope epoch, which moves once a host's `getToken` hands out a token that
+ * acts as someone else or is scoped to another workspace or org. A switch of
+ * person, key or workspace therefore reads under new keys and never serves the
+ * previous identity's answers.
+ */
+import { QueryClient } from '@tanstack/react-query';
+import { type ReactNode } from 'react';
+/**
+ * Gives the data hooks under it one `QueryClient` of their own for as long as
+ * it is mounted (`AthenaProvider` mounts it). Mounted as `QueryClientProvider`
+ * mounts a client, so reads refetch on reconnect and, when asked, on focus.
+ */
+export declare function AthenaDataQueryClientProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * The data hooks' client: the provider's own, else (a provider-less tree, as in
+ * a host's tests) a `QueryClient` in context, else one of the calling hook's.
+ */
+export declare function useAthenaDataQueryClient(): QueryClient;
+/**
+ * The first parts of every data key: whose reads they are. After the two tags:
+ * the backend, the signed-in person (`''` when the provider knows none), the
+ * API key's fingerprint, who the held token acts as and where, and the scope
+ * epoch.
+ */
+export type AthenaDataScope = readonly ['athena-sdk', 'data', string, string, string, string, number];
+/** What a data key holds after its scope. */
+export declare const AthenaDataKind: {
+    readonly GraphQL: 'graphql';
+    readonly Rest: 'rest';
+    readonly SemanticQuery: 'semantic-query';
+};
+export type AthenaDataKind = (typeof AthenaDataKind)[keyof typeof AthenaDataKind];
+/** The scope the provider's reads are cached under now (see the module comment). */
+export declare function useAthenaDataScope(): AthenaDataScope;
+/** How long an answer serves another read of the same thing before agora is asked again. */
+export declare const ATHENA_DATA_STALE_MS = 30000;
+/**
+ * Whether a failed read is asked again: only what may answer differently a
+ * moment later (no answer at all, or a 5xx), twice at most. A 4xx (a 429 the
+ * transport already waited out included), a GraphQL error, a timeout, a
+ * credential that could not be resolved and an unreadable answer are not.
+ */
+export declare function retryAthenaRead(failureCount: number, error: unknown): boolean;
+/** The wait before asking again: what agora asked for (`Retry-After`), else 1 s, 2 s, 4 s… */
+export declare function athenaRetryDelay(failureCount: number, error: unknown): number;
+/** `enabled` as a host passed it, and also `ready`. */
+export declare function enabledAnd<TQuery>(enabled: boolean | ((query: TQuery) => boolean) | undefined, ready: boolean): boolean | ((query: TQuery) => boolean);
+/** Which of the current identity's reads to read again; every field is optional, and none means all. */
+export interface AthenaDataQueryFilter {
+    /** GraphQL reads whose operation has one of these names. */
+    operationNames?: readonly string[];
+    /** REST reads whose path starts with one of these. */
+    paths?: readonly string[];
+    /** Semantic queries of these models. */
+    semanticModelIds?: readonly string[];
+}
+/**
+ * Answers a function that has the current identity's data reads read again:
+ * those `filter` names, or every one without it. Reads on screen are sent at
+ * once; the rest read again when next shown. Call it after a write that
+ * changes what they answer.
+ */
+export declare function useInvalidateAthenaQueries(): (filter?: AthenaDataQueryFilter) => Promise<void>;

package/dist/data/athena-data-client.js

@@ -0,0 +1,106 @@
+import { jsx } from "react/jsx-runtime";
+import { QueryClient, QueryClientContext } from "@tanstack/react-query";
+import { useCallback, useState, useEffect, useContext, useMemo, useRef, createContext } from "react";
+import { credentialKeyParts } from "../auth/account-identity.js";
+import { AthenaAuthContext } from "../auth/AthenaAuthContext.js";
+import { useAthenaCredentialScopeEpoch } from "../auth/AthenaCredentialSourceContext.js";
+import { useAthenaConfig } from "../provider/AthenaContext.js";
+import { isAthenaApiError, AthenaApiErrorKind } from "./athena-api-error.js";
+import { selectedGraphQLOperation } from "./athena-request.js";
+const AthenaDataQueryClientContext = createContext(null);
+function AthenaDataQueryClientProvider({ children }) {
+  const [client] = useState(() => new QueryClient());
+  useEffect(() => {
+    client.mount();
+    return () => client.unmount();
+  }, [client]);
+  return /* @__PURE__ */ jsx(AthenaDataQueryClientContext.Provider, { value: client, children });
+}
+function useAthenaDataQueryClient() {
+  const own = useContext(AthenaDataQueryClientContext);
+  const inContext = useContext(QueryClientContext);
+  const fallback = useRef(null);
+  if (own) return own;
+  if (inContext) return inContext;
+  fallback.current ?? (fallback.current = new QueryClient());
+  return fallback.current;
+}
+const AthenaDataKind = {
+  GraphQL: "graphql",
+  Rest: "rest",
+  SemanticQuery: "semantic-query"
+};
+function useAthenaDataScope() {
+  var _a, _b;
+  const { backendUrl, apiKey, token } = useAthenaConfig();
+  const principal = ((_b = (_a = useContext(AthenaAuthContext)) == null ? void 0 : _a.user) == null ? void 0 : _b.userId) ?? "";
+  const scopeEpoch = useAthenaCredentialScopeEpoch();
+  const [apiKeyPart, heldTokenPart] = credentialKeyParts({ apiKey, heldToken: token });
+  return useMemo(
+    () => ["athena-sdk", "data", backendUrl, principal, apiKeyPart, heldTokenPart, scopeEpoch],
+    [backendUrl, principal, apiKeyPart, heldTokenPart, scopeEpoch]
+  );
+}
+const ATHENA_DATA_STALE_MS = 3e4;
+const MAX_TRANSIENT_RETRIES = 2;
+const MAX_RETRY_DELAY_MS = 3e4;
+const MAX_HINTED_RETRY_DELAY_MS = 6e4;
+function retryAthenaRead(failureCount, error) {
+  if (!isAthenaApiError(error) || failureCount >= MAX_TRANSIENT_RETRIES) return false;
+  if (error.kind === AthenaApiErrorKind.Network) return true;
+  return error.kind === AthenaApiErrorKind.Http && error.status >= 500;
+}
+function athenaRetryDelay(failureCount, error) {
+  if (isAthenaApiError(error) && error.retryAfterMs !== null) {
+    return Math.min(error.retryAfterMs, MAX_HINTED_RETRY_DELAY_MS);
+  }
+  return Math.min(1e3 * 2 ** failureCount, MAX_RETRY_DELAY_MS);
+}
+function enabledAnd(enabled, ready) {
+  if (typeof enabled === "function") return (query) => ready && enabled(query);
+  return ready && (enabled ?? true);
+}
+function inScope(queryKey, scope) {
+  return scope.every((part, at) => Object.is(queryKey[at], part));
+}
+function matchesFilter(queryKey, scope, filter) {
+  var _a;
+  if (!filter) return true;
+  const kind = queryKey[scope.length];
+  const subject = queryKey[scope.length + 1];
+  if (typeof subject !== "string") return false;
+  if (kind === AthenaDataKind.GraphQL) {
+    const operationName = queryKey[scope.length + 3];
+    const name = (_a = selectedGraphQLOperation(subject, typeof operationName === "string" ? operationName : null)) == null ? void 0 : _a.name;
+    return typeof name === "string" && (filter.operationNames ?? []).includes(name);
+  }
+  if (kind === AthenaDataKind.Rest) {
+    return (filter.paths ?? []).some((prefix) => subject.startsWith(prefix));
+  }
+  if (kind === AthenaDataKind.SemanticQuery) {
+    return (filter.semanticModelIds ?? []).includes(subject);
+  }
+  return false;
+}
+function useInvalidateAthenaQueries() {
+  const client = useAthenaDataQueryClient();
+  const scope = useAthenaDataScope();
+  return useCallback(
+    (filter) => client.invalidateQueries({
+      predicate: ({ queryKey }) => inScope(queryKey, scope) && matchesFilter(queryKey, scope, filter)
+    }),
+    [client, scope]
+  );
+}
+export {
+  ATHENA_DATA_STALE_MS,
+  AthenaDataKind,
+  AthenaDataQueryClientProvider,
+  athenaRetryDelay,
+  enabledAnd,
+  retryAthenaRead,
+  useAthenaDataQueryClient,
+  useAthenaDataScope,
+  useInvalidateAthenaQueries
+};
+//# sourceMappingURL=athena-data-client.js.map

package/dist/data/athena-data-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"athena-data-client.js","sources":["../../src/data/athena-data-client.tsx"],"sourcesContent":["/**\n * What every data hook shares: the SDK's own `QueryClient` (one per\n * `AthenaProvider`, so a host needs no `QueryClientProvider` and the hooks\n * never write into a host's cache), the identity every cache key starts with,\n * and the retry rule.\n *\n * Cache isolation: every key starts with the backend, the signed-in person,\n * the credential's fingerprint (the API key's, and who the held token acts as\n * and in which workspace, never the secret) and the provider's credential\n * scope epoch, which moves once a host's `getToken` hands out a token that\n * acts as someone else or is scoped to another workspace or org. A switch of\n * person, key or workspace therefore reads under new keys and never serves the\n * previous identity's answers.\n */\nimport {\n  QueryClient,\n  QueryClientContext,\n  type QueryKey,\n} from '@tanstack/react-query';\nimport {\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport { credentialKeyParts } from '../auth/account-identity';\nimport { AthenaAuthContext } from '../auth/AthenaAuthContext';\nimport { useAthenaCredentialScopeEpoch } from '../auth/AthenaCredentialSourceContext';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport { AthenaApiErrorKind, isAthenaApiError } from './athena-api-error';\nimport { selectedGraphQLOperation } from './athena-request';\n\nconst AthenaDataQueryClientContext = createContext<QueryClient | null>(null);\n\n/**\n * Gives the data hooks under it one `QueryClient` of their own for as long as\n * it is mounted (`AthenaProvider` mounts it). Mounted as `QueryClientProvider`\n * mounts a client, so reads refetch on reconnect and, when asked, on focus.\n */\nexport function AthenaDataQueryClientProvider({ children }: { children: ReactNode }) {\n  const [client] = useState(() => new QueryClient());\n  useEffect(() => {\n    client.mount();\n    return () => client.unmount();\n  }, [client]);\n  return (\n    <AthenaDataQueryClientContext.Provider value={client}>{children}</AthenaDataQueryClientContext.Provider>\n  );\n}\n\n/**\n * The data hooks' client: the provider's own, else (a provider-less tree, as in\n * a host's tests) a `QueryClient` in context, else one of the calling hook's.\n */\nexport function useAthenaDataQueryClient(): QueryClient {\n  const own = useContext(AthenaDataQueryClientContext);\n  const inContext = useContext(QueryClientContext);\n  const fallback = useRef<QueryClient | null>(null);\n  if (own) return own;\n  if (inContext) return inContext;\n  fallback.current ??= new QueryClient();\n  return fallback.current;\n}\n\n/**\n * The first parts of every data key: whose reads they are. After the two tags:\n * the backend, the signed-in person (`''` when the provider knows none), the\n * API key's fingerprint, who the held token acts as and where, and the scope\n * epoch.\n */\nexport type AthenaDataScope = readonly ['athena-sdk', 'data', string, string, string, string, number];\n\n/** What a data key holds after its scope. */\nexport const AthenaDataKind = {\n  GraphQL: 'graphql',\n  Rest: 'rest',\n  SemanticQuery: 'semantic-query',\n} as const;\nexport type AthenaDataKind = (typeof AthenaDataKind)[keyof typeof AthenaDataKind];\n\n/** The scope the provider's reads are cached under now (see the module comment). */\nexport function useAthenaDataScope(): AthenaDataScope {\n  const { backendUrl, apiKey, token } = useAthenaConfig();\n  const principal = useContext(AthenaAuthContext)?.user?.userId ?? '';\n  const scopeEpoch = useAthenaCredentialScopeEpoch();\n  const [apiKeyPart, heldTokenPart] = credentialKeyParts({ apiKey, heldToken: token });\n  return useMemo(\n    () => ['athena-sdk', 'data', backendUrl, principal, apiKeyPart, heldTokenPart, scopeEpoch] as const,\n    [backendUrl, principal, apiKeyPart, heldTokenPart, scopeEpoch],\n  );\n}\n\n/** How long an answer serves another read of the same thing before agora is asked again. */\nexport const ATHENA_DATA_STALE_MS = 30_000;\n\nconst MAX_TRANSIENT_RETRIES = 2;\nconst MAX_RETRY_DELAY_MS = 30_000;\nconst MAX_HINTED_RETRY_DELAY_MS = 60_000;\n\n/**\n * Whether a failed read is asked again: only what may answer differently a\n * moment later (no answer at all, or a 5xx), twice at most. A 4xx (a 429 the\n * transport already waited out included), a GraphQL error, a timeout, a\n * credential that could not be resolved and an unreadable answer are not.\n */\nexport function retryAthenaRead(failureCount: number, error: unknown): boolean {\n  if (!isAthenaApiError(error) || failureCount >= MAX_TRANSIENT_RETRIES) return false;\n  if (error.kind === AthenaApiErrorKind.Network) return true;\n  return error.kind === AthenaApiErrorKind.Http && error.status >= 500;\n}\n\n/** The wait before asking again: what agora asked for (`Retry-After`), else 1 s, 2 s, 4 s… */\nexport function athenaRetryDelay(failureCount: number, error: unknown): number {\n  if (isAthenaApiError(error) && error.retryAfterMs !== null) {\n    return Math.min(error.retryAfterMs, MAX_HINTED_RETRY_DELAY_MS);\n  }\n  return Math.min(1_000 * 2 ** failureCount, MAX_RETRY_DELAY_MS);\n}\n\n/** `enabled` as a host passed it, and also `ready`. */\nexport function enabledAnd<TQuery>(\n  enabled: boolean | ((query: TQuery) => boolean) | undefined,\n  ready: boolean,\n): boolean | ((query: TQuery) => boolean) {\n  if (typeof enabled === 'function') return (query: TQuery) => ready && enabled(query);\n  return ready && (enabled ?? true);\n}\n\n/** Which of the current identity's reads to read again; every field is optional, and none means all. */\nexport interface AthenaDataQueryFilter {\n  /** GraphQL reads whose operation has one of these names. */\n  operationNames?: readonly string[];\n  /** REST reads whose path starts with one of these. */\n  paths?: readonly string[];\n  /** Semantic queries of these models. */\n  semanticModelIds?: readonly string[];\n}\n\nfunction inScope(queryKey: QueryKey, scope: AthenaDataScope): boolean {\n  return scope.every((part, at) => Object.is(queryKey[at], part));\n}\n\nfunction matchesFilter(\n  queryKey: QueryKey,\n  scope: AthenaDataScope,\n  filter: AthenaDataQueryFilter | undefined,\n): boolean {\n  if (!filter) return true;\n  const kind = queryKey[scope.length];\n  const subject = queryKey[scope.length + 1];\n  if (typeof subject !== 'string') return false;\n  if (kind === AthenaDataKind.GraphQL) {\n    // The operation the read runs: the one its `operationName` names, else its document's only one.\n    const operationName = queryKey[scope.length + 3];\n    const name = selectedGraphQLOperation(subject, typeof operationName === 'string' ? operationName : null)?.name;\n    return typeof name === 'string' && (filter.operationNames ?? []).includes(name);\n  }\n  if (kind === AthenaDataKind.Rest) {\n    return (filter.paths ?? []).some((prefix) => subject.startsWith(prefix));\n  }\n  if (kind === AthenaDataKind.SemanticQuery) {\n    return (filter.semanticModelIds ?? []).includes(subject);\n  }\n  return false;\n}\n\n/**\n * Answers a function that has the current identity's data reads read again:\n * those `filter` names, or every one without it. Reads on screen are sent at\n * once; the rest read again when next shown. Call it after a write that\n * changes what they answer.\n */\nexport function useInvalidateAthenaQueries(): (filter?: AthenaDataQueryFilter) => Promise<void> {\n  const client = useAthenaDataQueryClient();\n  const scope = useAthenaDataScope();\n  return useCallback(\n    (filter?: AthenaDataQueryFilter) =>\n      client.invalidateQueries({\n        predicate: ({ queryKey }) => inScope(queryKey, scope) && matchesFilter(queryKey, scope, filter),\n      }),\n    [client, scope],\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/data/athena-member.cjs

@@ -0,0 +1,93 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const athenaApiError = require("./athena-api-error.cjs");
+const athenaRequest = require("./athena-request.cjs");
+const useAthenaRest = require("./use-athena-rest.cjs");
+const ATHENA_BUNDLE_KEY_PATTERN = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+const ATHENA_BUNDLE_KEY_MAX_LENGTH = 63;
+const ATHENA_MEMBER_KEY_PATTERN = /^[a-z][a-z0-9_]{0,62}$/;
+class AthenaMemberNotFoundError extends Error {
+  constructor(memberName, options) {
+    super(`No member named ${memberName} here, or you can't open it.`, options);
+    /** The name that didn't resolve (`support-desk/support_agent`). */
+    __publicField(this, "memberName");
+    this.name = "AthenaMemberNotFoundError";
+    this.memberName = memberName;
+  }
+}
+function parseAthenaMemberName(value) {
+  if (typeof value !== "string") return null;
+  const slash = value.indexOf("/");
+  if (slash < 0) return null;
+  const bundleKey = value.slice(0, slash);
+  const memberKey = value.slice(slash + 1);
+  if (bundleKey.length > ATHENA_BUNDLE_KEY_MAX_LENGTH || !ATHENA_BUNDLE_KEY_PATTERN.test(bundleKey) || !ATHENA_MEMBER_KEY_PATTERN.test(memberKey)) {
+    return null;
+  }
+  return { bundleKey, memberKey };
+}
+function isAthenaMemberName(value) {
+  return parseAthenaMemberName(value) !== null;
+}
+function athenaMemberPath({ bundleKey, memberKey }) {
+  return `/api/v0/bundles/${encodeURIComponent(bundleKey)}/members/${encodeURIComponent(memberKey)}`;
+}
+function memberParams({
+  track,
+  workspaceId
+}) {
+  const params = {};
+  if (track) params.track = track;
+  if (workspaceId) params.workspace_id = workspaceId;
+  return Object.keys(params).length > 0 ? params : void 0;
+}
+async function resolveAthenaMember({
+  name,
+  track,
+  workspaceId,
+  signal,
+  ...config
+}) {
+  const parsed = parseAthenaMemberName(name);
+  const path = parsed ? athenaMemberPath(parsed) : "/api/v0/bundles";
+  if (parsed === null) {
+    throw new athenaApiError.AthenaApiError({
+      kind: athenaApiError.AthenaApiErrorKind.Request,
+      message: `${JSON.stringify(name)} isn't a member name: write <bundle key>/<member key>, e.g. support-desk/support_agent.`,
+      method: "GET",
+      path
+    });
+  }
+  try {
+    return await athenaRequest.athenaFetchJson(config, path, {
+      method: "GET",
+      params: memberParams({ track, workspaceId }),
+      signal
+    });
+  } catch (error) {
+    if (athenaApiError.isAthenaApiError(error) && error.status === 404) {
+      throw new AthenaMemberNotFoundError(name, { cause: error });
+    }
+    throw error;
+  }
+}
+function useAthenaMember(name, { track, workspaceId, ...options } = {}) {
+  const parsed = name === null ? null : parseAthenaMemberName(name);
+  return useAthenaRest.useAthenaRest(parsed ? athenaMemberPath(parsed) : null, {
+    ...options,
+    params: memberParams({ track, workspaceId })
+  });
+}
+exports.ATHENA_BUNDLE_KEY_MAX_LENGTH = ATHENA_BUNDLE_KEY_MAX_LENGTH;
+exports.ATHENA_BUNDLE_KEY_PATTERN = ATHENA_BUNDLE_KEY_PATTERN;
+exports.ATHENA_MEMBER_KEY_PATTERN = ATHENA_MEMBER_KEY_PATTERN;
+exports.AthenaMemberNotFoundError = AthenaMemberNotFoundError;
+exports.athenaMemberPath = athenaMemberPath;
+exports.isAthenaMemberName = isAthenaMemberName;
+exports.parseAthenaMemberName = parseAthenaMemberName;
+exports.resolveAthenaMember = resolveAthenaMember;
+exports.useAthenaMember = useAthenaMember;
+//# sourceMappingURL=athena-member.cjs.map

package/dist/data/athena-member.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"athena-member.cjs","sources":["../../src/data/athena-member.ts"],"sourcesContent":["/**\n * Bundle member names: `support-desk/support_agent` resolved to this place's\n * own asset (Bundle Phase 2; docs/plans/2026-11-09-bundle-phase-2-plan.md §6.3).\n *\n * A bundle names each member by a permanent key, and each workspace or\n * deployment that holds the bundle (the source and every copy) has its own\n * asset behind that key. Code that names `<bundle key>/<member key>` keeps\n * working in every place, where a raw `asset_…` id names one place's asset only.\n * Agora resolves a name through one route,\n * `GET /api/v0/bundles/{bundle_key}/members/{member_key}`, in the caller's\n * workspace: it answers only a member the caller may open, and every refusal is\n * the same 404 a name that doesn't exist gets.\n *\n * - {@link resolveAthenaMember}: one read, outside React (a script holding an\n *   API key, a server).\n * - {@link useAthenaMember}: the same read as a cached query, as the provider's\n *   signed-in person.\n */\nimport type { UseQueryResult } from '@tanstack/react-query';\nimport { AthenaApiError, AthenaApiErrorKind, isAthenaApiError } from './athena-api-error';\nimport { type AthenaRequestConfig, athenaFetchJson } from './athena-request';\nimport { type UseAthenaRestOptions, useAthenaRest } from './use-athena-rest';\n\n/** A bundle key: lowercase words joined by single hyphens, at most 63 characters (`support-desk`). */\nexport const ATHENA_BUNDLE_KEY_PATTERN = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;\n/** The longest bundle key. */\nexport const ATHENA_BUNDLE_KEY_MAX_LENGTH = 63;\n/** A member key: a lowercase letter, then letters, digits and underscores, 63 at most (`support_agent`). */\nexport const ATHENA_MEMBER_KEY_PATTERN = /^[a-z][a-z0-9_]{0,62}$/;\n\n/** A parsed `<bundle key>/<member key>`. */\nexport interface AthenaMemberName {\n  bundleKey: string;\n  memberKey: string;\n}\n\n/** The revision a track serves of a member: its version id and content digest. */\nexport interface AthenaMemberRevision {\n  version_id: string;\n  /** `sha256:…`, the same in every place holding this revision; `null` for a version cut before digests. */\n  digest: string | null;\n  digest_alg: string | null;\n}\n\n/** A member name resolved in the caller's place, as agora answers it. */\nexport interface AthenaMember {\n  bundle_key: string;\n  member_key: string;\n  /** This place's asset for the member. */\n  asset_id: string;\n  /** The member asset's type (`collab_agent`, `user_interface`…). */\n  type: string;\n  /** How the member joins the bundle: `ships`, `pin`, `pin+notify` or `follow`. */\n  link: string;\n  /** The track the answer read; `null` when none was asked for. */\n  track: string | null;\n  /** With a track, the revision it serves of the member (`null` when followed); `null` without a track. */\n  revision: AthenaMemberRevision | null;\n}\n\n/**\n * A member name that doesn't resolve for the caller: no such bundle or member in\n * the caller's workspace, or one the caller can't open. Agora answers the two\n * alike, so this error doesn't tell them apart either.\n */\nexport class AthenaMemberNotFoundError extends Error {\n  /** The name that didn't resolve (`support-desk/support_agent`). */\n  readonly memberName: string;\n\n  constructor(memberName: string, options?: { cause?: unknown }) {\n    super(`No member named ${memberName} here, or you can't open it.`, options);\n    this.name = 'AthenaMemberNotFoundError';\n    this.memberName = memberName;\n  }\n}\n\n/** `value` as `<bundle key>/<member key>`, or `null`. An `asset_…` id never parses: it holds no `/`. */\nexport function parseAthenaMemberName(value: unknown): AthenaMemberName | null {\n  if (typeof value !== 'string') return null;\n  const slash = value.indexOf('/');\n  if (slash < 0) return null;\n  const bundleKey = value.slice(0, slash);\n  const memberKey = value.slice(slash + 1);\n  if (\n    bundleKey.length > ATHENA_BUNDLE_KEY_MAX_LENGTH ||\n    !ATHENA_BUNDLE_KEY_PATTERN.test(bundleKey) ||\n    !ATHENA_MEMBER_KEY_PATTERN.test(memberKey)\n  ) {\n    return null;\n  }\n  return { bundleKey, memberKey };\n}\n\n/** Whether `value` is a member name (`<bundle key>/<member key>`). */\nexport function isAthenaMemberName(value: unknown): value is string {\n  return parseAthenaMemberName(value) !== null;\n}\n\n/** The members route's path for a parsed name. */\nexport function athenaMemberPath({ bundleKey, memberKey }: AthenaMemberName): string {\n  return `/api/v0/bundles/${encodeURIComponent(bundleKey)}/members/${encodeURIComponent(memberKey)}`;\n}\n\nexport interface ResolveAthenaMemberOptions extends AthenaRequestConfig {\n  /** `<bundle key>/<member key>`, e.g. `support-desk/support_agent`. */\n  name: string;\n  /** A track's key (`production`, `pilot`…): also answer the revision it serves. The caller must be on the track. */\n  track?: string;\n  /**\n   * The workspace to resolve in. Optional for a person in one workspace and for a credential bound to\n   * one; a person in several names it (else agora answers `400 workspace_required`).\n   */\n  workspaceId?: string;\n  /** Cancels the read; it then rejects with the abort's reason. */\n  signal?: AbortSignal;\n}\n\nfunction memberParams({\n  track,\n  workspaceId,\n}: {\n  track?: string;\n  workspaceId?: string;\n}): Record<string, string> | undefined {\n  const params: Record<string, string> = {};\n  if (track) params.track = track;\n  if (workspaceId) params.workspace_id = workspaceId;\n  return Object.keys(params).length > 0 ? params : undefined;\n}\n\n/**\n * Resolve a member name to this place's asset, as the credential's person, in\n * the workspace `workspaceId` names (or their only one). Sent as every SDK request is (the token from `getToken` or\n * `token`, else `apiKey`; under `backendUrl` only).\n *\n * Throws {@link AthenaMemberNotFoundError} when the name doesn't resolve for\n * the caller, an `AthenaApiError` of kind `request` for a string that isn't a\n * member name (nothing is sent), and an `AthenaApiError` for any other failure.\n *\n * ```ts\n * const agent = await resolveAthenaMember({\n *   backendUrl: 'https://api.athenaintel.com',\n *   apiKey: process.env.ATHENA_API_KEY,\n *   name: 'support-desk/support_agent',\n * });\n * agent.asset_id; // this workspace's own agent\n * ```\n */\nexport async function resolveAthenaMember({\n  name,\n  track,\n  workspaceId,\n  signal,\n  ...config\n}: ResolveAthenaMemberOptions): Promise<AthenaMember> {\n  const parsed = parseAthenaMemberName(name);\n  const path = parsed ? athenaMemberPath(parsed) : '/api/v0/bundles';\n  if (parsed === null) {\n    throw new AthenaApiError({\n      kind: AthenaApiErrorKind.Request,\n      message: `${JSON.stringify(name)} isn't a member name: write <bundle key>/<member key>, e.g. support-desk/support_agent.`,\n      method: 'GET',\n      path,\n    });\n  }\n  try {\n    return await athenaFetchJson<AthenaMember>(config, path, {\n      method: 'GET',\n      params: memberParams({ track, workspaceId }),\n      signal,\n    });\n  } catch (error) {\n    if (isAthenaApiError(error) && error.status === 404) {\n      throw new AthenaMemberNotFoundError(name, { cause: error });\n    }\n    throw error;\n  }\n}\n\n/** `useAthenaMember`'s options: a track, and TanStack Query's (`enabled`, `select`…). */\nexport type UseAthenaMemberOptions = Omit<UseAthenaRestOptions<AthenaMember>, 'params'> & {\n  /** A track's key: also answer the revision it serves (part of the cache key). */\n  track?: string;\n  /** The workspace to resolve in, for a person in several (part of the cache key). */\n  workspaceId?: string;\n};\n\n/**\n * The asset a member name resolves to, as the provider's signed-in person: a\n * cached query on the SDK's QueryClient (`useAthenaRest` on the members route).\n * `null`, or a string that isn't a member name, holds the read idle (check with\n * {@link isAthenaMemberName}). A name that doesn't resolve for the person fails\n * with an `AthenaApiError` whose `status` is 404 and `code` `member_not_found`.\n *\n * ```tsx\n * const agent = useAthenaMember('support-desk/support_agent');\n * if (agent.data) startChat({ agentId: agent.data.asset_id });\n * ```\n */\nexport function useAthenaMember(\n  name: string | null,\n  { track, workspaceId, ...options }: UseAthenaMemberOptions = {},\n): UseQueryResult<AthenaMember, AthenaApiError> {\n  const parsed = name === null ? null : parseAthenaMemberName(name);\n  return useAthenaRest<AthenaMember>(parsed ? athenaMemberPath(parsed) : null, {\n    ...options,\n    params: memberParams({ track, workspaceId }),\n  });\n}\n"],"names":["AthenaApiError","AthenaApiErrorKind","athenaFetchJson","isAthenaApiError","useAthenaRest"],"mappings":";;;;;;;;AAwBO,MAAM,4BAA4B;AAElC,MAAM,+BAA+B;AAErC,MAAM,4BAA4B;AAqClC,MAAM,kCAAkC,MAAM;AAAA,EAInD,YAAY,YAAoB,SAA+B;AAC7D,UAAM,mBAAmB,UAAU,gCAAgC,OAAO;AAHnE;AAAA;AAIP,SAAK,OAAO;AACZ,SAAK,aAAa;AAAA,EACpB;AACF;AAGO,SAAS,sBAAsB,OAAyC;AAC7E,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,QAAQ,MAAM,QAAQ,GAAG;AAC/B,MAAI,QAAQ,EAAG,QAAO;AACtB,QAAM,YAAY,MAAM,MAAM,GAAG,KAAK;AACtC,QAAM,YAAY,MAAM,MAAM,QAAQ,CAAC;AACvC,MACE,UAAU,SAAS,gCACnB,CAAC,0BAA0B,KAAK,SAAS,KACzC,CAAC,0BAA0B,KAAK,SAAS,GACzC;AACA,WAAO;AAAA,EACT;AACA,SAAO,EAAE,WAAW,UAAA;AACtB;AAGO,SAAS,mBAAmB,OAAiC;AAClE,SAAO,sBAAsB,KAAK,MAAM;AAC1C;AAGO,SAAS,iBAAiB,EAAE,WAAW,aAAuC;AACnF,SAAO,mBAAmB,mBAAmB,SAAS,CAAC,YAAY,mBAAmB,SAAS,CAAC;AAClG;AAgBA,SAAS,aAAa;AAAA,EACpB;AAAA,EACA;AACF,GAGuC;AACrC,QAAM,SAAiC,CAAA;AACvC,MAAI,cAAc,QAAQ;AAC1B,MAAI,oBAAoB,eAAe;AACvC,SAAO,OAAO,KAAK,MAAM,EAAE,SAAS,IAAI,SAAS;AACnD;AAoBA,eAAsB,oBAAoB;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAsD;AACpD,QAAM,SAAS,sBAAsB,IAAI;AACzC,QAAM,OAAO,SAAS,iBAAiB,MAAM,IAAI;AACjD,MAAI,WAAW,MAAM;AACnB,UAAM,IAAIA,eAAAA,eAAe;AAAA,MACvB,MAAMC,eAAAA,mBAAmB;AAAA,MACzB,SAAS,GAAG,KAAK,UAAU,IAAI,CAAC;AAAA,MAChC,QAAQ;AAAA,MACR;AAAA,IAAA,CACD;AAAA,EACH;AACA,MAAI;AACF,WAAO,MAAMC,cAAAA,gBAA8B,QAAQ,MAAM;AAAA,MACvD,QAAQ;AAAA,MACR,QAAQ,aAAa,EAAE,OAAO,aAAa;AAAA,MAC3C;AAAA,IAAA,CACD;AAAA,EACH,SAAS,OAAO;AACd,QAAIC,eAAAA,iBAAiB,KAAK,KAAK,MAAM,WAAW,KAAK;AACnD,YAAM,IAAI,0BAA0B,MAAM,EAAE,OAAO,OAAO;AAAA,IAC5D;AACA,UAAM;AAAA,EACR;AACF;AAsBO,SAAS,gBACd,MACA,EAAE,OAAO,aAAa,GAAG,QAAA,IAAoC,IACf;AAC9C,QAAM,SAAS,SAAS,OAAO,OAAO,sBAAsB,IAAI;AAChE,SAAOC,cAAAA,cAA4B,SAAS,iBAAiB,MAAM,IAAI,MAAM;AAAA,IAC3E,GAAG;AAAA,IACH,QAAQ,aAAa,EAAE,OAAO,aAAa;AAAA,EAAA,CAC5C;AACH;;;;;;;;;;"}