@alexkroman1/aai-ui 6.4.0 → 6.5.0

package/dist/index.js

@@ -1068,7 +1068,7 @@ function useWorkflows(opts = {}) {
 * so this is invisible to every form that has none — including one whose values
 * are not an object at all, which `submit` accepts.
 */
-async function uploadFiles(api, input, report) {
+async function uploadFiles(api, input, report, parallel) {
 	if (!isRecord(input)) return input;
 	const entries = Object.entries(input);
 	const count = entries.reduce((total, [, value]) => total + filesOf(value).length, 0);
@@ -1080,10 +1080,13 @@ async function uploadFiles(api, input, report) {
 			index,
 			count
 		};
-		return (await api.upload(file, { onProgress: (progress) => report({
-			...position,
-			...progress
-		}) })).id;
+		return (await api.upload(file, {
+			onProgress: (progress) => report({
+				...position,
+				...progress
+			}),
+			...omitUndefined({ parallel })
+		})).id;
 	};
 	const out = {};
 	for (const [name, value] of entries) {
@@ -1128,7 +1131,7 @@ async function uploadFiles(api, input, report) {
 * @public
 */
 function useWorkflowSubmit(workflow, opts = {}) {
-	const { api, key, wait, intervalMs } = opts;
+	const { api, key, wait, intervalMs, parallel } = opts;
 	const [runId, setRunId] = useState(void 0);
 	const [starting, setStarting] = useState(false);
 	const [startError, setStartError] = useState(void 0);
@@ -1146,7 +1149,7 @@ function useWorkflowSubmit(workflow, opts = {}) {
 			setRunId(void 0);
 			try {
 				const options = omitUndefined({ key });
-				const started = await uploadFiles(client, input, setUpload);
+				const started = await uploadFiles(client, input, setUpload, parallel);
 				setRunId(wait === void 0 ? await client.start(workflow, started, options) : (await client.startAndWait(workflow, started, {
 					...options,
 					wait
@@ -1161,6 +1164,7 @@ function useWorkflowSubmit(workflow, opts = {}) {
 			workflow,
 			key,
 			wait,
+			parallel,
 			getClient
 		]),
 		reset: useCallback(() => {
@@ -1859,7 +1863,7 @@ function useWorkflowRuns(workflow, opts = {}) {
 * @public
 */
 function useWorkflowStream(workflow, opts = {}) {
-	const { api, key, intervalMs } = opts;
+	const { api, key, intervalMs, parallel } = opts;
 	const [runId, setRunId] = useState(void 0);
 	const [starting, setStarting] = useState(false);
 	const [startError, setStartError] = useState(void 0);
@@ -1894,7 +1898,8 @@ function useWorkflowStream(workflow, opts = {}) {
 						name: chosen.name,
 						index: 1,
 						count: 1
-					})
+					}),
+					...omitUndefined({ parallel })
 				});
 				await client.wake(started).catch(() => void 0);
 			} catch (err) {
@@ -1907,6 +1912,7 @@ function useWorkflowStream(workflow, opts = {}) {
 		}, [
 			workflow,
 			key,
+			parallel,
 			getClient
 		]),
 		reset: useCallback(() => {

package/dist/use-workflow-form.d.ts

@@ -33,7 +33,7 @@
  * followed from the same id either way.
  */
 import { type WorkflowSummary } from "@alexkroman1/aai";
-import type { UploadProgress } from "@alexkroman1/aai/workflow-api";
+import type { UploadParallel, UploadProgress } from "@alexkroman1/aai/workflow-api";
 import type { WorkflowApi, WorkflowRun } from "./workflow-client.ts";
 /** Options for {@link useWorkflows}. */
 export type UseWorkflowsOptions = {
@@ -138,6 +138,18 @@ export type UseWorkflowSubmitOptions = {
     wait?: number;
     /** How often the fallback poll re-reads a live run. */
     intervalMs?: number;
+    /**
+     * Send each chosen file as concurrent parts instead of in one request.
+     *
+     * `true` for the defaults, or `{ partBytes, concurrency }` to tune them. This is
+     * the wait a form with a recording in it actually spends: the run does not exist
+     * until its input is stored, so until the last byte lands there is no run to
+     * watch and nothing for `<WorkflowProgress>` to say. Splitting the file across
+     * connections is what makes that stretch shorter, and it degrades to the single
+     * request wherever it would not help — a small file, an older agent — so turning
+     * it on is safe for every form. See `UploadOptions.parallel`.
+     */
+    parallel?: UploadParallel;
 };
 /**
  * Start a workflow from a form, and follow the run it creates.

package/dist/use-workflow-stream.d.ts

@@ -57,6 +57,7 @@
  * thrown away with the run; a caller who wants to resume instead drives
  * `api.uploadStream` and `api.uploadInfo` directly.
  */
+import type { UploadParallel } from "@alexkroman1/aai/workflow-api";
 import type { UploadStatus } from "./use-workflow-form.ts";
 import type { WorkflowApi, WorkflowRun } from "./workflow-client.ts";
 /** Options for {@link useWorkflowStream}. */
@@ -67,6 +68,19 @@ export type UseWorkflowStreamOptions = {
     key?: string;
     /** How often the fallback poll re-reads a live run. */
     intervalMs?: number;
+    /**
+     * Send the file as concurrent parts instead of in one streaming request.
+     *
+     * It COMPOSES with what this hook is for rather than competing with it: the run
+     * still starts before the bytes, and the store still publishes how far the file
+     * is readable — that number is the CONTIGUOUS prefix, so a run reading ahead of
+     * the uplink sees the same growing file whether one connection or four are
+     * filling it. What changes is only how fast it grows.
+     *
+     * `true` for the defaults, or `{ partBytes, concurrency }` to tune them. See
+     * `UploadOptions.parallel`.
+     */
+    parallel?: UploadParallel;
 };
 /** What {@link useWorkflowStream} returns. */
 export type WorkflowStreamSubmission<R = unknown> = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexkroman1/aai-ui",
-  "version": "6.4.0",
+  "version": "6.5.0",
   "type": "module",
   "files": [
     "dist",
@@ -29,7 +29,7 @@
     "remark-gfm": "^4.0.1",
     "use-stick-to-bottom": "^1.1.6",
     "use-sync-external-store": "^1.6.0",
-    "@alexkroman1/aai": "6.4.0"
+    "@alexkroman1/aai": "6.5.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",