@athenaintel/react 0.18.0 → 0.20.0

package/dist/collab/index.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const closePolicy = require("./close-policy.cjs");
+const client = require("./client.cjs");
+const mint = require("./mint.cjs");
+const react = require("./react.cjs");
+const shape = require("./shape.cjs");
+exports.WS_CLOSE_AUTH_REVOKED = closePolicy.WS_CLOSE_AUTH_REVOKED;
+exports.WS_CLOSE_DOC_DELETED = closePolicy.WS_CLOSE_DOC_DELETED;
+exports.classifyClose = closePolicy.classifyClose;
+exports.connectGenericDoc = client.connectGenericDoc;
+exports.CollabTokenError = mint.CollabTokenError;
+exports.getAthenaApiBaseUrl = mint.getAthenaApiBaseUrl;
+exports.mintCollabToken = mint.mintCollabToken;
+exports.useGenericDoc = react.useGenericDoc;
+exports.defineDocShape = shape.defineDocShape;
+//# sourceMappingURL=index.cjs.map

package/dist/collab/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}

package/dist/collab/index.js

@@ -0,0 +1,17 @@
+import { WS_CLOSE_AUTH_REVOKED, WS_CLOSE_DOC_DELETED, classifyClose } from "./close-policy.js";
+import { connectGenericDoc } from "./client.js";
+import { CollabTokenError, getAthenaApiBaseUrl, mintCollabToken } from "./mint.js";
+import { useGenericDoc } from "./react.js";
+import { defineDocShape } from "./shape.js";
+export {
+  CollabTokenError,
+  WS_CLOSE_AUTH_REVOKED,
+  WS_CLOSE_DOC_DELETED,
+  classifyClose,
+  connectGenericDoc,
+  defineDocShape,
+  getAthenaApiBaseUrl,
+  mintCollabToken,
+  useGenericDoc
+};
+//# sourceMappingURL=index.js.map

package/dist/collab/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}

package/dist/collab/mint.cjs

@@ -0,0 +1,59 @@
+"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" });
+class CollabTokenError extends Error {
+  constructor(status, message) {
+    super(message);
+    __publicField(this, "status");
+    this.name = "CollabTokenError";
+    this.status = status;
+  }
+}
+function getAuthHeaders(auth) {
+  if (auth.token) {
+    return { Authorization: `Bearer ${auth.token}` };
+  }
+  if (auth.apiKey) {
+    return { "X-API-KEY": auth.apiKey };
+  }
+  return {};
+}
+function getAthenaApiBaseUrl(backendUrl) {
+  return backendUrl.replace(/\/api\/assistant-ui\/?$/, "").replace(/\/api\/v0\/?$/, "").replace(/\/$/, "");
+}
+async function mintCollabToken(args) {
+  const base = getAthenaApiBaseUrl(args.auth.backendUrl);
+  const response = await fetch(
+    `${base}/api/v0/assets/${encodeURIComponent(args.assetId)}/collab-token`,
+    {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...getAuthHeaders(args.auth)
+      },
+      body: JSON.stringify({ access: args.access }),
+      signal: args.signal
+    }
+  );
+  if (!response.ok) {
+    let detail = "";
+    try {
+      const body = await response.json();
+      if (body && typeof body === "object" && "detail" in body) {
+        detail = String(body.detail);
+      }
+    } catch {
+    }
+    throw new CollabTokenError(
+      response.status,
+      detail || `Collab token mint failed with status ${response.status}`
+    );
+  }
+  return await response.json();
+}
+exports.CollabTokenError = CollabTokenError;
+exports.getAthenaApiBaseUrl = getAthenaApiBaseUrl;
+exports.mintCollabToken = mintCollabToken;
+//# sourceMappingURL=mint.cjs.map

package/dist/collab/mint.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mint.cjs","sources":["../../src/collab/mint.ts"],"sourcesContent":["/**\n * Collab-token mint client for Generic Doc assets.\n *\n * Calls `POST /api/v0/assets/{assetId}/collab-token` — the only public surface\n * that issues Keryx capability tokens, allowlisted server-side to the\n * `generic_doc` asset type and admin-only during the initial rollout. Tokens\n * are room-bound and short-lived; `connectGenericDoc` re-mints automatically\n * before expiry.\n */\n\nexport interface CollabAuth {\n  /** Athena API base or any Athena backend URL (e.g. the AthenaProvider `backendUrl`). */\n  backendUrl: string;\n  /** Personal or sandbox API key. Used when no bearer token is provided. */\n  apiKey?: string;\n  /** Per-viewer bearer token. Takes precedence over the API key. */\n  token?: string | null;\n}\n\nexport interface CollabTokenResponse {\n  token: string;\n  access_type: 'r' | 'rw';\n  expires_at_ms: number;\n  ws_url: string;\n  rest_url: string;\n  org: string;\n  doc_id: string;\n  branch: string;\n}\n\nexport class CollabTokenError extends Error {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = 'CollabTokenError';\n    this.status = status;\n  }\n}\n\nfunction getAuthHeaders(auth: CollabAuth): Record<string, string> {\n  if (auth.token) {\n    return { Authorization: `Bearer ${auth.token}` };\n  }\n  if (auth.apiKey) {\n    return { 'X-API-KEY': auth.apiKey };\n  }\n  return {};\n}\n\n/**\n * Trim a nested Athena endpoint back to the API origin. Accepts the\n * AthenaProvider `backendUrl` (`…/api/assistant-ui`), the sandbox\n * `ATHENA_API_URL` convention (`…/api/v0`), or a bare origin.\n */\nexport function getAthenaApiBaseUrl(backendUrl: string): string {\n  return backendUrl\n    .replace(/\\/api\\/assistant-ui\\/?$/, '')\n    .replace(/\\/api\\/v0\\/?$/, '')\n    .replace(/\\/$/, '');\n}\n\nexport async function mintCollabToken(args: {\n  auth: CollabAuth;\n  assetId: string;\n  access: 'view' | 'edit';\n  signal?: AbortSignal;\n}): Promise<CollabTokenResponse> {\n  const base = getAthenaApiBaseUrl(args.auth.backendUrl);\n  const response = await fetch(\n    `${base}/api/v0/assets/${encodeURIComponent(args.assetId)}/collab-token`,\n    {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        ...getAuthHeaders(args.auth),\n      },\n      body: JSON.stringify({ access: args.access }),\n      signal: args.signal,\n    }\n  );\n  if (!response.ok) {\n    let detail = '';\n    try {\n      const body: unknown = await response.json();\n      if (body && typeof body === 'object' && 'detail' in body) {\n        detail = String((body as { detail: unknown }).detail);\n      }\n    } catch {\n      // non-JSON error body; status alone tells the story\n    }\n    throw new CollabTokenError(\n      response.status,\n      detail || `Collab token mint failed with status ${response.status}`\n    );\n  }\n  return (await response.json()) as CollabTokenResponse;\n}\n"],"names":[],"mappings":";;;;;AA8BO,MAAM,yBAAyB,MAAM;AAAA,EAG1C,YAAY,QAAgB,SAAiB;AAC3C,UAAM,OAAO;AAHN;AAIP,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAChB;AACF;AAEA,SAAS,eAAe,MAA0C;AAChE,MAAI,KAAK,OAAO;AACd,WAAO,EAAE,eAAe,UAAU,KAAK,KAAK,GAAA;AAAA,EAC9C;AACA,MAAI,KAAK,QAAQ;AACf,WAAO,EAAE,aAAa,KAAK,OAAA;AAAA,EAC7B;AACA,SAAO,CAAA;AACT;AAOO,SAAS,oBAAoB,YAA4B;AAC9D,SAAO,WACJ,QAAQ,2BAA2B,EAAE,EACrC,QAAQ,iBAAiB,EAAE,EAC3B,QAAQ,OAAO,EAAE;AACtB;AAEA,eAAsB,gBAAgB,MAKL;AAC/B,QAAM,OAAO,oBAAoB,KAAK,KAAK,UAAU;AACrD,QAAM,WAAW,MAAM;AAAA,IACrB,GAAG,IAAI,kBAAkB,mBAAmB,KAAK,OAAO,CAAC;AAAA,IACzD;AAAA,MACE,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG,eAAe,KAAK,IAAI;AAAA,MAAA;AAAA,MAE7B,MAAM,KAAK,UAAU,EAAE,QAAQ,KAAK,QAAQ;AAAA,MAC5C,QAAQ,KAAK;AAAA,IAAA;AAAA,EACf;AAEF,MAAI,CAAC,SAAS,IAAI;AAChB,QAAI,SAAS;AACb,QAAI;AACF,YAAM,OAAgB,MAAM,SAAS,KAAA;AACrC,UAAI,QAAQ,OAAO,SAAS,YAAY,YAAY,MAAM;AACxD,iBAAS,OAAQ,KAA6B,MAAM;AAAA,MACtD;AAAA,IACF,QAAQ;AAAA,IAER;AACA,UAAM,IAAI;AAAA,MACR,SAAS;AAAA,MACT,UAAU,wCAAwC,SAAS,MAAM;AAAA,IAAA;AAAA,EAErE;AACA,SAAQ,MAAM,SAAS,KAAA;AACzB;;;;"}

package/dist/collab/mint.js

@@ -0,0 +1,59 @@
+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);
+class CollabTokenError extends Error {
+  constructor(status, message) {
+    super(message);
+    __publicField(this, "status");
+    this.name = "CollabTokenError";
+    this.status = status;
+  }
+}
+function getAuthHeaders(auth) {
+  if (auth.token) {
+    return { Authorization: `Bearer ${auth.token}` };
+  }
+  if (auth.apiKey) {
+    return { "X-API-KEY": auth.apiKey };
+  }
+  return {};
+}
+function getAthenaApiBaseUrl(backendUrl) {
+  return backendUrl.replace(/\/api\/assistant-ui\/?$/, "").replace(/\/api\/v0\/?$/, "").replace(/\/$/, "");
+}
+async function mintCollabToken(args) {
+  const base = getAthenaApiBaseUrl(args.auth.backendUrl);
+  const response = await fetch(
+    `${base}/api/v0/assets/${encodeURIComponent(args.assetId)}/collab-token`,
+    {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...getAuthHeaders(args.auth)
+      },
+      body: JSON.stringify({ access: args.access }),
+      signal: args.signal
+    }
+  );
+  if (!response.ok) {
+    let detail = "";
+    try {
+      const body = await response.json();
+      if (body && typeof body === "object" && "detail" in body) {
+        detail = String(body.detail);
+      }
+    } catch {
+    }
+    throw new CollabTokenError(
+      response.status,
+      detail || `Collab token mint failed with status ${response.status}`
+    );
+  }
+  return await response.json();
+}
+export {
+  CollabTokenError,
+  getAthenaApiBaseUrl,
+  mintCollabToken
+};
+//# sourceMappingURL=mint.js.map

package/dist/collab/mint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mint.js","sources":["../../src/collab/mint.ts"],"sourcesContent":["/**\n * Collab-token mint client for Generic Doc assets.\n *\n * Calls `POST /api/v0/assets/{assetId}/collab-token` — the only public surface\n * that issues Keryx capability tokens, allowlisted server-side to the\n * `generic_doc` asset type and admin-only during the initial rollout. Tokens\n * are room-bound and short-lived; `connectGenericDoc` re-mints automatically\n * before expiry.\n */\n\nexport interface CollabAuth {\n  /** Athena API base or any Athena backend URL (e.g. the AthenaProvider `backendUrl`). */\n  backendUrl: string;\n  /** Personal or sandbox API key. Used when no bearer token is provided. */\n  apiKey?: string;\n  /** Per-viewer bearer token. Takes precedence over the API key. */\n  token?: string | null;\n}\n\nexport interface CollabTokenResponse {\n  token: string;\n  access_type: 'r' | 'rw';\n  expires_at_ms: number;\n  ws_url: string;\n  rest_url: string;\n  org: string;\n  doc_id: string;\n  branch: string;\n}\n\nexport class CollabTokenError extends Error {\n  readonly status: number;\n\n  constructor(status: number, message: string) {\n    super(message);\n    this.name = 'CollabTokenError';\n    this.status = status;\n  }\n}\n\nfunction getAuthHeaders(auth: CollabAuth): Record<string, string> {\n  if (auth.token) {\n    return { Authorization: `Bearer ${auth.token}` };\n  }\n  if (auth.apiKey) {\n    return { 'X-API-KEY': auth.apiKey };\n  }\n  return {};\n}\n\n/**\n * Trim a nested Athena endpoint back to the API origin. Accepts the\n * AthenaProvider `backendUrl` (`…/api/assistant-ui`), the sandbox\n * `ATHENA_API_URL` convention (`…/api/v0`), or a bare origin.\n */\nexport function getAthenaApiBaseUrl(backendUrl: string): string {\n  return backendUrl\n    .replace(/\\/api\\/assistant-ui\\/?$/, '')\n    .replace(/\\/api\\/v0\\/?$/, '')\n    .replace(/\\/$/, '');\n}\n\nexport async function mintCollabToken(args: {\n  auth: CollabAuth;\n  assetId: string;\n  access: 'view' | 'edit';\n  signal?: AbortSignal;\n}): Promise<CollabTokenResponse> {\n  const base = getAthenaApiBaseUrl(args.auth.backendUrl);\n  const response = await fetch(\n    `${base}/api/v0/assets/${encodeURIComponent(args.assetId)}/collab-token`,\n    {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        ...getAuthHeaders(args.auth),\n      },\n      body: JSON.stringify({ access: args.access }),\n      signal: args.signal,\n    }\n  );\n  if (!response.ok) {\n    let detail = '';\n    try {\n      const body: unknown = await response.json();\n      if (body && typeof body === 'object' && 'detail' in body) {\n        detail = String((body as { detail: unknown }).detail);\n      }\n    } catch {\n      // non-JSON error body; status alone tells the story\n    }\n    throw new CollabTokenError(\n      response.status,\n      detail || `Collab token mint failed with status ${response.status}`\n    );\n  }\n  return (await response.json()) as CollabTokenResponse;\n}\n"],"names":[],"mappings":";;;AA8BO,MAAM,yBAAyB,MAAM;AAAA,EAG1C,YAAY,QAAgB,SAAiB;AAC3C,UAAM,OAAO;AAHN;AAIP,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAChB;AACF;AAEA,SAAS,eAAe,MAA0C;AAChE,MAAI,KAAK,OAAO;AACd,WAAO,EAAE,eAAe,UAAU,KAAK,KAAK,GAAA;AAAA,EAC9C;AACA,MAAI,KAAK,QAAQ;AACf,WAAO,EAAE,aAAa,KAAK,OAAA;AAAA,EAC7B;AACA,SAAO,CAAA;AACT;AAOO,SAAS,oBAAoB,YAA4B;AAC9D,SAAO,WACJ,QAAQ,2BAA2B,EAAE,EACrC,QAAQ,iBAAiB,EAAE,EAC3B,QAAQ,OAAO,EAAE;AACtB;AAEA,eAAsB,gBAAgB,MAKL;AAC/B,QAAM,OAAO,oBAAoB,KAAK,KAAK,UAAU;AACrD,QAAM,WAAW,MAAM;AAAA,IACrB,GAAG,IAAI,kBAAkB,mBAAmB,KAAK,OAAO,CAAC;AAAA,IACzD;AAAA,MACE,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAG,eAAe,KAAK,IAAI;AAAA,MAAA;AAAA,MAE7B,MAAM,KAAK,UAAU,EAAE,QAAQ,KAAK,QAAQ;AAAA,MAC5C,QAAQ,KAAK;AAAA,IAAA;AAAA,EACf;AAEF,MAAI,CAAC,SAAS,IAAI;AAChB,QAAI,SAAS;AACb,QAAI;AACF,YAAM,OAAgB,MAAM,SAAS,KAAA;AACrC,UAAI,QAAQ,OAAO,SAAS,YAAY,YAAY,MAAM;AACxD,iBAAS,OAAQ,KAA6B,MAAM;AAAA,MACtD;AAAA,IACF,QAAQ;AAAA,IAER;AACA,UAAM,IAAI;AAAA,MACR,SAAS;AAAA,MACT,UAAU,wCAAwC,SAAS,MAAM;AAAA,IAAA;AAAA,EAErE;AACA,SAAQ,MAAM,SAAS,KAAA;AACzB;"}

package/dist/collab/react.cjs

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const AthenaContext = require("../provider/AthenaContext.cjs");
+const client = require("./client.cjs");
+function useGenericDoc(assetId, options) {
+  const config = AthenaContext.useAthenaConfig();
+  const access = (options == null ? void 0 : options.access) ?? "view";
+  const [handle, setHandle] = react.useState(null);
+  const handleRef = react.useRef(null);
+  react.useEffect(() => {
+    const next = client.connectGenericDoc({
+      assetId,
+      access,
+      auth: {
+        backendUrl: config.backendUrl,
+        apiKey: config.apiKey,
+        token: config.token
+      }
+    });
+    handleRef.current = next;
+    setHandle(next);
+    return () => {
+      handleRef.current = null;
+      next.destroy();
+    };
+  }, [assetId, access, config.backendUrl, config.apiKey, config.token]);
+  const subscribe = react.useMemo(() => {
+    return (onStoreChange) => {
+      if (!handle) return () => {
+      };
+      return handle.onChange(onStoreChange);
+    };
+  }, [handle]);
+  react.useSyncExternalStore(
+    subscribe,
+    () => {
+      if (!handle) return EMPTY_SNAPSHOT;
+      return `${handle.status}|${handle.synced}|${handle.accessType ?? ""}|${handle.version}`;
+    },
+    () => EMPTY_SNAPSHOT
+  );
+  return {
+    doc: (handle == null ? void 0 : handle.doc) ?? null,
+    status: (handle == null ? void 0 : handle.status) ?? "connecting",
+    synced: (handle == null ? void 0 : handle.synced) ?? false,
+    accessType: (handle == null ? void 0 : handle.accessType) ?? null,
+    error: (handle == null ? void 0 : handle.error) ?? null,
+    presence: (handle == null ? void 0 : handle.getPresence()) ?? [],
+    setPresence: (state) => {
+      var _a;
+      return (_a = handleRef.current) == null ? void 0 : _a.setPresence(state);
+    }
+  };
+}
+const EMPTY_SNAPSHOT = "init|false||0";
+exports.useGenericDoc = useGenericDoc;
+//# sourceMappingURL=react.cjs.map

package/dist/collab/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.cjs","sources":["../../src/collab/react.ts"],"sourcesContent":["/**\n * React bindings for Generic Doc live collaboration.\n *\n * `useGenericDoc(assetId)` opens (and owns) a `connectGenericDoc` handle,\n * resolving auth from the surrounding `AthenaProvider` (per-viewer bearer when\n * present, API key otherwise) and re-rendering on status/presence changes via\n * `useSyncExternalStore`.\n */\n\nimport { useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  type GenericDocHandle,\n  type GenericDocStatus,\n  type PresenceEntry,\n  connectGenericDoc,\n} from './client';\nimport type * as Y from '@y/y';\n\nexport interface UseGenericDocResult {\n  /** Null until the handle is created (first render effect). */\n  doc: Y.Doc | null;\n  status: GenericDocStatus;\n  /**\n   * Whether the initial server sync completed for the current connection —\n   * `status === 'connected'` fires before the server state arrives, so gate\n   * \"is this doc really empty?\" UI on this.\n   */\n  synced: boolean;\n  accessType: 'r' | 'rw' | null;\n  error: Error | null;\n  presence: PresenceEntry[];\n  setPresence: (state: Record<string, unknown> | null) => void;\n}\n\nexport function useGenericDoc(\n  assetId: string,\n  options?: { access?: 'view' | 'edit' }\n): UseGenericDocResult {\n  const config = useAthenaConfig();\n  const access = options?.access ?? 'view';\n  const [handle, setHandle] = useState<GenericDocHandle | null>(null);\n  const handleRef = useRef<GenericDocHandle | null>(null);\n\n  useEffect(() => {\n    const next = connectGenericDoc({\n      assetId,\n      access,\n      auth: {\n        backendUrl: config.backendUrl,\n        apiKey: config.apiKey,\n        token: config.token,\n      },\n    });\n    handleRef.current = next;\n    setHandle(next);\n    return () => {\n      handleRef.current = null;\n      next.destroy();\n    };\n    // Recreate when the target or credentials change; the handle re-mints on\n    // its own schedule otherwise.\n  }, [assetId, access, config.backendUrl, config.apiKey, config.token]);\n\n  const subscribe = useMemo(() => {\n    return (onStoreChange: () => void) => {\n      if (!handle) return () => {};\n      return handle.onChange(onStoreChange);\n    };\n  }, [handle]);\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => {\n      if (!handle) return EMPTY_SNAPSHOT;\n      return `${handle.status}|${handle.synced}|${handle.accessType ?? ''}|${handle.version}`;\n    },\n    () => EMPTY_SNAPSHOT\n  );\n  void snapshot;\n\n  return {\n    doc: handle?.doc ?? null,\n    status: handle?.status ?? 'connecting',\n    synced: handle?.synced ?? false,\n    accessType: handle?.accessType ?? null,\n    error: handle?.error ?? null,\n    presence: handle?.getPresence() ?? [],\n    setPresence: (state) => handleRef.current?.setPresence(state),\n  };\n}\n\nconst EMPTY_SNAPSHOT = 'init|false||0';\n"],"names":["useAthenaConfig","useState","useRef","useEffect","connectGenericDoc","useMemo","useSyncExternalStore"],"mappings":";;;;;AAmCO,SAAS,cACd,SACA,SACqB;AACrB,QAAM,SAASA,cAAAA,gBAAA;AACf,QAAM,UAAS,mCAAS,WAAU;AAClC,QAAM,CAAC,QAAQ,SAAS,IAAIC,MAAAA,SAAkC,IAAI;AAClE,QAAM,YAAYC,MAAAA,OAAgC,IAAI;AAEtDC,QAAAA,UAAU,MAAM;AACd,UAAM,OAAOC,OAAAA,kBAAkB;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,MAAM;AAAA,QACJ,YAAY,OAAO;AAAA,QACnB,QAAQ,OAAO;AAAA,QACf,OAAO,OAAO;AAAA,MAAA;AAAA,IAChB,CACD;AACD,cAAU,UAAU;AACpB,cAAU,IAAI;AACd,WAAO,MAAM;AACX,gBAAU,UAAU;AACpB,WAAK,QAAA;AAAA,IACP;AAAA,EAGF,GAAG,CAAC,SAAS,QAAQ,OAAO,YAAY,OAAO,QAAQ,OAAO,KAAK,CAAC;AAEpE,QAAM,YAAYC,MAAAA,QAAQ,MAAM;AAC9B,WAAO,CAAC,kBAA8B;AACpC,UAAI,CAAC,OAAQ,QAAO,MAAM;AAAA,MAAC;AAC3B,aAAO,OAAO,SAAS,aAAa;AAAA,IACtC;AAAA,EACF,GAAG,CAAC,MAAM,CAAC;AAEMC,QAAAA;AAAAA,IACf;AAAA,IACA,MAAM;AACJ,UAAI,CAAC,OAAQ,QAAO;AACpB,aAAO,GAAG,OAAO,MAAM,IAAI,OAAO,MAAM,IAAI,OAAO,cAAc,EAAE,IAAI,OAAO,OAAO;AAAA,IACvF;AAAA,IACA,MAAM;AAAA,EAAA;AAIR,SAAO;AAAA,IACL,MAAK,iCAAQ,QAAO;AAAA,IACpB,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,aAAY,iCAAQ,eAAc;AAAA,IAClC,QAAO,iCAAQ,UAAS;AAAA,IACxB,WAAU,iCAAQ,kBAAiB,CAAA;AAAA,IACnC,aAAa,CAAC,UAAA;;AAAU,6BAAU,YAAV,mBAAmB,YAAY;AAAA;AAAA,EAAK;AAEhE;AAEA,MAAM,iBAAiB;;"}

package/dist/collab/react.js

@@ -0,0 +1,58 @@
+import { useState, useRef, useEffect, useMemo, useSyncExternalStore } from "react";
+import { useAthenaConfig } from "../provider/AthenaContext.js";
+import { connectGenericDoc } from "./client.js";
+function useGenericDoc(assetId, options) {
+  const config = useAthenaConfig();
+  const access = (options == null ? void 0 : options.access) ?? "view";
+  const [handle, setHandle] = useState(null);
+  const handleRef = useRef(null);
+  useEffect(() => {
+    const next = connectGenericDoc({
+      assetId,
+      access,
+      auth: {
+        backendUrl: config.backendUrl,
+        apiKey: config.apiKey,
+        token: config.token
+      }
+    });
+    handleRef.current = next;
+    setHandle(next);
+    return () => {
+      handleRef.current = null;
+      next.destroy();
+    };
+  }, [assetId, access, config.backendUrl, config.apiKey, config.token]);
+  const subscribe = useMemo(() => {
+    return (onStoreChange) => {
+      if (!handle) return () => {
+      };
+      return handle.onChange(onStoreChange);
+    };
+  }, [handle]);
+  useSyncExternalStore(
+    subscribe,
+    () => {
+      if (!handle) return EMPTY_SNAPSHOT;
+      return `${handle.status}|${handle.synced}|${handle.accessType ?? ""}|${handle.version}`;
+    },
+    () => EMPTY_SNAPSHOT
+  );
+  return {
+    doc: (handle == null ? void 0 : handle.doc) ?? null,
+    status: (handle == null ? void 0 : handle.status) ?? "connecting",
+    synced: (handle == null ? void 0 : handle.synced) ?? false,
+    accessType: (handle == null ? void 0 : handle.accessType) ?? null,
+    error: (handle == null ? void 0 : handle.error) ?? null,
+    presence: (handle == null ? void 0 : handle.getPresence()) ?? [],
+    setPresence: (state) => {
+      var _a;
+      return (_a = handleRef.current) == null ? void 0 : _a.setPresence(state);
+    }
+  };
+}
+const EMPTY_SNAPSHOT = "init|false||0";
+export {
+  useGenericDoc
+};
+//# sourceMappingURL=react.js.map

package/dist/collab/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sources":["../../src/collab/react.ts"],"sourcesContent":["/**\n * React bindings for Generic Doc live collaboration.\n *\n * `useGenericDoc(assetId)` opens (and owns) a `connectGenericDoc` handle,\n * resolving auth from the surrounding `AthenaProvider` (per-viewer bearer when\n * present, API key otherwise) and re-rendering on status/presence changes via\n * `useSyncExternalStore`.\n */\n\nimport { useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  type GenericDocHandle,\n  type GenericDocStatus,\n  type PresenceEntry,\n  connectGenericDoc,\n} from './client';\nimport type * as Y from '@y/y';\n\nexport interface UseGenericDocResult {\n  /** Null until the handle is created (first render effect). */\n  doc: Y.Doc | null;\n  status: GenericDocStatus;\n  /**\n   * Whether the initial server sync completed for the current connection —\n   * `status === 'connected'` fires before the server state arrives, so gate\n   * \"is this doc really empty?\" UI on this.\n   */\n  synced: boolean;\n  accessType: 'r' | 'rw' | null;\n  error: Error | null;\n  presence: PresenceEntry[];\n  setPresence: (state: Record<string, unknown> | null) => void;\n}\n\nexport function useGenericDoc(\n  assetId: string,\n  options?: { access?: 'view' | 'edit' }\n): UseGenericDocResult {\n  const config = useAthenaConfig();\n  const access = options?.access ?? 'view';\n  const [handle, setHandle] = useState<GenericDocHandle | null>(null);\n  const handleRef = useRef<GenericDocHandle | null>(null);\n\n  useEffect(() => {\n    const next = connectGenericDoc({\n      assetId,\n      access,\n      auth: {\n        backendUrl: config.backendUrl,\n        apiKey: config.apiKey,\n        token: config.token,\n      },\n    });\n    handleRef.current = next;\n    setHandle(next);\n    return () => {\n      handleRef.current = null;\n      next.destroy();\n    };\n    // Recreate when the target or credentials change; the handle re-mints on\n    // its own schedule otherwise.\n  }, [assetId, access, config.backendUrl, config.apiKey, config.token]);\n\n  const subscribe = useMemo(() => {\n    return (onStoreChange: () => void) => {\n      if (!handle) return () => {};\n      return handle.onChange(onStoreChange);\n    };\n  }, [handle]);\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => {\n      if (!handle) return EMPTY_SNAPSHOT;\n      return `${handle.status}|${handle.synced}|${handle.accessType ?? ''}|${handle.version}`;\n    },\n    () => EMPTY_SNAPSHOT\n  );\n  void snapshot;\n\n  return {\n    doc: handle?.doc ?? null,\n    status: handle?.status ?? 'connecting',\n    synced: handle?.synced ?? false,\n    accessType: handle?.accessType ?? null,\n    error: handle?.error ?? null,\n    presence: handle?.getPresence() ?? [],\n    setPresence: (state) => handleRef.current?.setPresence(state),\n  };\n}\n\nconst EMPTY_SNAPSHOT = 'init|false||0';\n"],"names":[],"mappings":";;;AAmCO,SAAS,cACd,SACA,SACqB;AACrB,QAAM,SAAS,gBAAA;AACf,QAAM,UAAS,mCAAS,WAAU;AAClC,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAkC,IAAI;AAClE,QAAM,YAAY,OAAgC,IAAI;AAEtD,YAAU,MAAM;AACd,UAAM,OAAO,kBAAkB;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,MAAM;AAAA,QACJ,YAAY,OAAO;AAAA,QACnB,QAAQ,OAAO;AAAA,QACf,OAAO,OAAO;AAAA,MAAA;AAAA,IAChB,CACD;AACD,cAAU,UAAU;AACpB,cAAU,IAAI;AACd,WAAO,MAAM;AACX,gBAAU,UAAU;AACpB,WAAK,QAAA;AAAA,IACP;AAAA,EAGF,GAAG,CAAC,SAAS,QAAQ,OAAO,YAAY,OAAO,QAAQ,OAAO,KAAK,CAAC;AAEpE,QAAM,YAAY,QAAQ,MAAM;AAC9B,WAAO,CAAC,kBAA8B;AACpC,UAAI,CAAC,OAAQ,QAAO,MAAM;AAAA,MAAC;AAC3B,aAAO,OAAO,SAAS,aAAa;AAAA,IACtC;AAAA,EACF,GAAG,CAAC,MAAM,CAAC;AAEM;AAAA,IACf;AAAA,IACA,MAAM;AACJ,UAAI,CAAC,OAAQ,QAAO;AACpB,aAAO,GAAG,OAAO,MAAM,IAAI,OAAO,MAAM,IAAI,OAAO,cAAc,EAAE,IAAI,OAAO,OAAO;AAAA,IACvF;AAAA,IACA,MAAM;AAAA,EAAA;AAIR,SAAO;AAAA,IACL,MAAK,iCAAQ,QAAO;AAAA,IACpB,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,aAAY,iCAAQ,eAAc;AAAA,IAClC,QAAO,iCAAQ,UAAS;AAAA,IACxB,WAAU,iCAAQ,kBAAiB,CAAA;AAAA,IACnC,aAAa,CAAC,UAAA;;AAAU,6BAAU,YAAV,mBAAmB,YAAY;AAAA;AAAA,EAAK;AAEhE;AAEA,MAAM,iBAAiB;"}

package/dist/collab/shape.cjs

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function defineDocShape(shape) {
+  const keys = Object.keys(shape);
+  return {
+    shape,
+    bind(doc) {
+      const toJSON = () => {
+        const out = {};
+        for (const key of keys) {
+          out[key] = doc.get(key).toJSON();
+        }
+        return out;
+      };
+      return {
+        get: (key) => doc.get(key),
+        toJSON,
+        subscribe: (listener) => {
+          let scheduled = false;
+          const emit = () => {
+            scheduled = false;
+            listener(toJSON());
+          };
+          const onDeepChange = () => {
+            if (scheduled) return;
+            scheduled = true;
+            queueMicrotask(emit);
+          };
+          const roots = keys.map((key) => doc.get(key));
+          for (const root of roots) {
+            root.observeDeep(onDeepChange);
+          }
+          listener(toJSON());
+          return () => {
+            for (const root of roots) {
+              root.unobserveDeep(onDeepChange);
+            }
+          };
+        }
+      };
+    }
+  };
+}
+exports.defineDocShape = defineDocShape;
+//# sourceMappingURL=shape.cjs.map

package/dist/collab/shape.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.cjs","sources":["../../src/collab/shape.ts"],"sourcesContent":["/**\n * `defineDocShape` — a typed lens over a Generic Doc's root types.\n *\n * A shape is documentation + ergonomics, not a migration system: it names the\n * root keys an app expects and gives JSON-level reads (`toJSON`, `subscribe`)\n * that hide CRDT mechanics for the common case. The raw `Y.Doc` (yjs v14 /\n * `@y/y`) stays available on the handle for full delta-level power.\n */\n\nimport type * as Y from '@y/y';\n\nexport type DocShapeKind = 'map' | 'array' | 'text' | 'xml';\n\nexport interface BoundDocShape<S extends Record<string, DocShapeKind>> {\n  /** The live root type for a declared key (v14 unified `YType`). */\n  get: <K extends keyof S & string>(key: K) => ReturnType<Y.Doc['get']>;\n  /** JSON snapshot of every declared root (v14 node shape: attributes + `children`). */\n  toJSON: () => Record<keyof S & string, unknown>;\n  /**\n   * Subscribe to JSON snapshots. Fires once immediately, then after every\n   * change to any declared root (batched per transaction flush).\n   */\n  subscribe: (listener: (json: Record<keyof S & string, unknown>) => void) => () => void;\n}\n\nexport function defineDocShape<S extends Record<string, DocShapeKind>>(shape: S) {\n  const keys = Object.keys(shape) as Array<keyof S & string>;\n  return {\n    shape,\n    bind(doc: Y.Doc): BoundDocShape<S> {\n      const toJSON = () => {\n        const out: Record<string, unknown> = {};\n        for (const key of keys) {\n          out[key] = doc.get(key).toJSON();\n        }\n        return out as Record<keyof S & string, unknown>;\n      };\n      return {\n        get: (key) => doc.get(key),\n        toJSON,\n        subscribe: (listener) => {\n          let scheduled = false;\n          const emit = () => {\n            scheduled = false;\n            listener(toJSON());\n          };\n          const onDeepChange = () => {\n            if (scheduled) return;\n            scheduled = true;\n            queueMicrotask(emit);\n          };\n          const roots = keys.map((key) => doc.get(key));\n          for (const root of roots) {\n            root.observeDeep(onDeepChange);\n          }\n          listener(toJSON());\n          return () => {\n            for (const root of roots) {\n              root.unobserveDeep(onDeepChange);\n            }\n          };\n        },\n      };\n    },\n  };\n}\n"],"names":[],"mappings":";;AAyBO,SAAS,eAAuD,OAAU;AAC/E,QAAM,OAAO,OAAO,KAAK,KAAK;AAC9B,SAAO;AAAA,IACL;AAAA,IACA,KAAK,KAA8B;AACjC,YAAM,SAAS,MAAM;AACnB,cAAM,MAA+B,CAAA;AACrC,mBAAW,OAAO,MAAM;AACtB,cAAI,GAAG,IAAI,IAAI,IAAI,GAAG,EAAE,OAAA;AAAA,QAC1B;AACA,eAAO;AAAA,MACT;AACA,aAAO;AAAA,QACL,KAAK,CAAC,QAAQ,IAAI,IAAI,GAAG;AAAA,QACzB;AAAA,QACA,WAAW,CAAC,aAAa;AACvB,cAAI,YAAY;AAChB,gBAAM,OAAO,MAAM;AACjB,wBAAY;AACZ,qBAAS,QAAQ;AAAA,UACnB;AACA,gBAAM,eAAe,MAAM;AACzB,gBAAI,UAAW;AACf,wBAAY;AACZ,2BAAe,IAAI;AAAA,UACrB;AACA,gBAAM,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,CAAC;AAC5C,qBAAW,QAAQ,OAAO;AACxB,iBAAK,YAAY,YAAY;AAAA,UAC/B;AACA,mBAAS,QAAQ;AACjB,iBAAO,MAAM;AACX,uBAAW,QAAQ,OAAO;AACxB,mBAAK,cAAc,YAAY;AAAA,YACjC;AAAA,UACF;AAAA,QACF;AAAA,MAAA;AAAA,IAEJ;AAAA,EAAA;AAEJ;;"}

package/dist/collab/shape.js

@@ -0,0 +1,45 @@
+function defineDocShape(shape) {
+  const keys = Object.keys(shape);
+  return {
+    shape,
+    bind(doc) {
+      const toJSON = () => {
+        const out = {};
+        for (const key of keys) {
+          out[key] = doc.get(key).toJSON();
+        }
+        return out;
+      };
+      return {
+        get: (key) => doc.get(key),
+        toJSON,
+        subscribe: (listener) => {
+          let scheduled = false;
+          const emit = () => {
+            scheduled = false;
+            listener(toJSON());
+          };
+          const onDeepChange = () => {
+            if (scheduled) return;
+            scheduled = true;
+            queueMicrotask(emit);
+          };
+          const roots = keys.map((key) => doc.get(key));
+          for (const root of roots) {
+            root.observeDeep(onDeepChange);
+          }
+          listener(toJSON());
+          return () => {
+            for (const root of roots) {
+              root.unobserveDeep(onDeepChange);
+            }
+          };
+        }
+      };
+    }
+  };
+}
+export {
+  defineDocShape
+};
+//# sourceMappingURL=shape.js.map

package/dist/collab/shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.js","sources":["../../src/collab/shape.ts"],"sourcesContent":["/**\n * `defineDocShape` — a typed lens over a Generic Doc's root types.\n *\n * A shape is documentation + ergonomics, not a migration system: it names the\n * root keys an app expects and gives JSON-level reads (`toJSON`, `subscribe`)\n * that hide CRDT mechanics for the common case. The raw `Y.Doc` (yjs v14 /\n * `@y/y`) stays available on the handle for full delta-level power.\n */\n\nimport type * as Y from '@y/y';\n\nexport type DocShapeKind = 'map' | 'array' | 'text' | 'xml';\n\nexport interface BoundDocShape<S extends Record<string, DocShapeKind>> {\n  /** The live root type for a declared key (v14 unified `YType`). */\n  get: <K extends keyof S & string>(key: K) => ReturnType<Y.Doc['get']>;\n  /** JSON snapshot of every declared root (v14 node shape: attributes + `children`). */\n  toJSON: () => Record<keyof S & string, unknown>;\n  /**\n   * Subscribe to JSON snapshots. Fires once immediately, then after every\n   * change to any declared root (batched per transaction flush).\n   */\n  subscribe: (listener: (json: Record<keyof S & string, unknown>) => void) => () => void;\n}\n\nexport function defineDocShape<S extends Record<string, DocShapeKind>>(shape: S) {\n  const keys = Object.keys(shape) as Array<keyof S & string>;\n  return {\n    shape,\n    bind(doc: Y.Doc): BoundDocShape<S> {\n      const toJSON = () => {\n        const out: Record<string, unknown> = {};\n        for (const key of keys) {\n          out[key] = doc.get(key).toJSON();\n        }\n        return out as Record<keyof S & string, unknown>;\n      };\n      return {\n        get: (key) => doc.get(key),\n        toJSON,\n        subscribe: (listener) => {\n          let scheduled = false;\n          const emit = () => {\n            scheduled = false;\n            listener(toJSON());\n          };\n          const onDeepChange = () => {\n            if (scheduled) return;\n            scheduled = true;\n            queueMicrotask(emit);\n          };\n          const roots = keys.map((key) => doc.get(key));\n          for (const root of roots) {\n            root.observeDeep(onDeepChange);\n          }\n          listener(toJSON());\n          return () => {\n            for (const root of roots) {\n              root.unobserveDeep(onDeepChange);\n            }\n          };\n        },\n      };\n    },\n  };\n}\n"],"names":[],"mappings":"AAyBO,SAAS,eAAuD,OAAU;AAC/E,QAAM,OAAO,OAAO,KAAK,KAAK;AAC9B,SAAO;AAAA,IACL;AAAA,IACA,KAAK,KAA8B;AACjC,YAAM,SAAS,MAAM;AACnB,cAAM,MAA+B,CAAA;AACrC,mBAAW,OAAO,MAAM;AACtB,cAAI,GAAG,IAAI,IAAI,IAAI,GAAG,EAAE,OAAA;AAAA,QAC1B;AACA,eAAO;AAAA,MACT;AACA,aAAO;AAAA,QACL,KAAK,CAAC,QAAQ,IAAI,IAAI,GAAG;AAAA,QACzB;AAAA,QACA,WAAW,CAAC,aAAa;AACvB,cAAI,YAAY;AAChB,gBAAM,OAAO,MAAM;AACjB,wBAAY;AACZ,qBAAS,QAAQ;AAAA,UACnB;AACA,gBAAM,eAAe,MAAM;AACzB,gBAAI,UAAW;AACf,wBAAY;AACZ,2BAAe,IAAI;AAAA,UACrB;AACA,gBAAM,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,CAAC;AAC5C,qBAAW,QAAQ,OAAO;AACxB,iBAAK,YAAY,YAAY;AAAA,UAC/B;AACA,mBAAS,QAAQ;AACjB,iBAAO,MAAM;AACX,uBAAW,QAAQ,OAAO;AACxB,mBAAK,cAAc,YAAY;AAAA,YACjC;AAAA,UACF;AAAA,QACF;AAAA,MAAA;AAAA,IAEJ;AAAA,EAAA;AAEJ;"}

package/dist/composer/AttachmentContext.cjs

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const athenaUrls = require("../lib/athena-urls.cjs");
+const AttachmentCtx = react.createContext(null);
+function AttachmentProvider({ children }) {
+  const [attachments, setAttachments] = react.useState([]);
+  const [isUploading, setIsUploading] = react.useState(false);
+  const addAttachments = react.useCallback((assets) => {
+    setAttachments((prev) => [...prev, ...assets]);
+  }, []);
+  const removeAttachment = react.useCallback((id) => {
+    setAttachments((prev) => prev.filter((a) => a.id !== id));
+  }, []);
+  const clearAttachments = react.useCallback(() => setAttachments([]), []);
+  const value = react.useMemo(
+    () => ({ attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading }),
+    [attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(AttachmentCtx.Provider, { value, children });
+}
+function useAttachments() {
+  const ctx = react.useContext(AttachmentCtx);
+  if (!ctx) {
+    throw new Error("[AthenaSDK] useAttachments must be used within <AttachmentProvider>");
+  }
+  return ctx;
+}
+function buildAttachmentMarkdownWithAppUrl({
+  attachments,
+  appUrl = athenaUrls.DEFAULT_APP_URL
+}) {
+  if (attachments.length === 0) return "";
+  return attachments.map((attachment) => `[@${attachment.title}](${athenaUrls.createAthenaSpacesUrl({ appUrl, assetIds: attachment.id })})`).join("\n");
+}
+exports.AttachmentProvider = AttachmentProvider;
+exports.buildAttachmentMarkdownWithAppUrl = buildAttachmentMarkdownWithAppUrl;
+exports.useAttachments = useAttachments;
+//# sourceMappingURL=AttachmentContext.cjs.map

package/dist/composer/AttachmentContext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentContext.cjs","sources":["../../src/composer/AttachmentContext.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useMemo, useState, type ReactNode } from 'react';\nimport { createAthenaSpacesUrl, DEFAULT_APP_URL } from '../lib/athena-urls';\nimport type { UploadedAsset } from './useFileUpload';\n\ninterface AttachmentContextValue {\n  attachments: UploadedAsset[];\n  addAttachments: (assets: UploadedAsset[]) => void;\n  removeAttachment: (id: string) => void;\n  clearAttachments: () => void;\n  /** True when one or more files are currently being uploaded. */\n  isUploading: boolean;\n  setIsUploading: (v: boolean) => void;\n}\n\nconst AttachmentCtx = createContext<AttachmentContextValue | null>(null);\n\nexport function AttachmentProvider({ children }: { children: ReactNode }) {\n  const [attachments, setAttachments] = useState<UploadedAsset[]>([]);\n  const [isUploading, setIsUploading] = useState(false);\n\n  const addAttachments = useCallback((assets: UploadedAsset[]) => {\n    setAttachments((prev) => [...prev, ...assets]);\n  }, []);\n\n  const removeAttachment = useCallback((id: string) => {\n    setAttachments((prev) => prev.filter((a) => a.id !== id));\n  }, []);\n\n  const clearAttachments = useCallback(() => setAttachments([]), []);\n\n  const value = useMemo(\n    () => ({ attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading }),\n    [attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading],\n  );\n\n  return (\n    <AttachmentCtx.Provider value={value}>\n      {children}\n    </AttachmentCtx.Provider>\n  );\n}\n\nexport function useAttachments(): AttachmentContextValue {\n  const ctx = useContext(AttachmentCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAttachments must be used within <AttachmentProvider>');\n  }\n  return ctx;\n}\n\n/**\n * Build the markdown references for the current attachments.\n * Returns empty string if no attachments.\n *\n * @deprecated Use `buildAttachmentMarkdownWithAppUrl` to avoid defaulting links to the production Athena app URL.\n */\nexport function buildAttachmentMarkdown(attachments: UploadedAsset[]): string {\n  return buildAttachmentMarkdownWithAppUrl({ attachments });\n}\n\nexport function buildAttachmentMarkdownWithAppUrl({\n  attachments,\n  appUrl = DEFAULT_APP_URL,\n}: {\n  attachments: UploadedAsset[];\n  appUrl?: string;\n}): string {\n  if (attachments.length === 0) return '';\n  return attachments\n    .map((attachment) => `[@${attachment.title}](${createAthenaSpacesUrl({ appUrl, assetIds: attachment.id })})`)\n    .join('\\n');\n}\n"],"names":["createContext","useState","useCallback","useMemo","jsx","useContext","DEFAULT_APP_URL","createAthenaSpacesUrl"],"mappings":";;;;;AAcA,MAAM,gBAAgBA,MAAAA,cAA6C,IAAI;AAEhE,SAAS,mBAAmB,EAAE,YAAqC;AACxE,QAAM,CAAC,aAAa,cAAc,IAAIC,MAAAA,SAA0B,CAAA,CAAE;AAClE,QAAM,CAAC,aAAa,cAAc,IAAIA,MAAAA,SAAS,KAAK;AAEpD,QAAM,iBAAiBC,kBAAY,CAAC,WAA4B;AAC9D,mBAAe,CAAC,SAAS,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;AAAA,EAC/C,GAAG,CAAA,CAAE;AAEL,QAAM,mBAAmBA,kBAAY,CAAC,OAAe;AACnD,mBAAe,CAAC,SAAS,KAAK,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAAA,EAC1D,GAAG,CAAA,CAAE;AAEL,QAAM,mBAAmBA,MAAAA,YAAY,MAAM,eAAe,CAAA,CAAE,GAAG,CAAA,CAAE;AAEjE,QAAM,QAAQC,MAAAA;AAAAA,IACZ,OAAO,EAAE,aAAa,gBAAgB,kBAAkB,kBAAkB,aAAa;IACvF,CAAC,aAAa,gBAAgB,kBAAkB,kBAAkB,aAAa,cAAc;AAAA,EAAA;AAG/F,SACEC,2BAAAA,IAAC,cAAc,UAAd,EAAuB,OACrB,SAAA,CACH;AAEJ;AAEO,SAAS,iBAAyC;AACvD,QAAM,MAAMC,MAAAA,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qEAAqE;AAAA,EACvF;AACA,SAAO;AACT;AAYO,SAAS,kCAAkC;AAAA,EAChD;AAAA,EACA,SAASC,WAAAA;AACX,GAGW;AACT,MAAI,YAAY,WAAW,EAAG,QAAO;AACrC,SAAO,YACJ,IAAI,CAAC,eAAe,KAAK,WAAW,KAAK,KAAKC,WAAAA,sBAAsB,EAAE,QAAQ,UAAU,WAAW,GAAA,CAAI,CAAC,GAAG,EAC3G,KAAK,IAAI;AACd;;;;"}

package/dist/composer/AttachmentContext.js

@@ -0,0 +1,40 @@
+import { jsx } from "react/jsx-runtime";
+import { useState, useCallback, useMemo, useContext, createContext } from "react";
+import { createAthenaSpacesUrl, DEFAULT_APP_URL } from "../lib/athena-urls.js";
+const AttachmentCtx = createContext(null);
+function AttachmentProvider({ children }) {
+  const [attachments, setAttachments] = useState([]);
+  const [isUploading, setIsUploading] = useState(false);
+  const addAttachments = useCallback((assets) => {
+    setAttachments((prev) => [...prev, ...assets]);
+  }, []);
+  const removeAttachment = useCallback((id) => {
+    setAttachments((prev) => prev.filter((a) => a.id !== id));
+  }, []);
+  const clearAttachments = useCallback(() => setAttachments([]), []);
+  const value = useMemo(
+    () => ({ attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading }),
+    [attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading]
+  );
+  return /* @__PURE__ */ jsx(AttachmentCtx.Provider, { value, children });
+}
+function useAttachments() {
+  const ctx = useContext(AttachmentCtx);
+  if (!ctx) {
+    throw new Error("[AthenaSDK] useAttachments must be used within <AttachmentProvider>");
+  }
+  return ctx;
+}
+function buildAttachmentMarkdownWithAppUrl({
+  attachments,
+  appUrl = DEFAULT_APP_URL
+}) {
+  if (attachments.length === 0) return "";
+  return attachments.map((attachment) => `[@${attachment.title}](${createAthenaSpacesUrl({ appUrl, assetIds: attachment.id })})`).join("\n");
+}
+export {
+  AttachmentProvider,
+  buildAttachmentMarkdownWithAppUrl,
+  useAttachments
+};
+//# sourceMappingURL=AttachmentContext.js.map

package/dist/composer/AttachmentContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttachmentContext.js","sources":["../../src/composer/AttachmentContext.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useMemo, useState, type ReactNode } from 'react';\nimport { createAthenaSpacesUrl, DEFAULT_APP_URL } from '../lib/athena-urls';\nimport type { UploadedAsset } from './useFileUpload';\n\ninterface AttachmentContextValue {\n  attachments: UploadedAsset[];\n  addAttachments: (assets: UploadedAsset[]) => void;\n  removeAttachment: (id: string) => void;\n  clearAttachments: () => void;\n  /** True when one or more files are currently being uploaded. */\n  isUploading: boolean;\n  setIsUploading: (v: boolean) => void;\n}\n\nconst AttachmentCtx = createContext<AttachmentContextValue | null>(null);\n\nexport function AttachmentProvider({ children }: { children: ReactNode }) {\n  const [attachments, setAttachments] = useState<UploadedAsset[]>([]);\n  const [isUploading, setIsUploading] = useState(false);\n\n  const addAttachments = useCallback((assets: UploadedAsset[]) => {\n    setAttachments((prev) => [...prev, ...assets]);\n  }, []);\n\n  const removeAttachment = useCallback((id: string) => {\n    setAttachments((prev) => prev.filter((a) => a.id !== id));\n  }, []);\n\n  const clearAttachments = useCallback(() => setAttachments([]), []);\n\n  const value = useMemo(\n    () => ({ attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading }),\n    [attachments, addAttachments, removeAttachment, clearAttachments, isUploading, setIsUploading],\n  );\n\n  return (\n    <AttachmentCtx.Provider value={value}>\n      {children}\n    </AttachmentCtx.Provider>\n  );\n}\n\nexport function useAttachments(): AttachmentContextValue {\n  const ctx = useContext(AttachmentCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAttachments must be used within <AttachmentProvider>');\n  }\n  return ctx;\n}\n\n/**\n * Build the markdown references for the current attachments.\n * Returns empty string if no attachments.\n *\n * @deprecated Use `buildAttachmentMarkdownWithAppUrl` to avoid defaulting links to the production Athena app URL.\n */\nexport function buildAttachmentMarkdown(attachments: UploadedAsset[]): string {\n  return buildAttachmentMarkdownWithAppUrl({ attachments });\n}\n\nexport function buildAttachmentMarkdownWithAppUrl({\n  attachments,\n  appUrl = DEFAULT_APP_URL,\n}: {\n  attachments: UploadedAsset[];\n  appUrl?: string;\n}): string {\n  if (attachments.length === 0) return '';\n  return attachments\n    .map((attachment) => `[@${attachment.title}](${createAthenaSpacesUrl({ appUrl, assetIds: attachment.id })})`)\n    .join('\\n');\n}\n"],"names":[],"mappings":";;;AAcA,MAAM,gBAAgB,cAA6C,IAAI;AAEhE,SAAS,mBAAmB,EAAE,YAAqC;AACxE,QAAM,CAAC,aAAa,cAAc,IAAI,SAA0B,CAAA,CAAE;AAClE,QAAM,CAAC,aAAa,cAAc,IAAI,SAAS,KAAK;AAEpD,QAAM,iBAAiB,YAAY,CAAC,WAA4B;AAC9D,mBAAe,CAAC,SAAS,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;AAAA,EAC/C,GAAG,CAAA,CAAE;AAEL,QAAM,mBAAmB,YAAY,CAAC,OAAe;AACnD,mBAAe,CAAC,SAAS,KAAK,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AAAA,EAC1D,GAAG,CAAA,CAAE;AAEL,QAAM,mBAAmB,YAAY,MAAM,eAAe,CAAA,CAAE,GAAG,CAAA,CAAE;AAEjE,QAAM,QAAQ;AAAA,IACZ,OAAO,EAAE,aAAa,gBAAgB,kBAAkB,kBAAkB,aAAa;IACvF,CAAC,aAAa,gBAAgB,kBAAkB,kBAAkB,aAAa,cAAc;AAAA,EAAA;AAG/F,SACE,oBAAC,cAAc,UAAd,EAAuB,OACrB,SAAA,CACH;AAEJ;AAEO,SAAS,iBAAyC;AACvD,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,qEAAqE;AAAA,EACvF;AACA,SAAO;AACT;AAYO,SAAS,kCAAkC;AAAA,EAChD;AAAA,EACA,SAAS;AACX,GAGW;AACT,MAAI,YAAY,WAAW,EAAG,QAAO;AACrC,SAAO,YACJ,IAAI,CAAC,eAAe,KAAK,WAAW,KAAK,KAAK,sBAAsB,EAAE,QAAQ,UAAU,WAAW,GAAA,CAAI,CAAC,GAAG,EAC3G,KAAK,IAAI;AACd;"}

package/dist/composer/ComposerAttachmentPreview.cjs

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const lucideReact = require("lucide-react");
+const AttachmentContext = require("./AttachmentContext.cjs");
+const cnfast = require("cnfast");
+const ComposerAttachmentPreview = ({ className }) => {
+  const { attachments, isUploading, removeAttachment } = AttachmentContext.useAttachments();
+  if (attachments.length === 0 && !isUploading) return null;
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cnfast.cn("aui-attachment-preview mx-3 mt-2 flex flex-wrap gap-1.5", className), children: [
+    attachments.map((asset) => /* @__PURE__ */ jsxRuntime.jsxs(
+      "div",
+      {
+        className: "flex items-center gap-1.5 rounded-lg border border-border/60 bg-muted/40 px-2.5 py-1.5 text-xs",
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx(lucideReact.PaperclipIcon, { className: "size-3 shrink-0 text-muted-foreground/60" }),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "max-w-[180px] truncate text-foreground/80", children: asset.title }),
+          /* @__PURE__ */ jsxRuntime.jsx(
+            "button",
+            {
+              type: "button",
+              onClick: () => removeAttachment(asset.id),
+              className: "shrink-0 rounded p-0.5 text-muted-foreground hover:bg-muted hover:text-foreground transition-colors",
+              "aria-label": `Remove ${asset.title}`,
+              children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.XIcon, { className: "size-3" })
+            }
+          )
+        ]
+      },
+      asset.id
+    )),
+    isUploading ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-1.5 rounded-lg border border-border/60 bg-muted/40 px-2.5 py-1.5 text-xs text-muted-foreground", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Loader2Icon, { className: "size-3 shrink-0 animate-spin" }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { children: "Uploading..." })
+    ] }) : null
+  ] });
+};
+exports.ComposerAttachmentPreview = ComposerAttachmentPreview;
+//# sourceMappingURL=ComposerAttachmentPreview.cjs.map

package/dist/composer/ComposerAttachmentPreview.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerAttachmentPreview.cjs","sources":["../../src/composer/ComposerAttachmentPreview.tsx"],"sourcesContent":["import { Loader2Icon, PaperclipIcon, XIcon } from 'lucide-react';\nimport type { FC } from 'react';\nimport { useAttachments } from './AttachmentContext';\nimport { cn } from '../lib/utils';\n\nexport interface ComposerAttachmentPreviewProps {\n  className?: string;\n}\n\n/**\n * Renders uploaded file pills above the composer.\n * Each pill shows the file name and a dismiss button.\n */\nexport const ComposerAttachmentPreview: FC<ComposerAttachmentPreviewProps> = ({ className }) => {\n  const { attachments, isUploading, removeAttachment } = useAttachments();\n\n  if (attachments.length === 0 && !isUploading) return null;\n\n  return (\n    <div className={cn('aui-attachment-preview mx-3 mt-2 flex flex-wrap gap-1.5', className)}>\n      {attachments.map((asset) => (\n        <div\n          key={asset.id}\n          className=\"flex items-center gap-1.5 rounded-lg border border-border/60 bg-muted/40 px-2.5 py-1.5 text-xs\"\n        >\n          <PaperclipIcon className=\"size-3 shrink-0 text-muted-foreground/60\" />\n          <span className=\"max-w-[180px] truncate text-foreground/80\">{asset.title}</span>\n          <button\n            type=\"button\"\n            onClick={() => removeAttachment(asset.id)}\n            className=\"shrink-0 rounded p-0.5 text-muted-foreground hover:bg-muted hover:text-foreground transition-colors\"\n            aria-label={`Remove ${asset.title}`}\n          >\n            <XIcon className=\"size-3\" />\n          </button>\n        </div>\n      ))}\n      {isUploading ? (\n        <div className=\"flex items-center gap-1.5 rounded-lg border border-border/60 bg-muted/40 px-2.5 py-1.5 text-xs text-muted-foreground\">\n          <Loader2Icon className=\"size-3 shrink-0 animate-spin\" />\n          <span>Uploading...</span>\n        </div>\n      ) : null}\n    </div>\n  );\n};\n"],"names":["useAttachments","cn","jsxs","jsx","PaperclipIcon","XIcon","Loader2Icon"],"mappings":";;;;;;AAaO,MAAM,4BAAgE,CAAC,EAAE,gBAAgB;AAC9F,QAAM,EAAE,aAAa,aAAa,iBAAA,IAAqBA,kBAAAA,eAAA;AAEvD,MAAI,YAAY,WAAW,KAAK,CAAC,YAAa,QAAO;AAErD,yCACG,OAAA,EAAI,WAAWC,OAAAA,GAAG,2DAA2D,SAAS,GACpF,UAAA;AAAA,IAAA,YAAY,IAAI,CAAC,UAChBC,2BAAAA;AAAAA,MAAC;AAAA,MAAA;AAAA,QAEC,WAAU;AAAA,QAEV,UAAA;AAAA,UAAAC,2BAAAA,IAACC,YAAAA,eAAA,EAAc,WAAU,2CAAA,CAA2C;AAAA,UACpED,2BAAAA,IAAC,QAAA,EAAK,WAAU,6CAA6C,gBAAM,OAAM;AAAA,UACzEA,2BAAAA;AAAAA,YAAC;AAAA,YAAA;AAAA,cACC,MAAK;AAAA,cACL,SAAS,MAAM,iBAAiB,MAAM,EAAE;AAAA,cACxC,WAAU;AAAA,cACV,cAAY,UAAU,MAAM,KAAK;AAAA,cAEjC,UAAAA,2BAAAA,IAACE,YAAAA,OAAA,EAAM,WAAU,SAAA,CAAS;AAAA,YAAA;AAAA,UAAA;AAAA,QAC5B;AAAA,MAAA;AAAA,MAZK,MAAM;AAAA,IAAA,CAcd;AAAA,IACA,cACCH,2BAAAA,KAAC,OAAA,EAAI,WAAU,wHACb,UAAA;AAAA,MAAAC,2BAAAA,IAACG,YAAAA,aAAA,EAAY,WAAU,+BAAA,CAA+B;AAAA,MACtDH,2BAAAA,IAAC,UAAK,UAAA,eAAA,CAAY;AAAA,IAAA,EAAA,CACpB,IACE;AAAA,EAAA,GACN;AAEJ;;"}

package/dist/composer/ComposerAttachmentPreview.js

@@ -0,0 +1,39 @@
+import { jsxs, jsx } from "react/jsx-runtime";
+import { PaperclipIcon, XIcon, Loader2Icon } from "lucide-react";
+import { useAttachments } from "./AttachmentContext.js";
+import { cn } from "cnfast";
+const ComposerAttachmentPreview = ({ className }) => {
+  const { attachments, isUploading, removeAttachment } = useAttachments();
+  if (attachments.length === 0 && !isUploading) return null;
+  return /* @__PURE__ */ jsxs("div", { className: cn("aui-attachment-preview mx-3 mt-2 flex flex-wrap gap-1.5", className), children: [
+    attachments.map((asset) => /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "flex items-center gap-1.5 rounded-lg border border-border/60 bg-muted/40 px-2.5 py-1.5 text-xs",
+        children: [
+          /* @__PURE__ */ jsx(PaperclipIcon, { className: "size-3 shrink-0 text-muted-foreground/60" }),
+          /* @__PURE__ */ jsx("span", { className: "max-w-[180px] truncate text-foreground/80", children: asset.title }),
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              onClick: () => removeAttachment(asset.id),
+              className: "shrink-0 rounded p-0.5 text-muted-foreground hover:bg-muted hover:text-foreground transition-colors",
+              "aria-label": `Remove ${asset.title}`,
+              children: /* @__PURE__ */ jsx(XIcon, { className: "size-3" })
+            }
+          )
+        ]
+      },
+      asset.id
+    )),
+    isUploading ? /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-1.5 rounded-lg border border-border/60 bg-muted/40 px-2.5 py-1.5 text-xs text-muted-foreground", children: [
+      /* @__PURE__ */ jsx(Loader2Icon, { className: "size-3 shrink-0 animate-spin" }),
+      /* @__PURE__ */ jsx("span", { children: "Uploading..." })
+    ] }) : null
+  ] });
+};
+export {
+  ComposerAttachmentPreview
+};
+//# sourceMappingURL=ComposerAttachmentPreview.js.map

package/dist/composer/ComposerAttachmentPreview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComposerAttachmentPreview.js","sources":["../../src/composer/ComposerAttachmentPreview.tsx"],"sourcesContent":["import { Loader2Icon, PaperclipIcon, XIcon } from 'lucide-react';\nimport type { FC } from 'react';\nimport { useAttachments } from './AttachmentContext';\nimport { cn } from '../lib/utils';\n\nexport interface ComposerAttachmentPreviewProps {\n  className?: string;\n}\n\n/**\n * Renders uploaded file pills above the composer.\n * Each pill shows the file name and a dismiss button.\n */\nexport const ComposerAttachmentPreview: FC<ComposerAttachmentPreviewProps> = ({ className }) => {\n  const { attachments, isUploading, removeAttachment } = useAttachments();\n\n  if (attachments.length === 0 && !isUploading) return null;\n\n  return (\n    <div className={cn('aui-attachment-preview mx-3 mt-2 flex flex-wrap gap-1.5', className)}>\n      {attachments.map((asset) => (\n        <div\n          key={asset.id}\n          className=\"flex items-center gap-1.5 rounded-lg border border-border/60 bg-muted/40 px-2.5 py-1.5 text-xs\"\n        >\n          <PaperclipIcon className=\"size-3 shrink-0 text-muted-foreground/60\" />\n          <span className=\"max-w-[180px] truncate text-foreground/80\">{asset.title}</span>\n          <button\n            type=\"button\"\n            onClick={() => removeAttachment(asset.id)}\n            className=\"shrink-0 rounded p-0.5 text-muted-foreground hover:bg-muted hover:text-foreground transition-colors\"\n            aria-label={`Remove ${asset.title}`}\n          >\n            <XIcon className=\"size-3\" />\n          </button>\n        </div>\n      ))}\n      {isUploading ? (\n        <div className=\"flex items-center gap-1.5 rounded-lg border border-border/60 bg-muted/40 px-2.5 py-1.5 text-xs text-muted-foreground\">\n          <Loader2Icon className=\"size-3 shrink-0 animate-spin\" />\n          <span>Uploading...</span>\n        </div>\n      ) : null}\n    </div>\n  );\n};\n"],"names":[],"mappings":";;;;AAaO,MAAM,4BAAgE,CAAC,EAAE,gBAAgB;AAC9F,QAAM,EAAE,aAAa,aAAa,iBAAA,IAAqB,eAAA;AAEvD,MAAI,YAAY,WAAW,KAAK,CAAC,YAAa,QAAO;AAErD,8BACG,OAAA,EAAI,WAAW,GAAG,2DAA2D,SAAS,GACpF,UAAA;AAAA,IAAA,YAAY,IAAI,CAAC,UAChB;AAAA,MAAC;AAAA,MAAA;AAAA,QAEC,WAAU;AAAA,QAEV,UAAA;AAAA,UAAA,oBAAC,eAAA,EAAc,WAAU,2CAAA,CAA2C;AAAA,UACpE,oBAAC,QAAA,EAAK,WAAU,6CAA6C,gBAAM,OAAM;AAAA,UACzE;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,MAAK;AAAA,cACL,SAAS,MAAM,iBAAiB,MAAM,EAAE;AAAA,cACxC,WAAU;AAAA,cACV,cAAY,UAAU,MAAM,KAAK;AAAA,cAEjC,UAAA,oBAAC,OAAA,EAAM,WAAU,SAAA,CAAS;AAAA,YAAA;AAAA,UAAA;AAAA,QAC5B;AAAA,MAAA;AAAA,MAZK,MAAM;AAAA,IAAA,CAcd;AAAA,IACA,cACC,qBAAC,OAAA,EAAI,WAAU,wHACb,UAAA;AAAA,MAAA,oBAAC,aAAA,EAAY,WAAU,+BAAA,CAA+B;AAAA,MACtD,oBAAC,UAAK,UAAA,eAAA,CAAY;AAAA,IAAA,EAAA,CACpB,IACE;AAAA,EAAA,GACN;AAEJ;"}