@burdenoff/fe-libs 2026.1007.5 → 2026.1008.1

package/dist/shared/assistant/attachmentCommit.js

@@ -0,0 +1,638 @@
+import { classifyFilesError as e, extractErrorMessage as t } from "../../storage/retryPolicy.js";
+import { FilesPortAbortError as n, FilesPortError as r } from "../../storage/filesPort.js";
+//#region src/shared/assistant/attachmentCommit.ts
+var i = 5 * 1024 * 1024, a = {
+	concurrency: 2,
+	gatewayAttempts: 2,
+	gatewayRetryDelayMs: 1500,
+	putRetries: 1,
+	putRetryDelayMs: 1e3,
+	lookupAttempts: 2,
+	lookupRetryDelayMs: 500,
+	completeReissues: 1,
+	settleGraceMs: 3e3,
+	discardAttempts: 2,
+	finalDrainRounds: 3,
+	finalDrainDelayMs: 5e3
+}, o = {
+	quotaNotProvisioned: "QUOTA_NOT_PROVISIONED",
+	quotaExceeded: "QUOTA_EXCEEDED",
+	tooLarge: "ATTACHMENT_TOO_LARGE_FOR_DIRECT_UPLOAD",
+	noBytes: "ATTACHMENT_NO_BYTES",
+	noDownloadUrl: "ATTACHMENT_NO_DOWNLOAD_URL",
+	timeout: "ATTACHMENT_SAVE_TIMEOUT",
+	uploadFailed: "ATTACHMENT_UPLOAD_FAILED",
+	folderFailed: "ATTACHMENT_FOLDER_FAILED"
+}, s = {
+	[o.quotaNotProvisioned]: "This workspace has no file storage, so the attachment could not be saved.",
+	[o.quotaExceeded]: "There is not enough file storage left for these attachments.",
+	[o.tooLarge]: "This file is over 5 MB and cannot be saved to Files.",
+	[o.noBytes]: "The file is empty or no longer available.",
+	[o.noDownloadUrl]: "The file was saved but could not be linked.",
+	[o.timeout]: "Saving took too long."
+}, c = () => {};
+function l(e, t) {
+	return new Promise((n) => {
+		if (t?.aborted) {
+			n();
+			return;
+		}
+		let r = () => {
+			clearTimeout(i), n();
+		}, i = setTimeout(() => {
+			t?.removeEventListener("abort", r), n();
+		}, e);
+		t?.addEventListener("abort", r, { once: !0 });
+	});
+}
+function u(e) {
+	return e instanceof n || e instanceof Error && e.name === "AbortError";
+}
+function d(e) {
+	return e instanceof r ? e.source : e;
+}
+function f(t) {
+	return e(d(t));
+}
+function p(e) {
+	let t = d(e);
+	if (!t || typeof t != "object") return [];
+	let n = t;
+	return (n.errors ?? n.graphQLErrors ?? []).map((e) => e.extensions?.code).filter((e) => typeof e == "string");
+}
+function m(e) {
+	return p(e)[0];
+}
+function h(e) {
+	if (p(e).length > 0) return !0;
+	let t = d(e), n = t && typeof t == "object" ? t.statusCode : void 0;
+	return typeof n == "number" && n >= 400 && n < 500 && n !== 408;
+}
+function g(e) {
+	return u(e) || f(e) !== null ? !0 : !h(e);
+}
+function _(e, n) {
+	return e instanceof r && e.message ? e.message : t(e) ?? n;
+}
+function v(e, t, r) {
+	return t.aborted ? (e.then((e) => r?.(e), c), Promise.reject(new n())) : new Promise((i, a) => {
+		let o = !1, s = () => {
+			o || (o = !0, a(new n()));
+		};
+		t.addEventListener("abort", s, { once: !0 }), e.then((e) => {
+			if (t.removeEventListener("abort", s), o) {
+				r?.(e);
+				return;
+			}
+			o = !0, i(e);
+		}, (e) => {
+			t.removeEventListener("abort", s), !o && (o = !0, a(e));
+		});
+	});
+}
+function y() {
+	let e = c, t = {
+		promise: new Promise((t) => {
+			e = t;
+		}),
+		settled: !1,
+		resolve: (n) => {
+			t.settled || (t.settled = !0, e(n));
+		}
+	};
+	return t;
+}
+function b(e) {
+	return e.includes(".") ? e.substring(e.lastIndexOf(".") + 1) : "";
+}
+function x(e, t) {
+	e.reason === "none" && (e.reason = t), e.abort();
+}
+function S(e) {
+	if (e.signal.aborted) throw new n();
+}
+async function C(e, t, n) {
+	for (let r = 1;; r += 1) {
+		S(e);
+		try {
+			return await v(t(), e.signal, n);
+		} catch (t) {
+			if (u(t) || e.signal.aborted || r >= e.policy.gatewayAttempts || f(t) === null) throw t;
+			await e.sleep(e.policy.gatewayRetryDelayMs, e.signal);
+		}
+	}
+}
+function w(e, t) {
+	return new Promise((r, i) => {
+		let a = !1, o = new AbortController();
+		t.then((e) => {
+			a = !0, o.abort(), r(e);
+		}, (e) => {
+			a = !0, o.abort(), i(e);
+		});
+		let s = () => {
+			e.sleep(e.policy.settleGraceMs, o.signal).then(() => {
+				a || o.signal.aborted || (a = !0, i(new n()));
+			});
+		};
+		e.signal.aborted ? s() : e.signal.addEventListener("abort", s, { once: !0 });
+	});
+}
+function T(e) {
+	if (!e) return {
+		state: "other",
+		status: "MISSING"
+	};
+	let t = e.status.toUpperCase();
+	return t === "FINALIZED" && e.fileId ? {
+		state: "finalized",
+		fileId: e.fileId
+	} : t === "IN_PROGRESS" || t === "PENDING" ? { state: "in-progress" } : {
+		state: "other",
+		status: t
+	};
+}
+async function E(e, t) {
+	for (let n = 1; n <= e.policy.lookupAttempts; n += 1) try {
+		return T(await e.port.getSession(t));
+	} catch (t) {
+		if (f(t) === null) break;
+		n < e.policy.lookupAttempts && await e.sleep(e.policy.lookupRetryDelayMs);
+	}
+	try {
+		let n = (await e.port.listSessions()).find((e) => e.id === t);
+		return n ? T(n) : { state: "unknown" };
+	} catch {
+		return { state: "unknown" };
+	}
+}
+function D(e, t, n) {
+	let r = Math.max(0, Math.min(100, Math.round(n)));
+	r !== t.lastProgress && (t.lastProgress = r, e.patch(t, { progress: r }));
+}
+async function O(e, t, n) {
+	let { attachment: i, blob: a } = t.draft;
+	if (!a) throw Error("no bytes");
+	let s = await C(e, () => e.port.initiate({
+		fileName: i.filename,
+		fileSize: a.size,
+		mimeType: i.mimeType,
+		extension: b(i.filename),
+		folderId: n
+	}), (t) => {
+		e.port.abort(t.sessionId).catch(c);
+	});
+	if (t.sessionId = s.sessionId, !s.uploadUrl) throw new k(o.tooLarge);
+	D(e, t, 5);
+	for (let n = 0;; n += 1) {
+		S(e);
+		try {
+			await e.port.put({
+				url: s.uploadUrl,
+				blob: a,
+				mimeType: i.mimeType,
+				signal: e.signal,
+				onProgress: (n) => D(e, t, 5 + n * 85)
+			});
+			return;
+		} catch (t) {
+			if (u(t) || e.signal.aborted || !(t instanceof r && (t.httpStatus === void 0 || t.httpStatus >= 500)) || n >= e.policy.putRetries) throw t;
+			await e.sleep(e.policy.putRetryDelayMs, e.signal);
+		}
+	}
+}
+var k = class extends Error {
+	code;
+	constructor(e, t) {
+		super(t ?? s[e] ?? e), this.code = e, this.name = "AttachmentCommitError";
+	}
+};
+async function A(e, t, n) {
+	let r = t.draft.blob, i = t.sessionId;
+	if (!r || !i) throw Error("not staged");
+	let a = {
+		sessionId: i,
+		fileSize: r.size,
+		folderId: n
+	};
+	t.completeIssued = !0;
+	let s, c;
+	try {
+		s = await w(e, e.port.complete(a));
+	} catch (e) {
+		c = e;
+	}
+	let l = 0;
+	for (; !s;) {
+		if (!g(c)) throw c;
+		if (e.signal.aborted) throw t.unresolved = !0, c;
+		let r = await E(e, i);
+		if (r.state === "finalized") {
+			t.fileId = r.fileId, s = {
+				fileId: r.fileId,
+				name: null,
+				folderId: n,
+				downloadUrl: null
+			};
+			break;
+		}
+		if (r.state === "in-progress" && !e.signal.aborted && f(c) !== null && l < e.policy.completeReissues) {
+			l += 1;
+			try {
+				s = await w(e, e.port.complete(a));
+			} catch (e) {
+				c = e;
+			}
+			continue;
+		}
+		throw (r.state === "unknown" || r.state === "in-progress" || u(c)) && (t.unresolved = !0), c;
+	}
+	t.fileId = s.fileId;
+	let d = s.downloadUrl ?? await C(e, () => e.port.getDownloadUrl(s.fileId)).catch((e) => {
+		if (u(e)) throw e;
+		return null;
+	});
+	if (!d) throw new k(o.noDownloadUrl);
+	t.downloadUrl = d, t.urlResolvedAt = e.now(), t.done = !0;
+}
+async function j(e, t) {
+	for (let n = 1;; n += 1) try {
+		return await t();
+	} catch (t) {
+		if (n >= e.policy.discardAttempts || f(t) === null) throw t;
+		await e.sleep(e.policy.gatewayRetryDelayMs);
+	}
+}
+async function M(e, t) {
+	try {
+		await j(e, () => e.port.deleteFile(t)) || e.store.entries.push({
+			kind: "file",
+			fileId: t
+		});
+	} catch {
+		e.store.entries.push({
+			kind: "file",
+			fileId: t
+		});
+	}
+}
+async function N(e, t) {
+	if (!t.handedOver) {
+		if (t.fileId) {
+			let n = t.fileId;
+			t.fileId = void 0, t.done = !1, await M(e, n);
+			return;
+		}
+		if (t.sessionId) {
+			if (!t.completeIssued) {
+				try {
+					await e.port.abort(t.sessionId);
+				} catch {}
+				return;
+			}
+			t.unresolved && (t.unresolved = !1, e.store.entries.push({
+				kind: "session",
+				sessionId: t.sessionId
+			}));
+		}
+	}
+}
+async function P(e, t, n = {}) {
+	for (; t.draining;) await t.draining;
+	let r = F(e, t, n);
+	t.draining = r;
+	try {
+		await r;
+	} finally {
+		t.draining === r && (t.draining = void 0);
+	}
+}
+async function F(e, t, n) {
+	let r = t.entries.splice(0, t.entries.length);
+	if (r.length === 0) return;
+	let i = {
+		port: e,
+		policy: {
+			...a,
+			...n.policy
+		},
+		sleep: n.sleep ?? l,
+		store: t
+	};
+	for (let e of r) {
+		if (e.kind === "file") {
+			await M(i, e.fileId);
+			continue;
+		}
+		let n = await E(i, e.sessionId);
+		n.state === "finalized" ? await M(i, n.fileId) : (n.state === "unknown" || n.state === "in-progress") && t.entries.push(e);
+	}
+}
+function I(e, t) {
+	let n = t instanceof k ? t : null;
+	return {
+		id: e.draft.attachment.id,
+		message: n ? n.message : _(t, "The attachment could not be saved."),
+		code: n ? n.code : m(t) ?? o.uploadFailed
+	};
+}
+function L(e) {
+	return !e.attachment.fileId && !e.attachment.inlineOnly;
+}
+async function R(e) {
+	let t = e.mode ?? "all-or-nothing", n = {
+		...a,
+		...e.policy
+	}, r = e.pendingDiscard ?? { entries: [] }, i = new AbortController(), o = {
+		port: e.port,
+		signal: i.signal,
+		abort: () => i.abort(),
+		reason: "none",
+		policy: n,
+		now: e.now ?? (() => Date.now()),
+		sleep: e.sleep ?? l,
+		patch: (t, n) => e.onChange?.(t.draft.attachment.id, n),
+		store: r
+	}, s = [];
+	for (let t of e.drafts) L(t) && s.push({
+		index: s.length,
+		draft: t,
+		completeIssued: !1,
+		unresolved: !1,
+		done: !1,
+		handedOver: !1,
+		stopped: !1,
+		lastProgress: -1
+	});
+	let c = new AbortController(), u = () => x(o, "cancelled");
+	e.signal?.aborted ? u() : e.signal?.addEventListener("abort", u, { once: !0 });
+	try {
+		s.length > 0 && await z(o, s, e, t, c);
+	} catch (e) {
+		for (let t of s) t.failure ??= I(t, e);
+		x(o, "failed");
+	} finally {
+		c.abort(), e.signal?.removeEventListener("abort", u);
+	}
+	return H(o, s, e, t);
+}
+async function z(e, t, i, a, s) {
+	let c = a === "all-or-nothing";
+	for (let e of t) {
+		let t = e.draft.blob;
+		!t || t.size === 0 ? e.failure = I(e, new k(o.noBytes)) : t.size > 5242880 && (e.failure = I(e, new k(o.tooLarge)));
+	}
+	if (c && t.some((e) => e.failure)) {
+		x(e, "failed");
+		return;
+	}
+	let l = t.filter((e) => !e.failure);
+	if (l.length === 0) return;
+	for (let t of l) e.patch(t, {
+		status: "uploading",
+		progress: 0,
+		saveError: void 0,
+		progressNote: void 0
+	}), t.lastProgress = 0;
+	i.budgetMs !== void 0 && e.sleep(i.budgetMs, s.signal).then(() => {
+		s.signal.aborted || x(e, "budget");
+	});
+	try {
+		await v(P(e.port, e.store, {
+			sleep: e.sleep,
+			policy: e.policy
+		}), e.signal);
+		let t = await V(e, l, c);
+		if (t) {
+			for (let e of l) e.failure = I(e, t);
+			x(e, "failed");
+			return;
+		}
+		if (l = l.filter((e) => !e.failure), l.length === 0) {
+			x(e, "failed");
+			return;
+		}
+	} catch (e) {
+		if (!u(e)) throw e;
+		return;
+	}
+	let d;
+	try {
+		d = (await C(e, () => e.port.ensureFolder(i.folderPath))).id;
+	} catch (t) {
+		if (!u(t)) {
+			let n = t instanceof r ? t : new k(o.folderFailed);
+			for (let e of l) e.failure = I(e, n);
+			x(e, "failed");
+		}
+		return;
+	}
+	let f = l.map(() => y()), p = 0, m = Array.from({ length: Math.min(B(e), l.length) }, async () => {
+		for (;;) {
+			if (e.signal.aborted) return;
+			let t = p;
+			p += 1;
+			let n = l[t];
+			if (!n) return;
+			try {
+				await O(e, n, d), f[t]?.resolve({ ok: !0 });
+			} catch (r) {
+				f[t]?.resolve({
+					ok: !1,
+					error: r
+				}), c && !u(r) && (n.failure = I(n, r), x(e, "failed"));
+			}
+		}
+	}), h = Promise.all(m).then(() => {
+		for (let e of f) e.resolve({
+			ok: !1,
+			error: new n()
+		});
+	});
+	await Promise.all([(async () => {
+		for (let t = 0; t < l.length; t += 1) {
+			let n = l[t], r = await f[t]?.promise;
+			if (!(!n || !r)) {
+				if (!r.ok) {
+					if (u(r.error)) {
+						if (n.stopped = !0, e.signal.aborted && c) break;
+						continue;
+					}
+					if (n.failure ??= I(n, r.error), c) {
+						x(e, "failed");
+						break;
+					}
+					continue;
+				}
+				if (e.signal.aborted) {
+					n.stopped = !0;
+					break;
+				}
+				try {
+					await A(e, n, d), D(e, n, 100);
+				} catch (t) {
+					if (u(t) ? n.stopped = !0 : (n.failure = I(n, t), c && x(e, "failed")), c) break;
+				}
+			}
+		}
+	})(), h]);
+}
+function B(e) {
+	return Math.max(1, Math.floor(e.policy.concurrency));
+}
+async function V(e, t, n) {
+	if (!e.port.getStorageQuota) return null;
+	let r;
+	try {
+		r = await v(e.port.getStorageQuota(), e.signal);
+	} catch (e) {
+		if (u(e)) throw e;
+		return null;
+	}
+	if (r.state === "not-provisioned") return new k(o.quotaNotProvisioned);
+	if (r.state === "ok" && r.remainingBytes !== null) {
+		let e = (e) => e.draft.blob?.size ?? 0;
+		if (t.reduce((t, n) => t + e(n), 0) > r.remainingBytes) {
+			let i = new k(o.quotaExceeded);
+			if (n) return i;
+			let a = r.remainingBytes;
+			for (let n of t) e(n) <= a ? a -= e(n) : n.failure = I(n, i);
+		}
+	}
+	return null;
+}
+async function H(e, t, n, r) {
+	let i = r === "all-or-nothing";
+	if (e.reason === "budget") for (let e of t) !e.done && !e.failure && (e.failure = I(e, new k(o.timeout)));
+	let a = e.reason === "cancelled", s = t.some((e) => e.failure), c = t.every((e) => e.done), l = !a && (i ? c && !s : !0), u = l ? t.filter((e) => !e.done) : t;
+	for (let t of u) await N(e, t);
+	for (let n of t) l && n.done ? e.patch(n, {
+		status: "ready",
+		fileId: n.fileId,
+		downloadUrl: n.downloadUrl,
+		urlResolvedAt: n.urlResolvedAt,
+		progress: void 0,
+		saveError: void 0,
+		progressNote: void 0
+	}) : e.patch(n, {
+		status: "ready",
+		progress: void 0,
+		progressNote: void 0,
+		saveError: a ? void 0 : n.failure?.message
+	});
+	let d = t.flatMap((e) => e.failure ? [e.failure] : []);
+	if (!l) return {
+		ok: !1,
+		cancelled: a,
+		failures: a ? [] : d,
+		message: a ? void 0 : d[0]?.message
+	};
+	let f = new Map(t.map((e) => [e.draft.attachment.id, e])), p = [];
+	for (let e of n.drafts) {
+		let t = f.get(e.attachment.id);
+		t ? t.done && p.push({
+			...e.attachment,
+			status: "ready",
+			fileId: t.fileId,
+			downloadUrl: t.downloadUrl,
+			urlResolvedAt: t.urlResolvedAt,
+			progress: void 0,
+			saveError: void 0,
+			progressNote: void 0
+		}) : p.push(e.attachment);
+	}
+	let m = t.filter((e) => e.done);
+	return {
+		ok: !0,
+		attachments: p,
+		dropped: d,
+		handedOver: () => {
+			for (let e of m) e.handedOver = !0;
+		},
+		rollback: async () => {
+			for (let t of m) t.handedOver || (await N(e, t), e.patch(t, {
+				fileId: void 0,
+				downloadUrl: void 0,
+				urlResolvedAt: void 0
+			}));
+		}
+	};
+}
+function U(e) {
+	let t = { entries: [] }, n = null, r = null, i = /* @__PURE__ */ new Set(), o = (e) => {
+		let t = e.catch(() => void 0).then(() => {
+			i.delete(t);
+		});
+		return i.add(t), e;
+	};
+	return {
+		commit: (i, a = {}) => {
+			if (n) return n;
+			let s = new AbortController();
+			r = s;
+			let c = a.signal;
+			c?.aborted ? s.abort() : c?.addEventListener("abort", () => s.abort(), { once: !0 });
+			let l = R({
+				port: e.port,
+				folderPath: e.folderPath,
+				drafts: i,
+				signal: s.signal,
+				mode: a.mode,
+				budgetMs: a.budgetMs,
+				onChange: e.onChange,
+				pendingDiscard: t,
+				policy: e.policy,
+				now: e.now,
+				sleep: e.sleep
+			}).then((e) => e.ok ? {
+				...e,
+				rollback: () => o(e.rollback())
+			} : e).finally(() => {
+				n = null, r = null;
+			});
+			return n = l, l;
+		},
+		cancel: () => r?.abort(),
+		get isCommitting() {
+			return n !== null;
+		},
+		discardPending: async () => {
+			let r = n;
+			for (r && await r.catch(() => void 0); i.size > 0;) await Promise.all([...i]);
+			let o = () => P(e.port, t, {
+				sleep: e.sleep,
+				policy: e.policy
+			});
+			await o();
+			let s = {
+				...a,
+				...e.policy
+			}, c = e.sleep ?? l;
+			for (let e = 1; e <= s.finalDrainRounds && t.entries.length > 0; e += 1) await c(s.finalDrainDelayMs * e), await o();
+		},
+		get pendingDiscard() {
+			return t.entries;
+		}
+	};
+}
+var W = 1800 * 1e3;
+function G(e, t, n = W) {
+	return e.fileId ? e.urlResolvedAt === void 0 ? !0 : t - e.urlResolvedAt > n : !1;
+}
+async function K(e, t, n = Date.now()) {
+	return Promise.all(e.map(async (e) => {
+		if (!e.fileId || !G(e, n)) return e;
+		try {
+			let r = await t(e.fileId);
+			return r ? {
+				...e,
+				downloadUrl: r,
+				urlResolvedAt: n
+			} : e;
+		} catch {
+			return e;
+		}
+	}));
+}
+//#endregion
+export { o as ATTACHMENT_COMMIT_CODES, a as ATTACHMENT_COMMIT_POLICY, i as ATTACHMENT_DIRECT_UPLOAD_MAX_BYTES, W as ATTACHMENT_URL_MAX_AGE_MS, G as attachmentUrlIsStale, R as commitAttachments, U as createAttachmentCommitter, P as drainPendingDiscards, K as refreshStaleAttachmentUrls };