sandbox 3.0.0-beta.23 → 3.0.0-beta.24

package/dist/{app-BjVyEIk1.mjs → app-CpryW0ai.mjs}

@@ -7290,7 +7290,7 @@ const scope = {
 
 //#endregion
 //#region package.json
-var version = "3.0.0-beta.23";
+var version = "3.0.0-beta.24";
 
 //#endregion
 //#region src/error.ts
@@ -7332,6 +7332,10 @@ const snapshotClient = {
 	fromSandbox: (name, opts) => withErrorHandling(() => Snapshot.fromSandbox(name, {
 		fetch: fetchWithUserAgent,
 		...opts
+	})),
+	tree: (params) => withErrorHandling(() => Snapshot.tree({
+		fetch: fetchWithUserAgent,
+		...params
 	}))
 };
 const fetchWithUserAgent = (input, init$1) => {
@@ -14587,6 +14591,75 @@ const snapshot = import_cjs$6.command({
 	}
 });
 
+//#endregion
+//#region src/util/snapshot-tree.ts
+init_source();
+function formatExpires(expiresAt) {
+	if (expiresAt === void 0) return source_default.gray("never");
+	const ms$4 = expiresAt - Date.now();
+	if (ms$4 <= 0) return source_default.red("expired");
+	const formatted = timeAgo(expiresAt);
+	return ms$4 <= 3600 * 1e3 ? source_default.red(formatted) : source_default.green(formatted);
+}
+function renderNode(id, expiresAt, isCurrent) {
+	const bullet = isCurrent ? source_default.magenta.bold("●") : source_default.magenta("●");
+	const suffix = isCurrent ? `  ${source_default.green("◂ current")}` : "";
+	return `${bullet} ${source_default.yellow(id)}   expires: ${formatExpires(expiresAt)}${suffix}`;
+}
+function renderSiblings(siblings, count) {
+	const lines = [];
+	const shown = siblings.slice(0, 5);
+	const totalCount = parseInt(count, 10);
+	const hasPlus = count.endsWith("+");
+	const remaining = totalCount - 1 - shown.length;
+	for (let i = 0; i < shown.length; i++) {
+		const connector = i === shown.length - 1 && remaining <= 0 ? "╰──" : "├──";
+		lines.push(`│   ${connector} ${source_default.gray(shown[i].sourceSessionId)}`);
+	}
+	if (remaining > 0) {
+		const suffix = hasPlus ? "+" : "";
+		lines.push(`│   ╰── ${source_default.gray(`+${remaining}${suffix} more sandboxes`)}`);
+	}
+	return lines;
+}
+function renderSnapshotTree(params) {
+	const { ancestors, descendants } = params;
+	const hideCurrent = params.hideCurrent === true;
+	const currentSnapshotId = hideCurrent ? void 0 : params.currentSnapshotId;
+	const lines = [];
+	const pushNode = (node, isCurrent) => {
+		lines.push("│");
+		lines.push(renderNode(node.snapshot.id, node.snapshot.expiresAt, isCurrent));
+		if (node.siblings.length > 0) lines.push(...renderSiblings(node.siblings, node.count));
+	};
+	const descendantNodes = descendants.snapshots.filter((n) => n.snapshot.id !== currentSnapshotId);
+	if (descendantNodes.length > 0) for (const node of [...descendantNodes].reverse()) pushNode(node, false);
+	if (!hideCurrent) {
+		const { currentSnapshotId: id, currentSnapshotExpiresAt } = params;
+		pushNode(ancestors.snapshots.find((n) => n.snapshot.id === id) ?? descendants.snapshots.find((n) => n.snapshot.id === id) ?? {
+			snapshot: {
+				id,
+				sourceSessionId: "",
+				expiresAt: currentSnapshotExpiresAt
+			},
+			siblings: [],
+			count: "1"
+		}, true);
+	}
+	const ancestorNodes = ancestors.snapshots.filter((n) => n.snapshot.id !== currentSnapshotId);
+	for (const node of ancestorNodes) pushNode(node, false);
+	if (!hideCurrent) {
+		const lastAncestor = ancestorNodes[ancestorNodes.length - 1];
+		if (ancestors.pagination.next === null) {
+			if (lastAncestor && !lastAncestor.snapshot.parentId || ancestorNodes.length === 0) {
+				lines.push("│");
+				lines.push(`${source_default.white("○")} ${source_default.gray("(root)")}`);
+			}
+		}
+	}
+	return lines.join("\n");
+}
+
 //#endregion
 //#region src/commands/snapshots.ts
 var import_cjs$4 = /* @__PURE__ */ __toESM(require_cjs());
@@ -14737,12 +14810,154 @@ const remove$1 = import_cjs$4.command({
 		}
 	}
 });
+const tree = import_cjs$4.command({
+	name: "tree",
+	description: "Show the snapshot ancestry tree for a sandbox.",
+	args: {
+		scope,
+		sandboxName: import_cjs$4.positional({
+			type: sandboxName,
+			description: "Sandbox name"
+		}),
+		sortOrder: import_cjs$4.option({
+			long: "sort-order",
+			description: "Sort order. Options: asc, desc (default). 'desc' walks ancestors, 'asc' walks descendants. Requires --cursor.",
+			type: import_cjs$4.optional(import_cjs$4.oneOf(["asc", "desc"]))
+		}),
+		limit: import_cjs$4.option({
+			long: "limit",
+			description: "Maximum number of snapshots per page (1–10, default 10).",
+			type: import_cjs$4.optional(import_cjs$4.number)
+		}),
+		cursor: import_cjs$4.option({
+			long: "cursor",
+			description: "Pagination cursor from a previous 'More ancestors' or 'More descendants' hint.",
+			type: import_cjs$4.optional(import_cjs$4.string)
+		})
+	},
+	async handler({ scope: { token: token$1, team: team$1, project: project$1 }, sandboxName: name, sortOrder, limit, cursor }) {
+		if (limit !== void 0 && (limit < 1 || limit > 10)) {
+			console.error(source_default.red("Error: --limit must be between 1 and 10."));
+			process.exitCode = 1;
+			return;
+		}
+		if (sortOrder !== void 0 && !cursor) {
+			console.error(source_default.red("Error: --sort-order requires --cursor."));
+			process.exitCode = 1;
+			return;
+		}
+		const pageLimit = limit ?? 10;
+		if (cursor) {
+			const effectiveSortOrder = sortOrder ?? "desc";
+			const page = await (async () => {
+				try {
+					var _usingCtx4 = _usingCtx();
+					const _spinner$1 = _usingCtx4.u(acquireRelease(() => ora("Fetching snapshot tree...").start(), (s$1) => s$1.stop()));
+					return snapshotClient.tree({
+						snapshotId: cursor,
+						sortOrder: effectiveSortOrder,
+						limit: pageLimit,
+						token: token$1,
+						teamId: team$1,
+						projectId: project$1
+					});
+				} catch (_) {
+					_usingCtx4.e = _;
+				} finally {
+					_usingCtx4.d();
+				}
+			})();
+			const ancestors = effectiveSortOrder === "desc" ? page : {
+				snapshots: [],
+				pagination: {
+					count: 0,
+					next: null
+				}
+			};
+			const descendants = effectiveSortOrder === "asc" ? page : {
+				snapshots: [],
+				pagination: {
+					count: 0,
+					next: null
+				}
+			};
+			console.log(renderSnapshotTree({
+				hideCurrent: true,
+				ancestors,
+				descendants
+			}));
+			if (page.pagination.next !== null) console.log(formatNextCursorHint(page.pagination.next));
+			return;
+		}
+		const result = await (async () => {
+			try {
+				var _usingCtx5 = _usingCtx();
+				const _spinner$1 = _usingCtx5.u(acquireRelease(() => ora("Fetching snapshot tree...").start(), (s$1) => s$1.stop()));
+				const currentSnapshotId = (await sandboxClient.get({
+					name,
+					token: token$1,
+					teamId: team$1,
+					projectId: project$1
+				})).currentSnapshotId;
+				if (!currentSnapshotId) return null;
+				const [currentSnap, ancestors, descendants] = await Promise.all([
+					snapshotClient.get({
+						snapshotId: currentSnapshotId,
+						token: token$1,
+						teamId: team$1,
+						projectId: project$1
+					}),
+					snapshotClient.tree({
+						snapshotId: currentSnapshotId,
+						sortOrder: "desc",
+						limit: pageLimit,
+						token: token$1,
+						teamId: team$1,
+						projectId: project$1
+					}),
+					snapshotClient.tree({
+						snapshotId: currentSnapshotId,
+						sortOrder: "asc",
+						limit: pageLimit,
+						token: token$1,
+						teamId: team$1,
+						projectId: project$1
+					})
+				]);
+				return {
+					currentSnap,
+					currentSnapshotId,
+					ancestors,
+					descendants
+				};
+			} catch (_) {
+				_usingCtx5.e = _;
+			} finally {
+				_usingCtx5.d();
+			}
+		})();
+		if (!result) {
+			console.log(source_default.yellow("No snapshots found for this sandbox."));
+			return;
+		}
+		console.log(renderSnapshotTree({
+			currentSnapshotId: result.currentSnapshotId,
+			currentSnapshotExpiresAt: result.currentSnap.expiresAt?.getTime(),
+			ancestors: result.ancestors,
+			descendants: result.descendants
+		}));
+		const limitArg = limit !== void 0 ? ` --limit ${limit}` : "";
+		if (result.ancestors.pagination.next !== null) console.log(`\nMore ancestors: sandbox snapshots tree ${name} --sort-order desc${limitArg} --cursor ${result.ancestors.pagination.next}`);
+		if (result.descendants.pagination.next !== null) console.log(`More descendants: sandbox snapshots tree ${name} --sort-order asc${limitArg} --cursor ${result.descendants.pagination.next}`);
+	}
+});
 const snapshots = (0, import_cjs$5.subcommands)({
 	name: "snapshots",
 	description: "Manage sandbox snapshots",
 	cmds: {
 		list: list$2,
 		get,
+		tree,
 		delete: remove$1
 	}
 });
@@ -15386,4 +15601,4 @@ const app = (opts) => (0, import_cjs.subcommands)({
 
 //#endregion
 export { source_exports as a, init_source as i, StyledError as n, require_cjs as r, app as t };
-//# sourceMappingURL=app-BjVyEIk1.mjs.map
+//# sourceMappingURL=app-CpryW0ai.mjs.map