@athenaintel/react 0.57.2 → 0.60.0

package/dist/composer/useAttachToChat.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachToChat.cjs","sources":["../../src/composer/useAttachToChat.ts"],"sourcesContent":["import type { AttachableReference } from '@athenaintel/references/attachable';\nimport { useCallback, useContext, useMemo } from 'react';\nimport { AthenaStatewireThreadIdContext } from '../threads/thread-id-context';\nimport {\n  type AttachReferenceResult,\n  attachReferenceToThread,\n  clearAttachedReferences,\n  detachReferenceFromThread,\n  usePendingAttachedReferences,\n} from './attached-references';\nimport { useFocusComposer } from './composer-handoff';\nimport { useAppendToComposer } from './useAppendToComposer';\n\n/**\n * Something an app can attach to the next chat message: an Athena asset (optionally narrowed to a\n * place inside it with an `anchor`, as the reference standard writes it), an ontology object, or a\n * web page. `meta.title` is what the chip shows; the agent is told it is the app's label, never the\n * object's content.\n *\n * ```ts\n * { referenced: 'asset', id: 'asset_…', anchor?: { type: 'page', page: 5 }, meta?: { title: 'Q4 deck' } }\n * { referenced: 'ontology_object', id: 'asset_…', meta?: { title: 'Sequoia Capital', objectType: 'Investor' } }\n * { referenced: 'external_url', url: 'https://…', meta?: { title: 'Blog post' } }\n * ```\n */\nexport type AthenaReference = AttachableReference;\n\nexport interface AttachToChatOptions {\n  /**\n   * Text put in the composer after what the person has typed, for them to finish and send. Nothing\n   * is sent.\n   */\n  prompt?: string;\n  /** Focus the composer, caret at the end of the draft, so the person can type and send. */\n  open?: boolean;\n}\n\nexport interface UseAttachToChatResult {\n  /**\n   * Attach `reference` to the next message: the composer shows it as a removable chip, and it\n   * travels with that message as structured data, never as text. Athena resolves it on the server\n   * with the signed-in person's own permission; the agent is told about anything it can't open\n   * instead of seeing it. Returns why it was not attached when it was not.\n   */\n  attach: (reference: AthenaReference, options?: AttachToChatOptions) => AttachReferenceResult;\n  /** Take `reference` (matched by kind and id, an asset's anchor included) off the next message. */\n  detach: (reference: AthenaReference) => void;\n  /** Take every reference off the next message. */\n  clear: () => void;\n  /** What the next message carries, in the order attached. */\n  references: readonly AthenaReference[];\n}\n\n/**\n * Attach objects on screen to the conversation's next message (\"Discuss this with the agent\").\n * Use it anywhere under `<AthenaProvider>`: it attaches to the chat's active conversation, whose\n * composer (`AthenaChat`) shows the chips. A message carries at most\n * `MAX_ATTACHED_REFERENCES` (10).\n *\n * ```tsx\n * const { attach } = useAttachToChat();\n * <button onClick={() => attach(\n *   { referenced: 'ontology_object', id: investor.id, meta: { title: investor.name } },\n *   { prompt: 'Draft an intro email to ', open: true },\n * )}>Discuss</button>\n * ```\n */\nexport function useAttachToChat(): UseAttachToChatResult {\n  const threadId = useContext(AthenaStatewireThreadIdContext);\n  const references = usePendingAttachedReferences(threadId);\n  const appendToComposer = useAppendToComposer();\n  const focusComposer = useFocusComposer();\n\n  const attach = useCallback(\n    (reference: AthenaReference, options?: AttachToChatOptions): AttachReferenceResult => {\n      const result = attachReferenceToThread({ threadId, reference });\n      if (!result.attached) return result;\n      const prompt = options?.prompt;\n      if (prompt) appendToComposer(prompt, { focus: options?.open ?? false });\n      else if (options?.open) focusComposer();\n      return result;\n    },\n    [appendToComposer, focusComposer, threadId],\n  );\n  const detach = useCallback(\n    (reference: AthenaReference) => detachReferenceFromThread({ threadId, reference }),\n    [threadId],\n  );\n  const clear = useCallback(() => clearAttachedReferences(threadId), [threadId]);\n\n  return useMemo(\n    () => ({ attach, detach, clear, references }),\n    [attach, clear, detach, references],\n  );\n}\n"],"names":["useContext","AthenaStatewireThreadIdContext","usePendingAttachedReferences","useAppendToComposer","useFocusComposer","useCallback","attachReferenceToThread","detachReferenceFromThread","clearAttachedReferences","useMemo"],"mappings":";;;;;;;AAmEO,SAAS,kBAAyC;AACvD,QAAM,WAAWA,WAAAA,WAAWC,8CAA8B;AAC1D,QAAM,aAAaC,mBAAAA,6BAA6B,QAAQ;AACxD,QAAM,mBAAmBC,oBAAAA,oBAAA;AACzB,QAAM,gBAAgBC,gBAAAA,iBAAA;AAEtB,QAAM,SAASC,WAAAA;AAAAA,IACb,CAAC,WAA4B,YAAyD;AACpF,YAAM,SAASC,mBAAAA,wBAAwB,EAAE,UAAU,WAAW;AAC9D,UAAI,CAAC,OAAO,SAAU,QAAO;AAC7B,YAAM,SAAS,mCAAS;AACxB,UAAI,yBAAyB,QAAQ,EAAE,QAAO,mCAAS,SAAQ,OAAO;AAAA,eAC7D,mCAAS,KAAM,eAAA;AACxB,aAAO;AAAA,IACT;AAAA,IACA,CAAC,kBAAkB,eAAe,QAAQ;AAAA,EAAA;AAE5C,QAAM,SAASD,WAAAA;AAAAA,IACb,CAAC,cAA+BE,mBAAAA,0BAA0B,EAAE,UAAU,WAAW;AAAA,IACjF,CAAC,QAAQ;AAAA,EAAA;AAEX,QAAM,QAAQF,WAAAA,YAAY,MAAMG,mBAAAA,wBAAwB,QAAQ,GAAG,CAAC,QAAQ,CAAC;AAE7E,SAAOC,WAAAA;AAAAA,IACL,OAAO,EAAE,QAAQ,QAAQ,OAAO,WAAA;AAAA,IAChC,CAAC,QAAQ,OAAO,QAAQ,UAAU;AAAA,EAAA;AAEtC;;"}

package/dist/composer/useAttachToChat.d.ts

@@ -0,0 +1,54 @@
+import type { AttachableReference } from '../references/src/attachable';
+import { type AttachReferenceResult } from './attached-references';
+/**
+ * Something an app can attach to the next chat message: an Athena asset (optionally narrowed to a
+ * place inside it with an `anchor`, as the reference standard writes it), an ontology object, or a
+ * web page. `meta.title` is what the chip shows; the agent is told it is the app's label, never the
+ * object's content.
+ *
+ * ```ts
+ * { referenced: 'asset', id: 'asset_…', anchor?: { type: 'page', page: 5 }, meta?: { title: 'Q4 deck' } }
+ * { referenced: 'ontology_object', id: 'asset_…', meta?: { title: 'Sequoia Capital', objectType: 'Investor' } }
+ * { referenced: 'external_url', url: 'https://…', meta?: { title: 'Blog post' } }
+ * ```
+ */
+export type AthenaReference = AttachableReference;
+export interface AttachToChatOptions {
+    /**
+     * Text put in the composer after what the person has typed, for them to finish and send. Nothing
+     * is sent.
+     */
+    prompt?: string;
+    /** Focus the composer, caret at the end of the draft, so the person can type and send. */
+    open?: boolean;
+}
+export interface UseAttachToChatResult {
+    /**
+     * Attach `reference` to the next message: the composer shows it as a removable chip, and it
+     * travels with that message as structured data, never as text. Athena resolves it on the server
+     * with the signed-in person's own permission; the agent is told about anything it can't open
+     * instead of seeing it. Returns why it was not attached when it was not.
+     */
+    attach: (reference: AthenaReference, options?: AttachToChatOptions) => AttachReferenceResult;
+    /** Take `reference` (matched by kind and id, an asset's anchor included) off the next message. */
+    detach: (reference: AthenaReference) => void;
+    /** Take every reference off the next message. */
+    clear: () => void;
+    /** What the next message carries, in the order attached. */
+    references: readonly AthenaReference[];
+}
+/**
+ * Attach objects on screen to the conversation's next message ("Discuss this with the agent").
+ * Use it anywhere under `<AthenaProvider>`: it attaches to the chat's active conversation, whose
+ * composer (`AthenaChat`) shows the chips. A message carries at most
+ * `MAX_ATTACHED_REFERENCES` (10).
+ *
+ * ```tsx
+ * const { attach } = useAttachToChat();
+ * <button onClick={() => attach(
+ *   { referenced: 'ontology_object', id: investor.id, meta: { title: investor.name } },
+ *   { prompt: 'Draft an intro email to ', open: true },
+ * )}>Discuss</button>
+ * ```
+ */
+export declare function useAttachToChat(): UseAttachToChatResult;

package/dist/composer/useAttachToChat.js

@@ -0,0 +1,35 @@
+import { useContext, useCallback, useMemo } from "react";
+import { AthenaStatewireThreadIdContext } from "../threads/thread-id-context.js";
+import { usePendingAttachedReferences, attachReferenceToThread, detachReferenceFromThread, clearAttachedReferences } from "./attached-references.js";
+import { useFocusComposer } from "./composer-handoff.js";
+import { useAppendToComposer } from "./useAppendToComposer.js";
+function useAttachToChat() {
+  const threadId = useContext(AthenaStatewireThreadIdContext);
+  const references = usePendingAttachedReferences(threadId);
+  const appendToComposer = useAppendToComposer();
+  const focusComposer = useFocusComposer();
+  const attach = useCallback(
+    (reference, options) => {
+      const result = attachReferenceToThread({ threadId, reference });
+      if (!result.attached) return result;
+      const prompt = options == null ? void 0 : options.prompt;
+      if (prompt) appendToComposer(prompt, { focus: (options == null ? void 0 : options.open) ?? false });
+      else if (options == null ? void 0 : options.open) focusComposer();
+      return result;
+    },
+    [appendToComposer, focusComposer, threadId]
+  );
+  const detach = useCallback(
+    (reference) => detachReferenceFromThread({ threadId, reference }),
+    [threadId]
+  );
+  const clear = useCallback(() => clearAttachedReferences(threadId), [threadId]);
+  return useMemo(
+    () => ({ attach, detach, clear, references }),
+    [attach, clear, detach, references]
+  );
+}
+export {
+  useAttachToChat
+};
+//# sourceMappingURL=useAttachToChat.js.map

package/dist/composer/useAttachToChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachToChat.js","sources":["../../src/composer/useAttachToChat.ts"],"sourcesContent":["import type { AttachableReference } from '@athenaintel/references/attachable';\nimport { useCallback, useContext, useMemo } from 'react';\nimport { AthenaStatewireThreadIdContext } from '../threads/thread-id-context';\nimport {\n  type AttachReferenceResult,\n  attachReferenceToThread,\n  clearAttachedReferences,\n  detachReferenceFromThread,\n  usePendingAttachedReferences,\n} from './attached-references';\nimport { useFocusComposer } from './composer-handoff';\nimport { useAppendToComposer } from './useAppendToComposer';\n\n/**\n * Something an app can attach to the next chat message: an Athena asset (optionally narrowed to a\n * place inside it with an `anchor`, as the reference standard writes it), an ontology object, or a\n * web page. `meta.title` is what the chip shows; the agent is told it is the app's label, never the\n * object's content.\n *\n * ```ts\n * { referenced: 'asset', id: 'asset_…', anchor?: { type: 'page', page: 5 }, meta?: { title: 'Q4 deck' } }\n * { referenced: 'ontology_object', id: 'asset_…', meta?: { title: 'Sequoia Capital', objectType: 'Investor' } }\n * { referenced: 'external_url', url: 'https://…', meta?: { title: 'Blog post' } }\n * ```\n */\nexport type AthenaReference = AttachableReference;\n\nexport interface AttachToChatOptions {\n  /**\n   * Text put in the composer after what the person has typed, for them to finish and send. Nothing\n   * is sent.\n   */\n  prompt?: string;\n  /** Focus the composer, caret at the end of the draft, so the person can type and send. */\n  open?: boolean;\n}\n\nexport interface UseAttachToChatResult {\n  /**\n   * Attach `reference` to the next message: the composer shows it as a removable chip, and it\n   * travels with that message as structured data, never as text. Athena resolves it on the server\n   * with the signed-in person's own permission; the agent is told about anything it can't open\n   * instead of seeing it. Returns why it was not attached when it was not.\n   */\n  attach: (reference: AthenaReference, options?: AttachToChatOptions) => AttachReferenceResult;\n  /** Take `reference` (matched by kind and id, an asset's anchor included) off the next message. */\n  detach: (reference: AthenaReference) => void;\n  /** Take every reference off the next message. */\n  clear: () => void;\n  /** What the next message carries, in the order attached. */\n  references: readonly AthenaReference[];\n}\n\n/**\n * Attach objects on screen to the conversation's next message (\"Discuss this with the agent\").\n * Use it anywhere under `<AthenaProvider>`: it attaches to the chat's active conversation, whose\n * composer (`AthenaChat`) shows the chips. A message carries at most\n * `MAX_ATTACHED_REFERENCES` (10).\n *\n * ```tsx\n * const { attach } = useAttachToChat();\n * <button onClick={() => attach(\n *   { referenced: 'ontology_object', id: investor.id, meta: { title: investor.name } },\n *   { prompt: 'Draft an intro email to ', open: true },\n * )}>Discuss</button>\n * ```\n */\nexport function useAttachToChat(): UseAttachToChatResult {\n  const threadId = useContext(AthenaStatewireThreadIdContext);\n  const references = usePendingAttachedReferences(threadId);\n  const appendToComposer = useAppendToComposer();\n  const focusComposer = useFocusComposer();\n\n  const attach = useCallback(\n    (reference: AthenaReference, options?: AttachToChatOptions): AttachReferenceResult => {\n      const result = attachReferenceToThread({ threadId, reference });\n      if (!result.attached) return result;\n      const prompt = options?.prompt;\n      if (prompt) appendToComposer(prompt, { focus: options?.open ?? false });\n      else if (options?.open) focusComposer();\n      return result;\n    },\n    [appendToComposer, focusComposer, threadId],\n  );\n  const detach = useCallback(\n    (reference: AthenaReference) => detachReferenceFromThread({ threadId, reference }),\n    [threadId],\n  );\n  const clear = useCallback(() => clearAttachedReferences(threadId), [threadId]);\n\n  return useMemo(\n    () => ({ attach, detach, clear, references }),\n    [attach, clear, detach, references],\n  );\n}\n"],"names":[],"mappings":";;;;;AAmEO,SAAS,kBAAyC;AACvD,QAAM,WAAW,WAAW,8BAA8B;AAC1D,QAAM,aAAa,6BAA6B,QAAQ;AACxD,QAAM,mBAAmB,oBAAA;AACzB,QAAM,gBAAgB,iBAAA;AAEtB,QAAM,SAAS;AAAA,IACb,CAAC,WAA4B,YAAyD;AACpF,YAAM,SAAS,wBAAwB,EAAE,UAAU,WAAW;AAC9D,UAAI,CAAC,OAAO,SAAU,QAAO;AAC7B,YAAM,SAAS,mCAAS;AACxB,UAAI,yBAAyB,QAAQ,EAAE,QAAO,mCAAS,SAAQ,OAAO;AAAA,eAC7D,mCAAS,KAAM,eAAA;AACxB,aAAO;AAAA,IACT;AAAA,IACA,CAAC,kBAAkB,eAAe,QAAQ;AAAA,EAAA;AAE5C,QAAM,SAAS;AAAA,IACb,CAAC,cAA+B,0BAA0B,EAAE,UAAU,WAAW;AAAA,IACjF,CAAC,QAAQ;AAAA,EAAA;AAEX,QAAM,QAAQ,YAAY,MAAM,wBAAwB,QAAQ,GAAG,CAAC,QAAQ,CAAC;AAE7E,SAAO;AAAA,IACL,OAAO,EAAE,QAAQ,QAAQ,OAAO,WAAA;AAAA,IAChC,CAAC,QAAQ,OAAO,QAAQ,UAAU;AAAA,EAAA;AAEtC;"}

package/dist/composer/useAttachedReferencesComposerProps.cjs

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require$$0 = require("react");
+const attachedReferences = require("./attached-references.cjs");
+function useAttachedReferencesComposerProps(threadId) {
+  const prepareSend = require$$0.useCallback(
+    ({ text }) => ({
+      queue: attachedReferences.stageThreadAttachedReferencesForSend({ threadId, text }).length > 0
+    }),
+    [threadId]
+  );
+  const onSendReturned = require$$0.useCallback(
+    ({ text }) => attachedReferences.restoreSentAttachedReferences({ threadId, text }),
+    [threadId]
+  );
+  return require$$0.useMemo(() => ({ prepareSend, onSendReturned }), [onSendReturned, prepareSend]);
+}
+exports.useAttachedReferencesComposerProps = useAttachedReferencesComposerProps;
+//# sourceMappingURL=useAttachedReferencesComposerProps.cjs.map

package/dist/composer/useAttachedReferencesComposerProps.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachedReferencesComposerProps.cjs","sources":["../../src/composer/useAttachedReferencesComposerProps.ts"],"sourcesContent":["import { useCallback, useMemo } from 'react';\nimport type { TiptapComposerProps } from '../chat-ui/composer/tiptap-composer';\nimport {\n  restoreSentAttachedReferences,\n  stageThreadAttachedReferencesForSend,\n} from './attached-references';\n\n/** The `TiptapComposer` props that send what an app attached to the message. */\nexport type AttachedReferencesComposerProps = Required<\n  Pick<TiptapComposerProps, 'prepareSend' | 'onSendReturned'>\n>;\n\n/**\n * Wire a `TiptapComposer` to the references an app attached to `threadId`'s next message\n * (`useAttachToChat`): spread the result on the composer. Each send the composer makes itself\n * carries them in its metadata (and waits for its own run rather than joining a live one), and a\n * send statewire hands back brings their chips back. `AthenaChat` does this for its own composer;\n * a host mounting `TiptapComposer` directly (with `ComposerAttachedReferences` above it) opts in\n * here, and one that doesn't never sends attachments or loads this code.\n */\nexport function useAttachedReferencesComposerProps(\n  threadId: string,\n): AttachedReferencesComposerProps {\n  const prepareSend = useCallback(\n    ({ text }: { text: string }) => ({\n      queue: stageThreadAttachedReferencesForSend({ threadId, text }).length > 0,\n    }),\n    [threadId],\n  );\n  const onSendReturned = useCallback(\n    ({ text }: { text: string }) => restoreSentAttachedReferences({ threadId, text }),\n    [threadId],\n  );\n  return useMemo(() => ({ prepareSend, onSendReturned }), [onSendReturned, prepareSend]);\n}\n"],"names":["useCallback","stageThreadAttachedReferencesForSend","restoreSentAttachedReferences","useMemo"],"mappings":";;;;AAoBO,SAAS,mCACd,UACiC;AACjC,QAAM,cAAcA,WAAAA;AAAAA,IAClB,CAAC,EAAE,KAAA,OAA8B;AAAA,MAC/B,OAAOC,mBAAAA,qCAAqC,EAAE,UAAU,KAAA,CAAM,EAAE,SAAS;AAAA,IAAA;AAAA,IAE3E,CAAC,QAAQ;AAAA,EAAA;AAEX,QAAM,iBAAiBD,WAAAA;AAAAA,IACrB,CAAC,EAAE,KAAA,MAA6BE,mBAAAA,8BAA8B,EAAE,UAAU,MAAM;AAAA,IAChF,CAAC,QAAQ;AAAA,EAAA;AAEX,SAAOC,WAAAA,QAAQ,OAAO,EAAE,aAAa,mBAAmB,CAAC,gBAAgB,WAAW,CAAC;AACvF;;"}

package/dist/composer/useAttachedReferencesComposerProps.d.ts

@@ -0,0 +1,12 @@
+import type { TiptapComposerProps } from '../chat-ui/composer/tiptap-composer';
+/** The `TiptapComposer` props that send what an app attached to the message. */
+export type AttachedReferencesComposerProps = Required<Pick<TiptapComposerProps, 'prepareSend' | 'onSendReturned'>>;
+/**
+ * Wire a `TiptapComposer` to the references an app attached to `threadId`'s next message
+ * (`useAttachToChat`): spread the result on the composer. Each send the composer makes itself
+ * carries them in its metadata (and waits for its own run rather than joining a live one), and a
+ * send statewire hands back brings their chips back. `AthenaChat` does this for its own composer;
+ * a host mounting `TiptapComposer` directly (with `ComposerAttachedReferences` above it) opts in
+ * here, and one that doesn't never sends attachments or loads this code.
+ */
+export declare function useAttachedReferencesComposerProps(threadId: string): AttachedReferencesComposerProps;

package/dist/composer/useAttachedReferencesComposerProps.js

@@ -0,0 +1,19 @@
+import { useCallback, useMemo } from "react";
+import { stageThreadAttachedReferencesForSend, restoreSentAttachedReferences } from "./attached-references.js";
+function useAttachedReferencesComposerProps(threadId) {
+  const prepareSend = useCallback(
+    ({ text }) => ({
+      queue: stageThreadAttachedReferencesForSend({ threadId, text }).length > 0
+    }),
+    [threadId]
+  );
+  const onSendReturned = useCallback(
+    ({ text }) => restoreSentAttachedReferences({ threadId, text }),
+    [threadId]
+  );
+  return useMemo(() => ({ prepareSend, onSendReturned }), [onSendReturned, prepareSend]);
+}
+export {
+  useAttachedReferencesComposerProps
+};
+//# sourceMappingURL=useAttachedReferencesComposerProps.js.map

package/dist/composer/useAttachedReferencesComposerProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachedReferencesComposerProps.js","sources":["../../src/composer/useAttachedReferencesComposerProps.ts"],"sourcesContent":["import { useCallback, useMemo } from 'react';\nimport type { TiptapComposerProps } from '../chat-ui/composer/tiptap-composer';\nimport {\n  restoreSentAttachedReferences,\n  stageThreadAttachedReferencesForSend,\n} from './attached-references';\n\n/** The `TiptapComposer` props that send what an app attached to the message. */\nexport type AttachedReferencesComposerProps = Required<\n  Pick<TiptapComposerProps, 'prepareSend' | 'onSendReturned'>\n>;\n\n/**\n * Wire a `TiptapComposer` to the references an app attached to `threadId`'s next message\n * (`useAttachToChat`): spread the result on the composer. Each send the composer makes itself\n * carries them in its metadata (and waits for its own run rather than joining a live one), and a\n * send statewire hands back brings their chips back. `AthenaChat` does this for its own composer;\n * a host mounting `TiptapComposer` directly (with `ComposerAttachedReferences` above it) opts in\n * here, and one that doesn't never sends attachments or loads this code.\n */\nexport function useAttachedReferencesComposerProps(\n  threadId: string,\n): AttachedReferencesComposerProps {\n  const prepareSend = useCallback(\n    ({ text }: { text: string }) => ({\n      queue: stageThreadAttachedReferencesForSend({ threadId, text }).length > 0,\n    }),\n    [threadId],\n  );\n  const onSendReturned = useCallback(\n    ({ text }: { text: string }) => restoreSentAttachedReferences({ threadId, text }),\n    [threadId],\n  );\n  return useMemo(() => ({ prepareSend, onSendReturned }), [onSendReturned, prepareSend]);\n}\n"],"names":[],"mappings":";;AAoBO,SAAS,mCACd,UACiC;AACjC,QAAM,cAAc;AAAA,IAClB,CAAC,EAAE,KAAA,OAA8B;AAAA,MAC/B,OAAO,qCAAqC,EAAE,UAAU,KAAA,CAAM,EAAE,SAAS;AAAA,IAAA;AAAA,IAE3E,CAAC,QAAQ;AAAA,EAAA;AAEX,QAAM,iBAAiB;AAAA,IACrB,CAAC,EAAE,KAAA,MAA6B,8BAA8B,EAAE,UAAU,MAAM;AAAA,IAChF,CAAC,QAAQ;AAAA,EAAA;AAEX,SAAO,QAAQ,OAAO,EAAE,aAAa,mBAAmB,CAAC,gBAAgB,WAAW,CAAC;AACvF;"}

package/dist/composer/useFileUpload.cjs

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require$$0 = require("react");
 const AthenaContext = require("../provider/AthenaContext.cjs");
+const folderUpload = require("./folder-upload.cjs");
 const MAX_FILE_SIZE = 5 * 1024 * 1024 * 1024;
 function useFileUpload() {
   const config = AthenaContext.useAthenaConfig();
@@ -12,15 +13,87 @@ function useFileUpload() {
   const [progress, setProgress] = require$$0.useState(null);
   const [error, setError] = require$$0.useState(null);
   const xhrRef = require$$0.useRef(null);
+  const taskWaitRef = require$$0.useRef(null);
   require$$0.useEffect(() => {
     return () => {
-      var _a;
+      var _a, _b;
       (_a = xhrRef.current) == null ? void 0 : _a.abort();
+      (_b = taskWaitRef.current) == null ? void 0 : _b.abort();
     };
   }, []);
   const clearError = require$$0.useCallback(() => setError(null), []);
+  const uploadIntoFolder = require$$0.useCallback(
+    async ({
+      files,
+      parentFolderId,
+      baseUrl,
+      headers,
+      currentToken
+    }) => {
+      const send = (form) => new Promise((resolve, reject) => {
+        const xhr = new XMLHttpRequest();
+        xhrRef.current = xhr;
+        xhr.upload.addEventListener("progress", (e) => {
+          var _a;
+          if (!e.lengthComputable) return;
+          const percent = e.loaded / e.total;
+          const fileIndex = Math.min(Math.floor(percent * files.length), files.length - 1);
+          setProgress({
+            current: fileIndex + 1,
+            total: files.length,
+            fileName: ((_a = files[fileIndex]) == null ? void 0 : _a.name) ?? "",
+            percent
+          });
+        });
+        xhr.addEventListener(
+          "load",
+          () => resolve(new Response(xhr.responseText, { status: xhr.status }))
+        );
+        xhr.addEventListener("error", () => reject(new Error("Network error during upload")));
+        xhr.addEventListener("abort", () => reject(new Error("Upload was cancelled")));
+        xhr.open("POST", `${baseUrl}${folderUpload.FOLDER_UPLOAD_PATH}`);
+        for (const [key, value] of Object.entries(headers)) xhr.setRequestHeader(key, value);
+        xhr.withCredentials = !currentToken && !configRef.current.apiKey;
+        xhr.send(form);
+      });
+      const taskId = await folderUpload.startFolderUpload({ send, files, parentFolderId });
+      const config2 = configRef.current;
+      const auth = {
+        backendUrl: baseUrl,
+        appUrl: config2.appUrl,
+        apiKey: config2.apiKey,
+        credentials: "include",
+        get accessToken() {
+          return configRef.current.token ?? void 0;
+        },
+        getAccessToken: async () => {
+          var _a, _b;
+          return await ((_b = (_a = configRef.current).getToken) == null ? void 0 : _b.call(_a)) ?? void 0;
+        },
+        renewAccessToken: async () => {
+          var _a, _b;
+          return await ((_b = (_a = configRef.current).getToken) == null ? void 0 : _b.call(_a, { force: true })) ?? void 0;
+        }
+      };
+      const waiting = new AbortController();
+      taskWaitRef.current = waiting;
+      try {
+        const task = await folderUpload.waitForFolderUploadTask({ auth, taskId, signal: waiting.signal });
+        const { uploaded, failed } = folderUpload.folderUploadResultOf({ task, files });
+        if (failed.length > 0) {
+          const errMsg = failed.map((entry) => `${entry.fileName}: ${entry.error}`).join("; ");
+          setError(errMsg);
+          if (uploaded.length === 0) throw new Error(errMsg);
+        }
+        return { uploaded, refused: failed };
+      } finally {
+        if (taskWaitRef.current === waiting) taskWaitRef.current = null;
+      }
+    },
+    []
+  );
   const upload = require$$0.useCallback(
-    async (files) => {
+    async (files, options = {}) => {
       var _a;
       if (files.length === 0) return [];
       for (const file of files) {
@@ -34,10 +107,6 @@ function useFileUpload() {
       setError(null);
       setProgress({ current: 0, total: files.length, fileName: ((_a = files[0]) == null ? void 0 : _a.name) ?? "", percent: 0 });
       try {
-        const formData = new FormData();
-        for (const file of files) {
-          formData.append("files", file, file.name);
-        }
         const baseUrl = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
         const uploadUrl = `${baseUrl}/api/upload/`;
         const currentToken = configRef.current.token;
@@ -47,6 +116,22 @@ function useFileUpload() {
         } else if (apiKey) {
           headers["X-API-KEY"] = apiKey;
         }
+        const { parentFolderId, onFilesRefused } = options;
+        if (parentFolderId) {
+          const { uploaded, refused } = await uploadIntoFolder({
+            files,
+            parentFolderId,
+            baseUrl,
+            headers,
+            currentToken
+          });
+          if (refused.length > 0) onFilesRefused == null ? void 0 : onFilesRefused(refused);
+          return uploaded;
+        }
+        const formData = new FormData();
+        for (const file of files) {
+          formData.append("files", file, file.name);
+        }
         const xhr = new XMLHttpRequest();
         xhrRef.current = xhr;
         const result = await new Promise((resolve, reject) => {
@@ -108,6 +193,9 @@ function useFileUpload() {
             throw new Error(errMsg);
           }
           setError(errMsg);
+          onFilesRefused == null ? void 0 : onFilesRefused(
+            result.errors.map((e) => ({ fileName: e.file.filename, error: e.error }))
+          );
         }
         return result.success;
       } catch (err) {
@@ -120,7 +208,7 @@ function useFileUpload() {
         setProgress(null);
       }
     },
-    [backendUrl, apiKey]
+    [backendUrl, apiKey, uploadIntoFolder]
   );
   return { upload, isUploading, progress, error, clearError };
 }

package/dist/composer/useFileUpload.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useFileUpload.cjs","sources":["../../src/composer/useFileUpload.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport { useAthenaConfig } from '../provider/AthenaContext';\n\nexport interface UploadedAsset {\n  id: string;\n  title: string;\n  fileName: string;\n  fileSize: number;\n  mediaType: string;\n  /**\n   * The position, in the batch `upload` was given, of the file this asset was\n   * uploaded from (the upload's `success_file_indexes`; absent from a server\n   * that does not send them).\n   */\n  fileIndex?: number;\n  /**\n   * A local `blob:` URL of the picture this attachment was uploaded from, for\n   * the composer's thumbnail and full-screen viewer. Set by the composer's\n   * intake for image files, and revoked when the draft lets the attachment go.\n   */\n  previewUrl?: string;\n}\n\nexport interface UploadProgress {\n  current: number;\n  total: number;\n  fileName: string;\n  /** 0–1 normalized progress for the current file */\n  percent: number;\n}\n\nexport interface UseFileUploadReturn {\n  /** Upload one or more files to Athena. Returns the created asset(s). */\n  upload: (files: File[]) => Promise<UploadedAsset[]>;\n  /** Whether an upload is currently in progress. */\n  isUploading: boolean;\n  /** Upload progress info (null when idle). */\n  progress: UploadProgress | null;\n  /** Last upload error (null when no error). */\n  error: string | null;\n  /** Clear the error state. */\n  clearError: () => void;\n}\n\nconst MAX_FILE_SIZE = 5 * 1024 * 1024 * 1024; // 5 GB\n\n/**\n * Hook for uploading files to the Athena platform via the Athena upload endpoint.\n * Files become Athena assets (documents, spreadsheets, PDFs, images, etc.).\n *\n * Usage:\n *   const { upload, isUploading, progress, error } = useFileUpload();\n *   const assets = await upload(fileList);\n */\nexport function useFileUpload(): UseFileUploadReturn {\n  const config = useAthenaConfig();\n  // Keep config in a ref so upload() always reads the latest token at call\n  // time. AthenaConfig's token is a getter that returns the current value\n  // from PropelAuth, and reading via the ref avoids capturing stale\n  // destructured values in the useCallback closure.\n  const configRef = useRef(config);\n  configRef.current = config;\n  const { backendUrl, apiKey } = config;\n  const [isUploading, setIsUploading] = useState(false);\n  const [progress, setProgress] = useState<UploadProgress | null>(null);\n  const [error, setError] = useState<string | null>(null);\n  const xhrRef = useRef<XMLHttpRequest | null>(null);\n\n  // Abort any in-flight upload when the component unmounts\n  useEffect(() => {\n    return () => {\n      xhrRef.current?.abort();\n    };\n  }, []);\n\n  const clearError = useCallback(() => setError(null), []);\n\n  const upload = useCallback(\n    async (files: File[]): Promise<UploadedAsset[]> => {\n      if (files.length === 0) return [];\n\n      // Validate file sizes\n      for (const file of files) {\n        if (file.size > MAX_FILE_SIZE) {\n          const msg = `File \"${file.name}\" exceeds the maximum size of 5 GB.`;\n          setError(msg);\n          throw new Error(msg);\n        }\n      }\n\n      setIsUploading(true);\n      setError(null);\n      setProgress({ current: 0, total: files.length, fileName: files[0]?.name ?? '', percent: 0 });\n\n      try {\n        const formData = new FormData();\n        for (const file of files) {\n          formData.append('files', file, file.name);\n        }\n\n        // Derive the upload URL from the configured Athena backend URL.\n        // If backendUrl points at a nested Athena endpoint, trim it back to the API base first.\n        const baseUrl = backendUrl.replace(/\\/api\\/assistant-ui\\/?$/, '');\n        const uploadUrl = `${baseUrl}/api/upload/`;\n\n        // Read the current token at call time so rotated tokens are picked up.\n        const currentToken = configRef.current.token;\n        const headers: Record<string, string> = {};\n        if (currentToken) {\n          headers['Authorization'] = `Bearer ${currentToken}`;\n        } else if (apiKey) {\n          headers['X-API-KEY'] = apiKey;\n        }\n\n        const xhr = new XMLHttpRequest();\n        xhrRef.current = xhr;\n\n        const result = await new Promise<{ success: UploadedAsset[]; errors: Array<{ file: { filename: string }; error: string }> }>((resolve, reject) => {\n          xhr.upload.addEventListener('progress', (e) => {\n            if (e.lengthComputable) {\n              const percent = e.loaded / e.total;\n              // Estimate which file we're on based on progress\n              const fileIndex = Math.min(\n                Math.floor(percent * files.length),\n                files.length - 1,\n              );\n              setProgress({\n                current: fileIndex + 1,\n                total: files.length,\n                fileName: files[fileIndex]?.name ?? '',\n                percent,\n              });\n            }\n          });\n\n          xhr.addEventListener('load', () => {\n            if (xhr.status >= 200 && xhr.status < 300) {\n              try {\n                const data = JSON.parse(xhr.responseText);\n                const fileIndexes: unknown = data.success_file_indexes;\n                const assets: UploadedAsset[] = (data.success ?? []).map((a: Record<string, unknown>, at: number) => {\n                  const fileIndex = Array.isArray(fileIndexes) ? fileIndexes[at] : undefined;\n                  return {\n                    id: a.id as string,\n                    title: (a.title ?? a.file_name) as string,\n                    fileName: a.file_name as string,\n                    fileSize: a.file_size as number,\n                    mediaType: a.media_type as string,\n                    ...(typeof fileIndex === 'number' && { fileIndex }),\n                  };\n                });\n                resolve({ success: assets, errors: data.errors ?? [] });\n              } catch {\n                reject(new Error('Failed to parse upload response'));\n              }\n            } else if (xhr.status === 401 || xhr.status === 403) {\n              reject(new Error('Authentication failed. Check your API key or token.'));\n            } else {\n              reject(new Error(`Upload failed with status ${xhr.status}`));\n            }\n          });\n\n          xhr.addEventListener('error', () => reject(new Error('Network error during upload')));\n          xhr.addEventListener('abort', () => reject(new Error('Upload was cancelled')));\n\n          xhr.open('POST', uploadUrl);\n          for (const [key, value] of Object.entries(headers)) {\n            xhr.setRequestHeader(key, value);\n          }\n          xhr.withCredentials = !currentToken && !apiKey;\n          xhr.send(formData);\n        });\n\n        if (result.errors.length > 0) {\n          const errMsg = result.errors.map((e) => `${e.file.filename}: ${e.error}`).join('; ');\n          if (result.success.length === 0) {\n            setError(errMsg);\n            throw new Error(errMsg);\n          }\n          // Partial success — set error but still return successful uploads\n          setError(errMsg);\n        }\n\n        return result.success;\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : 'Upload failed';\n        setError(msg);\n        throw err;\n      } finally {\n        xhrRef.current = null;\n        setIsUploading(false);\n        setProgress(null);\n      }\n    },\n    [backendUrl, apiKey],\n  );\n\n  return { upload, isUploading, progress, error, clearError };\n}\n"],"names":["useAthenaConfig","useRef","useState","useEffect","useCallback","_a"],"mappings":"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"}
+{"version":3,"file":"useFileUpload.cjs","sources":["../../src/composer/useFileUpload.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport type { MentionAuthContext } from '../chat-ui/mentions/suggestions/data/api-client';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  FOLDER_UPLOAD_PATH,\n  folderUploadResultOf,\n  startFolderUpload,\n  waitForFolderUploadTask,\n} from './folder-upload';\n\nexport interface UploadedAsset {\n  id: string;\n  title: string;\n  fileName: string;\n  fileSize: number;\n  mediaType: string;\n  /**\n   * The position, in the batch `upload` was given, of the file this asset was\n   * uploaded from (the upload's `success_file_indexes`; absent from a server\n   * that does not send them).\n   */\n  fileIndex?: number;\n  /**\n   * A local `blob:` URL of the picture this attachment was uploaded from, for\n   * the composer's thumbnail and full-screen viewer. Set by the composer's\n   * intake for image files, and revoked when the draft lets the attachment go.\n   */\n  previewUrl?: string;\n}\n\nexport interface UploadProgress {\n  current: number;\n  total: number;\n  fileName: string;\n  /** 0–1 normalized progress for the current file */\n  percent: number;\n}\n\n/** A file Athena refused while it took others from the same upload, with its reason. */\nexport interface UploadRefusal {\n  fileName: string;\n  error: string;\n}\n\nexport interface UploadOptions {\n  /**\n   * The folder the files go into. agora's async upload takes them there, and refuses the whole\n   * upload, before it takes any file, unless the person may edit that folder. Without one they are\n   * filed at the workspace's root, as before.\n   */\n  parentFolderId?: string | null;\n  /**\n   * Hears the files Athena refused when it took others from the same upload, before `upload`\n   * resolves with the ones it took (the hook's `error` says the same, as one line). An upload that\n   * took none rejects instead.\n   */\n  onFilesRefused?: (refused: readonly UploadRefusal[]) => void;\n}\n\nexport interface UseFileUploadReturn {\n  /** Upload one or more files to Athena (into a folder, `parentFolderId`). Returns the created asset(s). */\n  upload: (files: File[], options?: UploadOptions) => Promise<UploadedAsset[]>;\n  /** Whether an upload is currently in progress. */\n  isUploading: boolean;\n  /** Upload progress info (null when idle). */\n  progress: UploadProgress | null;\n  /** Last upload error (null when no error). */\n  error: string | null;\n  /** Clear the error state. */\n  clearError: () => void;\n}\n\nconst MAX_FILE_SIZE = 5 * 1024 * 1024 * 1024; // 5 GB\n\n/**\n * Hook for uploading files to the Athena platform via the Athena upload endpoint.\n * Files become Athena assets (documents, spreadsheets, PDFs, images, etc.).\n *\n * Usage:\n *   const { upload, isUploading, progress, error } = useFileUpload();\n *   const assets = await upload(fileList);\n */\nexport function useFileUpload(): UseFileUploadReturn {\n  const config = useAthenaConfig();\n  // Keep config in a ref so upload() always reads the latest token at call\n  // time. AthenaConfig's token is a getter that returns the current value\n  // from PropelAuth, and reading via the ref avoids capturing stale\n  // destructured values in the useCallback closure.\n  const configRef = useRef(config);\n  configRef.current = config;\n  const { backendUrl, apiKey } = config;\n  const [isUploading, setIsUploading] = useState(false);\n  const [progress, setProgress] = useState<UploadProgress | null>(null);\n  const [error, setError] = useState<string | null>(null);\n  const xhrRef = useRef<XMLHttpRequest | null>(null);\n  // An upload into a folder reads its task until it ends: let go of it when the component goes.\n  const taskWaitRef = useRef<AbortController | null>(null);\n\n  // Abort any in-flight upload when the component unmounts\n  useEffect(() => {\n    return () => {\n      xhrRef.current?.abort();\n      taskWaitRef.current?.abort();\n    };\n  }, []);\n\n  const clearError = useCallback(() => setError(null), []);\n\n  /**\n   * Into a folder: agora's async upload (`POST /api/upload/async` with `parent_folder_id`, which\n   * authorizes EDIT on the folder before it takes a file), its bytes' progress reported as the\n   * quick upload's is, then its task read until it ends (`folder-upload.ts`).\n   */\n  const uploadIntoFolder = useCallback(\n    async ({\n      files,\n      parentFolderId,\n      baseUrl,\n      headers,\n      currentToken,\n    }: {\n      files: File[];\n      parentFolderId: string;\n      baseUrl: string;\n      headers: Record<string, string>;\n      currentToken: string | null | undefined;\n    }): Promise<{ uploaded: UploadedAsset[]; refused: UploadRefusal[] }> => {\n      const send = (form: FormData) =>\n        new Promise<Response>((resolve, reject) => {\n          const xhr = new XMLHttpRequest();\n          xhrRef.current = xhr;\n          xhr.upload.addEventListener('progress', (e) => {\n            if (!e.lengthComputable) return;\n            const percent = e.loaded / e.total;\n            const fileIndex = Math.min(Math.floor(percent * files.length), files.length - 1);\n            setProgress({\n              current: fileIndex + 1,\n              total: files.length,\n              fileName: files[fileIndex]?.name ?? '',\n              percent,\n            });\n          });\n          xhr.addEventListener('load', () =>\n            resolve(new Response(xhr.responseText, { status: xhr.status })),\n          );\n          xhr.addEventListener('error', () => reject(new Error('Network error during upload')));\n          xhr.addEventListener('abort', () => reject(new Error('Upload was cancelled')));\n          xhr.open('POST', `${baseUrl}${FOLDER_UPLOAD_PATH}`);\n          for (const [key, value] of Object.entries(headers)) xhr.setRequestHeader(key, value);\n          xhr.withCredentials = !currentToken && !configRef.current.apiKey;\n          xhr.send(form);\n        });\n      const taskId = await startFolderUpload({ send, files, parentFolderId });\n      const config = configRef.current;\n      const auth: MentionAuthContext = {\n        backendUrl: baseUrl,\n        appUrl: config.appUrl,\n        apiKey: config.apiKey,\n        credentials: 'include',\n        get accessToken() {\n          return configRef.current.token ?? undefined;\n        },\n        getAccessToken: async () => (await configRef.current.getToken?.()) ?? undefined,\n        renewAccessToken: async () =>\n          (await configRef.current.getToken?.({ force: true })) ?? undefined,\n      };\n      const waiting = new AbortController();\n      taskWaitRef.current = waiting;\n      try {\n        const task = await waitForFolderUploadTask({ auth, taskId, signal: waiting.signal });\n        const { uploaded, failed } = folderUploadResultOf({ task, files });\n        if (failed.length > 0) {\n          const errMsg = failed.map((entry) => `${entry.fileName}: ${entry.error}`).join('; ');\n          setError(errMsg);\n          if (uploaded.length === 0) throw new Error(errMsg);\n        }\n        return { uploaded, refused: failed };\n      } finally {\n        if (taskWaitRef.current === waiting) taskWaitRef.current = null;\n      }\n    },\n    [],\n  );\n\n  const upload = useCallback(\n    async (files: File[], options: UploadOptions = {}): Promise<UploadedAsset[]> => {\n      if (files.length === 0) return [];\n\n      // Validate file sizes\n      for (const file of files) {\n        if (file.size > MAX_FILE_SIZE) {\n          const msg = `File \"${file.name}\" exceeds the maximum size of 5 GB.`;\n          setError(msg);\n          throw new Error(msg);\n        }\n      }\n\n      setIsUploading(true);\n      setError(null);\n      setProgress({ current: 0, total: files.length, fileName: files[0]?.name ?? '', percent: 0 });\n\n      try {\n        // Derive the upload URL from the configured Athena backend URL.\n        // If backendUrl points at a nested Athena endpoint, trim it back to the API base first.\n        const baseUrl = backendUrl.replace(/\\/api\\/assistant-ui\\/?$/, '');\n        const uploadUrl = `${baseUrl}/api/upload/`;\n\n        // Read the current token at call time so rotated tokens are picked up.\n        const currentToken = configRef.current.token;\n        const headers: Record<string, string> = {};\n        if (currentToken) {\n          headers['Authorization'] = `Bearer ${currentToken}`;\n        } else if (apiKey) {\n          headers['X-API-KEY'] = apiKey;\n        }\n\n        const { parentFolderId, onFilesRefused } = options;\n        if (parentFolderId) {\n          const { uploaded, refused } = await uploadIntoFolder({\n            files,\n            parentFolderId,\n            baseUrl,\n            headers,\n            currentToken,\n          });\n          if (refused.length > 0) onFilesRefused?.(refused);\n          return uploaded;\n        }\n\n        const formData = new FormData();\n        for (const file of files) {\n          formData.append('files', file, file.name);\n        }\n\n        const xhr = new XMLHttpRequest();\n        xhrRef.current = xhr;\n\n        const result = await new Promise<{ success: UploadedAsset[]; errors: Array<{ file: { filename: string }; error: string }> }>((resolve, reject) => {\n          xhr.upload.addEventListener('progress', (e) => {\n            if (e.lengthComputable) {\n              const percent = e.loaded / e.total;\n              // Estimate which file we're on based on progress\n              const fileIndex = Math.min(\n                Math.floor(percent * files.length),\n                files.length - 1,\n              );\n              setProgress({\n                current: fileIndex + 1,\n                total: files.length,\n                fileName: files[fileIndex]?.name ?? '',\n                percent,\n              });\n            }\n          });\n\n          xhr.addEventListener('load', () => {\n            if (xhr.status >= 200 && xhr.status < 300) {\n              try {\n                const data = JSON.parse(xhr.responseText);\n                const fileIndexes: unknown = data.success_file_indexes;\n                const assets: UploadedAsset[] = (data.success ?? []).map((a: Record<string, unknown>, at: number) => {\n                  const fileIndex = Array.isArray(fileIndexes) ? fileIndexes[at] : undefined;\n                  return {\n                    id: a.id as string,\n                    title: (a.title ?? a.file_name) as string,\n                    fileName: a.file_name as string,\n                    fileSize: a.file_size as number,\n                    mediaType: a.media_type as string,\n                    ...(typeof fileIndex === 'number' && { fileIndex }),\n                  };\n                });\n                resolve({ success: assets, errors: data.errors ?? [] });\n              } catch {\n                reject(new Error('Failed to parse upload response'));\n              }\n            } else if (xhr.status === 401 || xhr.status === 403) {\n              reject(new Error('Authentication failed. Check your API key or token.'));\n            } else {\n              reject(new Error(`Upload failed with status ${xhr.status}`));\n            }\n          });\n\n          xhr.addEventListener('error', () => reject(new Error('Network error during upload')));\n          xhr.addEventListener('abort', () => reject(new Error('Upload was cancelled')));\n\n          xhr.open('POST', uploadUrl);\n          for (const [key, value] of Object.entries(headers)) {\n            xhr.setRequestHeader(key, value);\n          }\n          xhr.withCredentials = !currentToken && !apiKey;\n          xhr.send(formData);\n        });\n\n        if (result.errors.length > 0) {\n          const errMsg = result.errors.map((e) => `${e.file.filename}: ${e.error}`).join('; ');\n          if (result.success.length === 0) {\n            setError(errMsg);\n            throw new Error(errMsg);\n          }\n          // Partial success — set error but still return successful uploads\n          setError(errMsg);\n          onFilesRefused?.(\n            result.errors.map((e) => ({ fileName: e.file.filename, error: e.error })),\n          );\n        }\n\n        return result.success;\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : 'Upload failed';\n        setError(msg);\n        throw err;\n      } finally {\n        xhrRef.current = null;\n        setIsUploading(false);\n        setProgress(null);\n      }\n    },\n    [backendUrl, apiKey, uploadIntoFolder],\n  );\n\n  return { upload, isUploading, progress, error, clearError };\n}\n"],"names":["useAthenaConfig","useRef","useState","useEffect","useCallback","FOLDER_UPLOAD_PATH","startFolderUpload","config","waitForFolderUploadTask","folderUploadResultOf","_a"],"mappings":"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"}

package/dist/composer/useFileUpload.d.ts

@@ -24,9 +24,28 @@ export interface UploadProgress {
     /** 0–1 normalized progress for the current file */
     percent: number;
 }
+/** A file Athena refused while it took others from the same upload, with its reason. */
+export interface UploadRefusal {
+    fileName: string;
+    error: string;
+}
+export interface UploadOptions {
+    /**
+     * The folder the files go into. agora's async upload takes them there, and refuses the whole
+     * upload, before it takes any file, unless the person may edit that folder. Without one they are
+     * filed at the workspace's root, as before.
+     */
+    parentFolderId?: string | null;
+    /**
+     * Hears the files Athena refused when it took others from the same upload, before `upload`
+     * resolves with the ones it took (the hook's `error` says the same, as one line). An upload that
+     * took none rejects instead.
+     */
+    onFilesRefused?: (refused: readonly UploadRefusal[]) => void;
+}
 export interface UseFileUploadReturn {
-    /** Upload one or more files to Athena. Returns the created asset(s). */
-    upload: (files: File[]) => Promise<UploadedAsset[]>;
+    /** Upload one or more files to Athena (into a folder, `parentFolderId`). Returns the created asset(s). */
+    upload: (files: File[], options?: UploadOptions) => Promise<UploadedAsset[]>;
     /** Whether an upload is currently in progress. */
     isUploading: boolean;
     /** Upload progress info (null when idle). */

package/dist/composer/useFileUpload.js

@@ -1,5 +1,6 @@
 import { useRef, useState, useEffect, useCallback } from "react";
 import { useAthenaConfig } from "../provider/AthenaContext.js";
+import { startFolderUpload, waitForFolderUploadTask, folderUploadResultOf, FOLDER_UPLOAD_PATH } from "./folder-upload.js";
 const MAX_FILE_SIZE = 5 * 1024 * 1024 * 1024;
 function useFileUpload() {
   const config = useAthenaConfig();
@@ -10,15 +11,87 @@ function useFileUpload() {
   const [progress, setProgress] = useState(null);
   const [error, setError] = useState(null);
   const xhrRef = useRef(null);
+  const taskWaitRef = useRef(null);
   useEffect(() => {
     return () => {
-      var _a;
+      var _a, _b;
       (_a = xhrRef.current) == null ? void 0 : _a.abort();
+      (_b = taskWaitRef.current) == null ? void 0 : _b.abort();
     };
   }, []);
   const clearError = useCallback(() => setError(null), []);
+  const uploadIntoFolder = useCallback(
+    async ({
+      files,
+      parentFolderId,
+      baseUrl,
+      headers,
+      currentToken
+    }) => {
+      const send = (form) => new Promise((resolve, reject) => {
+        const xhr = new XMLHttpRequest();
+        xhrRef.current = xhr;
+        xhr.upload.addEventListener("progress", (e) => {
+          var _a;
+          if (!e.lengthComputable) return;
+          const percent = e.loaded / e.total;
+          const fileIndex = Math.min(Math.floor(percent * files.length), files.length - 1);
+          setProgress({
+            current: fileIndex + 1,
+            total: files.length,
+            fileName: ((_a = files[fileIndex]) == null ? void 0 : _a.name) ?? "",
+            percent
+          });
+        });
+        xhr.addEventListener(
+          "load",
+          () => resolve(new Response(xhr.responseText, { status: xhr.status }))
+        );
+        xhr.addEventListener("error", () => reject(new Error("Network error during upload")));
+        xhr.addEventListener("abort", () => reject(new Error("Upload was cancelled")));
+        xhr.open("POST", `${baseUrl}${FOLDER_UPLOAD_PATH}`);
+        for (const [key, value] of Object.entries(headers)) xhr.setRequestHeader(key, value);
+        xhr.withCredentials = !currentToken && !configRef.current.apiKey;
+        xhr.send(form);
+      });
+      const taskId = await startFolderUpload({ send, files, parentFolderId });
+      const config2 = configRef.current;
+      const auth = {
+        backendUrl: baseUrl,
+        appUrl: config2.appUrl,
+        apiKey: config2.apiKey,
+        credentials: "include",
+        get accessToken() {
+          return configRef.current.token ?? void 0;
+        },
+        getAccessToken: async () => {
+          var _a, _b;
+          return await ((_b = (_a = configRef.current).getToken) == null ? void 0 : _b.call(_a)) ?? void 0;
+        },
+        renewAccessToken: async () => {
+          var _a, _b;
+          return await ((_b = (_a = configRef.current).getToken) == null ? void 0 : _b.call(_a, { force: true })) ?? void 0;
+        }
+      };
+      const waiting = new AbortController();
+      taskWaitRef.current = waiting;
+      try {
+        const task = await waitForFolderUploadTask({ auth, taskId, signal: waiting.signal });
+        const { uploaded, failed } = folderUploadResultOf({ task, files });
+        if (failed.length > 0) {
+          const errMsg = failed.map((entry) => `${entry.fileName}: ${entry.error}`).join("; ");
+          setError(errMsg);
+          if (uploaded.length === 0) throw new Error(errMsg);
+        }
+        return { uploaded, refused: failed };
+      } finally {
+        if (taskWaitRef.current === waiting) taskWaitRef.current = null;
+      }
+    },
+    []
+  );
   const upload = useCallback(
-    async (files) => {
+    async (files, options = {}) => {
       var _a;
       if (files.length === 0) return [];
       for (const file of files) {
@@ -32,10 +105,6 @@ function useFileUpload() {
       setError(null);
       setProgress({ current: 0, total: files.length, fileName: ((_a = files[0]) == null ? void 0 : _a.name) ?? "", percent: 0 });
       try {
-        const formData = new FormData();
-        for (const file of files) {
-          formData.append("files", file, file.name);
-        }
         const baseUrl = backendUrl.replace(/\/api\/assistant-ui\/?$/, "");
         const uploadUrl = `${baseUrl}/api/upload/`;
         const currentToken = configRef.current.token;
@@ -45,6 +114,22 @@ function useFileUpload() {
         } else if (apiKey) {
           headers["X-API-KEY"] = apiKey;
         }
+        const { parentFolderId, onFilesRefused } = options;
+        if (parentFolderId) {
+          const { uploaded, refused } = await uploadIntoFolder({
+            files,
+            parentFolderId,
+            baseUrl,
+            headers,
+            currentToken
+          });
+          if (refused.length > 0) onFilesRefused == null ? void 0 : onFilesRefused(refused);
+          return uploaded;
+        }
+        const formData = new FormData();
+        for (const file of files) {
+          formData.append("files", file, file.name);
+        }
         const xhr = new XMLHttpRequest();
         xhrRef.current = xhr;
         const result = await new Promise((resolve, reject) => {
@@ -106,6 +191,9 @@ function useFileUpload() {
             throw new Error(errMsg);
           }
           setError(errMsg);
+          onFilesRefused == null ? void 0 : onFilesRefused(
+            result.errors.map((e) => ({ fileName: e.file.filename, error: e.error }))
+          );
         }
         return result.success;
       } catch (err) {
@@ -118,7 +206,7 @@ function useFileUpload() {
         setProgress(null);
       }
     },
-    [backendUrl, apiKey]
+    [backendUrl, apiKey, uploadIntoFolder]
   );
   return { upload, isUploading, progress, error, clearError };
 }