@platforma-sdk/pl-cli 0.8.29 → 0.9.1

package/src/project_ops.ts

@@ -1,5 +1,11 @@
 import type { PlClient, SignedResourceId, PlTransaction } from "@milaboratories/pl-client";
-import { field, isNullSignedResourceId, resourceIdToString } from "@milaboratories/pl-client";
+import {
+  field,
+  isNotFoundError,
+  isNullSignedResourceId,
+  resourceIdToString,
+} from "@milaboratories/pl-client";
+import { randomUUID } from "node:crypto";
 import {
   ProjectMetaKey,
   ProjectCreatedTimestamp,
@@ -7,6 +13,7 @@ import {
   SchemaVersionKey,
   ProjectStructureKey,
   ProjectsField,
+  ProjectsResourceType,
   duplicateProject,
 } from "@milaboratories/pl-middle-layer";
 import type { ProjectMeta } from "@milaboratories/pl-middle-layer";
@@ -69,6 +76,53 @@ export async function listProjects(
   });
 }
 
+/** A project's identity plus its label — what a whole-root operation needs per project. */
+export interface ProjectIdentityWithLabel extends ProjectIdentity {
+  label: string;
+}
+
+/**
+ * Lists every project in a project list with the field name holding it, which
+ * {@link listProjects} omits. Whole-root operations (moving a user's projects out before the
+ * account is deleted) need that field name to detach each project from its old owner.
+ */
+export async function listProjectIdentities(
+  pl: PlClient,
+  projectListRid: SignedResourceId,
+): Promise<ProjectIdentityWithLabel[]> {
+  return await pl.withReadTx("listProjectIdentities", async (tx) => {
+    return await listProjectIdentitiesInTx(tx, projectListRid);
+  });
+}
+
+/**
+ * {@link listProjectIdentities} against a transaction the caller already holds, so a write that
+ * acts on the list can read it in the same transaction rather than trusting an earlier snapshot.
+ */
+export async function listProjectIdentitiesInTx(
+  tx: PlTransaction,
+  projectListRid: SignedResourceId,
+): Promise<ProjectIdentityWithLabel[]> {
+  const data = await tx.getResourceData(projectListRid, true);
+  const projects: ProjectIdentityWithLabel[] = [];
+
+  for (const f of data.fields) {
+    if (isNullSignedResourceId(f.value)) continue;
+
+    const metaStr = await tx.getKValueStringIfExists(f.value, ProjectMetaKey);
+    const meta: ProjectMeta = metaStr ? JSON.parse(metaStr) : { label: "(unknown)" };
+
+    projects.push({
+      id: resourceIdToString(f.value),
+      rid: f.value,
+      fieldName: f.name,
+      label: meta.label,
+    });
+  }
+
+  return projects;
+}
+
 /** Get detailed info about a project. */
 export async function getProjectInfo(
   pl: PlClient,
@@ -211,6 +265,71 @@ export async function deleteProject(
   });
 }
 
+/** One project moved by {@link moveProjects}, as it ended up in the target root. */
+export interface MovedProject {
+  id: string;
+  /** Label the project had in the source root. */
+  sourceLabel: string;
+  /** Label it carries in the target root — differs when the name collided and was deduplicated. */
+  targetLabel: string;
+}
+
+/**
+ * Re-attaches projects from one user's project list to another's, keeping the same project
+ * resources — no copy is made, so nothing is duplicated and no data is rewritten.
+ *
+ * This works across roots because the backend permits a reference between differently coloured
+ * resources when the caller holds write access to both, which admin credentials do. Names that
+ * collide in the target are deduplicated the way {@link duplicateProject} callers deduplicate
+ * theirs, so a move never silently shadows a project the target user already has.
+ *
+ * The whole batch is one transaction: either every project lands in the target root, or none
+ * moves and both roots are untouched.
+ */
+export async function moveProjects(
+  pl: PlClient,
+  sourceProjectListRid: SignedResourceId,
+  targetProjectListRid: SignedResourceId,
+): Promise<MovedProject[]> {
+  return await pl.withWriteTx("moveProjects", async (tx) => {
+    // Read here rather than taken from the caller: a list read before an operator answered a
+    // confirmation prompt describes the account as it was minutes ago, and a project attached
+    // since then would be left on the source root — where the account deletion that follows
+    // destroys it. Moving what this transaction sees narrows that to the transaction itself.
+    const projects = await listProjectIdentitiesInTx(tx, sourceProjectListRid);
+    if (projects.length === 0) return [];
+
+    const takenLabels = await getExistingLabelsInTx(tx, targetProjectListRid);
+    const moved: MovedProject[] = [];
+
+    for (const project of projects) {
+      const metaStr = await tx.getKValueString(project.rid, ProjectMetaKey);
+      const meta: ProjectMeta = JSON.parse(metaStr);
+      const sourceLabel = meta.label;
+
+      let targetLabel = sourceLabel;
+      if (takenLabels.includes(targetLabel)) {
+        targetLabel = deduplicateName(sourceLabel, takenLabels);
+        tx.setKValue(project.rid, ProjectMetaKey, JSON.stringify({ ...meta, label: targetLabel }));
+        tx.setKValue(project.rid, ProjectLastModifiedTimestamp, String(Date.now()));
+      }
+      // Reserved even when the label was free, so two source projects with the same name do not
+      // both keep it.
+      takenLabels.push(targetLabel);
+
+      // Attached to the target before being detached from the source: the project keeps a
+      // reference throughout, so it is never momentarily unreferenced.
+      tx.createField(field(targetProjectListRid, randomUUID()), "Dynamic", project.rid);
+      tx.removeField(field(sourceProjectListRid, project.fieldName));
+
+      moved.push({ id: project.id, sourceLabel, targetLabel });
+    }
+
+    await tx.commit();
+    return moved;
+  });
+}
+
 /** Get the project list ResourceId for the connected user. */
 export async function getProjectListRid(pl: PlClient): Promise<SignedResourceId> {
   return await pl.withReadTx("getProjectList", async (tx) => {
@@ -225,6 +344,68 @@ export async function getProjectListRid(pl: PlClient): Promise<SignedResourceId>
   });
 }
 
+/**
+ * Resolves a user's root and, if they have one, their project list.
+ *
+ * Unlike {@link navigateToUserRoot} a missing project list is not an error here: a user who has
+ * never opened the app has a root and no list, and that account is still a legitimate target for
+ * whole-account operations. Callers that need a list to write into use
+ * {@link ensureUserProjectList}.
+ */
+export async function openUserRoot(
+  pl: PlClient,
+  username: string,
+): Promise<{ userRoot: SignedResourceId; projectListRid: SignedResourceId | undefined }> {
+  let userRoot: SignedResourceId | undefined;
+  try {
+    userRoot = await pl.getUserRoot({ login: username });
+  } catch (e) {
+    // The backend reports an unknown login as NOT_FOUND on the root, which reads as a missing
+    // resource rather than a missing user. Name the actual problem.
+    if (isNotFoundError(e)) {
+      throw new Error(`User "${username}" not found on this server.`);
+    }
+    throw e;
+  }
+  if (userRoot === undefined) {
+    throw new Error(`User "${username}" not found on this server (no root resource).`);
+  }
+
+  return await pl.withReadTx("openUserRoot", async (tx) => {
+    const projectsField = await tx.getFieldIfExists(field(userRoot, ProjectsField));
+    if (projectsField === undefined || isNullSignedResourceId(projectsField.value)) {
+      return { userRoot, projectListRid: undefined };
+    }
+    return { userRoot, projectListRid: projectsField.value };
+  });
+}
+
+/**
+ * Returns a user's project list, creating an empty one when the root has none — the same lazy
+ * creation the middle layer performs for the signed-in user, but against an impersonated root, so
+ * projects can be re-homed to a user who has never opened the app.
+ */
+export async function ensureUserProjectList(
+  pl: PlClient,
+  userRoot: SignedResourceId,
+): Promise<SignedResourceId> {
+  return await pl.withWriteTx("ensureUserProjectList", async (tx) => {
+    const projectsField = field(userRoot, ProjectsField);
+    tx.createField(projectsField, "Dynamic");
+    const fieldData = await tx.getField(projectsField);
+    if (!isNullSignedResourceId(fieldData.value)) {
+      await tx.commit();
+      return fieldData.value;
+    }
+
+    const list = tx.createEphemeral(ProjectsResourceType);
+    tx.lock(list);
+    tx.setField(projectsField, list);
+    await tx.commit();
+    return await list.globalId;
+  });
+}
+
 /**
  * Navigates to a specific user's project list resource ID.
  * Tries ListUserResources first (new backend), falls back to SHA256 named resource lookup.

package/dist/output-KEq0q5fS.js

@@ -1,166 +0,0 @@
-import { PlClient as e, UnauthenticatedPlClient as t, field as n, isNullSignedResourceId as r, plAddressToConfig as i, resourceIdToString as a } from "@milaboratories/pl-client";
-import { ProjectCreatedTimestamp as o, ProjectLastModifiedTimestamp as s, ProjectMetaKey as c, ProjectStructureKey as l, ProjectsField as u, SchemaVersionKey as d, duplicateProject as f } from "@milaboratories/pl-middle-layer";
-//#region src/connection.ts
-async function p(n) {
-	let r = i(n.address);
-	n.user !== void 0 && (r.user = n.user), n.password !== void 0 && (r.password = n.password);
-	let a = await t.build(r), o;
-	if (await a.requireAuth()) {
-		if (r.user === void 0 || r.password === void 0) throw Error("Server requires authentication but no credentials provided. Use --user/--password flags or PL_USER/PL_PASSWORD env vars.");
-		o = await a.login(r.user, r.password);
-	} else o = {};
-	return await e.init(r, { authInformation: o });
-}
-async function m(n) {
-	let r = i(n.address), a = await (await t.build(r)).login(n.adminUser, n.adminPassword);
-	return await e.init(r, { authInformation: a });
-}
-//#endregion
-//#region src/project_ops.ts
-async function h(e, t) {
-	return await e.withReadTx("listProjects", async (e) => {
-		let n = await e.getResourceData(t, !0), i = [];
-		for (let t of n.fields) {
-			if (r(t.value)) continue;
-			let [n, l, u] = await Promise.all([
-				e.getKValueStringIfExists(t.value, c),
-				e.getKValueStringIfExists(t.value, o),
-				e.getKValueStringIfExists(t.value, s)
-			]), d = n ? JSON.parse(n) : { label: "(unknown)" }, f = a(t.value);
-			i.push({
-				id: f,
-				rid: t.value,
-				label: d.label,
-				created: l ? new Date(Number(l)) : /* @__PURE__ */ new Date(0),
-				lastModified: u ? new Date(Number(u)) : /* @__PURE__ */ new Date(0)
-			});
-		}
-		return i.sort((e, t) => t.lastModified.getTime() - e.lastModified.getTime()), i;
-	});
-}
-async function g(e, t, n) {
-	return await e.withReadTx("getProjectInfo", async (e) => {
-		let r = await e.listKeyValuesString(n), i = r.find((e) => e.key === c), a = r.find((e) => e.key === o), u = r.find((e) => e.key === s), f = r.find((e) => e.key === d), p = r.find((e) => e.key === l), m = i ? JSON.parse(i.value) : { label: "(unknown)" }, h = f ? JSON.parse(f.value) : void 0, g = [];
-		if (p) {
-			let e = JSON.parse(p.value);
-			for (let t of e.groups ?? []) for (let e of t.blocks ?? []) g.push(e.id);
-		}
-		return {
-			id: t,
-			rid: n,
-			label: m.label,
-			created: a ? new Date(Number(a.value)) : /* @__PURE__ */ new Date(0),
-			lastModified: u ? new Date(Number(u.value)) : /* @__PURE__ */ new Date(0),
-			schemaVersion: h,
-			blockCount: g.length,
-			blockIds: g
-		};
-	});
-}
-async function _(e, t, n) {
-	return await e.withReadTx("resolveProject", async (e) => {
-		let i = await e.getResourceData(t, !0);
-		for (let e of i.fields) {
-			if (r(e.value)) continue;
-			let t = a(e.value);
-			if (t === n) return {
-				id: t,
-				rid: e.value,
-				fieldName: e.name
-			};
-		}
-		for (let t of i.fields) {
-			if (r(t.value)) continue;
-			let i = await e.getKValueStringIfExists(t.value, c);
-			if (i && JSON.parse(i).label === n) return {
-				id: a(t.value),
-				rid: t.value,
-				fieldName: t.name
-			};
-		}
-		throw Error(`Project "${n}" not found (searched by id and label).`);
-	});
-}
-async function v(e, t) {
-	let n = await e.getResourceData(t, !0), i = [];
-	for (let t of n.fields) {
-		if (r(t.value)) continue;
-		let n = await e.getKValueStringIfExists(t.value, c);
-		if (n) {
-			let e = JSON.parse(n);
-			i.push(e.label);
-		}
-	}
-	return i;
-}
-function y(e, t) {
-	let n = `${e} (Copy)`, r = 2;
-	for (; t.includes(n);) n = `${e} (Copy ${r})`, r++;
-	return n;
-}
-async function b(e, t, n) {
-	await e.withWriteTx("renameProject", async (e) => {
-		let r = await e.getKValueString(t, c), i = {
-			...JSON.parse(r),
-			label: n
-		};
-		e.setKValue(t, c, JSON.stringify(i)), e.setKValue(t, s, String(Date.now())), await e.commit();
-	});
-}
-async function x(e, t, r) {
-	await e.withWriteTx("deleteProject", async (e) => {
-		e.removeField(n(t, r)), await e.commit();
-	});
-}
-async function S(e) {
-	return await e.withReadTx("getProjectList", async (e) => {
-		let t = await e.getField({
-			resourceId: e.clientRoot,
-			fieldName: u
-		});
-		if (r(t.value)) throw Error("No project list found for this user.");
-		return t.value;
-	});
-}
-async function C(e, t) {
-	let n;
-	if (n = await e.getUserRoot({ login: t }), n === void 0) throw Error(`User "${t}" not found on this server (no root resource).`);
-	return await e.withReadTx("navigateToUserProjects", async (e) => {
-		let i = await e.getField({
-			resourceId: n,
-			fieldName: u
-		});
-		if (r(i.value)) throw Error(`User "${t}" has no project list.`);
-		return {
-			userRoot: n,
-			projectListRid: i.value
-		};
-	});
-}
-//#endregion
-//#region src/output.ts
-function w(e) {
-	console.log(e);
-}
-function T(e) {
-	console.log(JSON.stringify(e, null, 2));
-}
-function E(e, t) {
-	let n = (e) => /[",\r\n]/.test(e) ? `"${e.replace(/"/g, "\"\"")}"` : e, r = [e, ...t].map((e) => e.map(n).join(","));
-	console.log(r.join("\n"));
-}
-function D(e, t) {
-	let n = e.map((e, n) => Math.max(e.length, ...t.map((e) => (e[n] ?? "").length))), r = n.map((e) => "-".repeat(e)).join("  ");
-	return [
-		e.map((e, t) => e.padEnd(n[t])).join("  "),
-		r,
-		...t.map((e) => e.map((e, t) => (e ?? "").padEnd(n[t])).join("  "))
-	].join("\n");
-}
-function O(e) {
-	return e.getTime() === 0 ? "(unknown)" : e.toISOString().replace("T", " ").replace(/\.\d+Z$/, "Z");
-}
-//#endregion
-export { p as _, w as a, f as c, S as d, h as f, m as g, _ as h, T as i, v as l, b as m, D as n, y as o, C as p, E as r, x as s, O as t, g as u };
-
-//# sourceMappingURL=output-KEq0q5fS.js.map

package/dist/output-KEq0q5fS.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"output-KEq0q5fS.js","names":[],"sources":["../src/connection.ts","../src/project_ops.ts","../src/output.ts"],"sourcesContent":["import {\n  PlClient,\n  UnauthenticatedPlClient,\n  plAddressToConfig,\n  type AuthInformation,\n  type PlClientConfig,\n} from \"@milaboratories/pl-client\";\n\nexport interface PlConnectionOptions {\n  address: string;\n  user?: string;\n  password?: string;\n}\n\nexport interface AdminConnectionOptions {\n  address: string;\n  adminUser: string;\n  adminPassword: string;\n}\n\n/** Creates an authenticated PlClient from address + credentials. */\nexport async function createPlConnection(opts: PlConnectionOptions): Promise<PlClient> {\n  const config: PlClientConfig = plAddressToConfig(opts.address);\n\n  if (opts.user !== undefined) config.user = opts.user;\n  if (opts.password !== undefined) config.password = opts.password;\n\n  const unauth = await UnauthenticatedPlClient.build(config);\n  let authInformation: AuthInformation;\n\n  if (await unauth.requireAuth()) {\n    if (config.user === undefined || config.password === undefined) {\n      throw new Error(\n        \"Server requires authentication but no credentials provided. \" +\n          \"Use --user/--password flags or PL_USER/PL_PASSWORD env vars.\",\n      );\n    }\n    authInformation = await unauth.login(config.user, config.password);\n  } else {\n    authInformation = {};\n  }\n\n  return await PlClient.init(config, { authInformation });\n}\n\n/** Creates a PlClient with admin/controller credentials. */\nexport async function createAdminPlConnection(opts: AdminConnectionOptions): Promise<PlClient> {\n  const config: PlClientConfig = plAddressToConfig(opts.address);\n\n  const unauth = await UnauthenticatedPlClient.build(config);\n  const authInformation: AuthInformation = await unauth.login(opts.adminUser, opts.adminPassword);\n\n  return await PlClient.init(config, { authInformation });\n}\n","import type { PlClient, SignedResourceId, PlTransaction } from \"@milaboratories/pl-client\";\nimport { field, isNullSignedResourceId, resourceIdToString } from \"@milaboratories/pl-client\";\nimport {\n  ProjectMetaKey,\n  ProjectCreatedTimestamp,\n  ProjectLastModifiedTimestamp,\n  SchemaVersionKey,\n  ProjectStructureKey,\n  ProjectsField,\n  duplicateProject,\n} from \"@milaboratories/pl-middle-layer\";\nimport type { ProjectMeta } from \"@milaboratories/pl-middle-layer\";\n\nexport interface ProjectEntry {\n  id: string;\n  rid: SignedResourceId;\n  label: string;\n  created: Date;\n  lastModified: Date;\n}\n\nexport interface ProjectIdentity {\n  /** Project ID (resourceIdToString of resource ID) */\n  id: string;\n  /** Signed resource ID for use in transactions */\n  rid: SignedResourceId;\n  /** UUID field name in the project list resource */\n  fieldName: string;\n}\n\nexport interface ProjectInfo extends ProjectEntry {\n  schemaVersion: string | undefined;\n  blockCount: number;\n  blockIds: string[];\n}\n\n/** List all projects from a project list resource. */\nexport async function listProjects(\n  pl: PlClient,\n  projectListRid: SignedResourceId,\n): Promise<ProjectEntry[]> {\n  return await pl.withReadTx(\"listProjects\", async (tx) => {\n    const data = await tx.getResourceData(projectListRid, true);\n    const entries: ProjectEntry[] = [];\n\n    for (const f of data.fields) {\n      if (isNullSignedResourceId(f.value)) continue;\n\n      const [metaStr, createdStr, modifiedStr] = await Promise.all([\n        tx.getKValueStringIfExists(f.value, ProjectMetaKey),\n        tx.getKValueStringIfExists(f.value, ProjectCreatedTimestamp),\n        tx.getKValueStringIfExists(f.value, ProjectLastModifiedTimestamp),\n      ]);\n\n      const meta: ProjectMeta = metaStr ? JSON.parse(metaStr) : { label: \"(unknown)\" };\n\n      const projectId = resourceIdToString(f.value);\n      entries.push({\n        id: projectId,\n        rid: f.value,\n        label: meta.label,\n        created: createdStr ? new Date(Number(createdStr)) : new Date(0),\n        lastModified: modifiedStr ? new Date(Number(modifiedStr)) : new Date(0),\n      });\n    }\n\n    entries.sort((a, b) => b.lastModified.getTime() - a.lastModified.getTime());\n    return entries;\n  });\n}\n\n/** Get detailed info about a project. */\nexport async function getProjectInfo(\n  pl: PlClient,\n  projectId: string,\n  rid: SignedResourceId,\n): Promise<ProjectInfo> {\n  return await pl.withReadTx(\"getProjectInfo\", async (tx) => {\n    const kvs = await tx.listKeyValuesString(rid);\n\n    const metaKV = kvs.find((kv: { key: string }) => kv.key === ProjectMetaKey);\n    const createdKV = kvs.find((kv: { key: string }) => kv.key === ProjectCreatedTimestamp);\n    const modifiedKV = kvs.find((kv: { key: string }) => kv.key === ProjectLastModifiedTimestamp);\n    const schemaKV = kvs.find((kv: { key: string }) => kv.key === SchemaVersionKey);\n    const structureKV = kvs.find((kv: { key: string }) => kv.key === ProjectStructureKey);\n\n    const meta: ProjectMeta = metaKV ? JSON.parse(metaKV.value) : { label: \"(unknown)\" };\n    const schemaVersion = schemaKV ? JSON.parse(schemaKV.value) : undefined;\n\n    const blockIds: string[] = [];\n    if (structureKV) {\n      const structure = JSON.parse(structureKV.value);\n      for (const group of structure.groups ?? []) {\n        for (const block of group.blocks ?? []) {\n          blockIds.push(block.id);\n        }\n      }\n    }\n\n    return {\n      id: projectId,\n      rid: rid,\n      label: meta.label,\n      created: createdKV ? new Date(Number(createdKV.value)) : new Date(0),\n      lastModified: modifiedKV ? new Date(Number(modifiedKV.value)) : new Date(0),\n      schemaVersion,\n      blockCount: blockIds.length,\n      blockIds,\n    };\n  });\n}\n\n/** Resolve a project identifier (id or label) to its project ID, ResourceId and field name. */\nexport async function resolveProject(\n  pl: PlClient,\n  projectListRid: SignedResourceId,\n  identifier: string,\n): Promise<ProjectIdentity> {\n  return await pl.withReadTx(\"resolveProject\", async (tx) => {\n    const data = await tx.getResourceData(projectListRid, true);\n    for (const f of data.fields) {\n      if (isNullSignedResourceId(f.value)) continue;\n      const projectId = resourceIdToString(f.value);\n      if (projectId === identifier) {\n        return { id: projectId, rid: f.value, fieldName: f.name };\n      }\n    }\n    // Fallback: match by label\n    for (const f of data.fields) {\n      if (isNullSignedResourceId(f.value)) continue;\n      const metaStr = await tx.getKValueStringIfExists(f.value, ProjectMetaKey);\n      if (metaStr) {\n        const meta: ProjectMeta = JSON.parse(metaStr);\n        if (meta.label === identifier) {\n          return { id: resourceIdToString(f.value), rid: f.value, fieldName: f.name };\n        }\n      }\n    }\n\n    throw new Error(`Project \"${identifier}\" not found (searched by id and label).`);\n  });\n}\n\n/** Read all project labels within an existing transaction. */\nexport async function getExistingLabelsInTx(\n  tx: PlTransaction,\n  projectListRid: SignedResourceId,\n): Promise<string[]> {\n  const data = await tx.getResourceData(projectListRid, true);\n  const labels: string[] = [];\n  for (const f of data.fields) {\n    if (isNullSignedResourceId(f.value)) continue;\n    const metaStr = await tx.getKValueStringIfExists(f.value, ProjectMetaKey);\n    if (metaStr) {\n      const meta: ProjectMeta = JSON.parse(metaStr);\n      labels.push(meta.label);\n    }\n  }\n  return labels;\n}\n\n/** Get all project labels from a project list. */\nexport async function getProjectLabels(\n  pl: PlClient,\n  projectListRid: SignedResourceId,\n): Promise<string[]> {\n  return await pl.withReadTx(\"getProjectLabels\", async (tx) => {\n    return getExistingLabelsInTx(tx, projectListRid);\n  });\n}\n\n/**\n * Deduplicates a project name against existing labels.\n * \"X\" → \"X (Copy)\" → \"X (Copy 2)\" → ...\n */\nexport function deduplicateName(baseName: string, existingLabels: string[]): string {\n  let candidate = `${baseName} (Copy)`;\n  let i = 2;\n  while (existingLabels.includes(candidate)) {\n    candidate = `${baseName} (Copy ${i})`;\n    i++;\n  }\n  return candidate;\n}\n\n/** Rename a project (update its label). */\nexport async function renameProject(\n  pl: PlClient,\n  projectRid: SignedResourceId,\n  newLabel: string,\n): Promise<void> {\n  await pl.withWriteTx(\"renameProject\", async (tx) => {\n    const metaStr = await tx.getKValueString(projectRid, ProjectMetaKey);\n    const meta: ProjectMeta = JSON.parse(metaStr);\n    const updated: ProjectMeta = { ...meta, label: newLabel };\n    tx.setKValue(projectRid, ProjectMetaKey, JSON.stringify(updated));\n    tx.setKValue(projectRid, ProjectLastModifiedTimestamp, String(Date.now()));\n    await tx.commit();\n  });\n}\n\n/** Delete a project from the project list. */\nexport async function deleteProject(\n  pl: PlClient,\n  projectListRid: SignedResourceId,\n  fieldName: string,\n): Promise<void> {\n  await pl.withWriteTx(\"deleteProject\", async (tx) => {\n    tx.removeField(field(projectListRid, fieldName));\n    await tx.commit();\n  });\n}\n\n/** Get the project list ResourceId for the connected user. */\nexport async function getProjectListRid(pl: PlClient): Promise<SignedResourceId> {\n  return await pl.withReadTx(\"getProjectList\", async (tx) => {\n    const fieldData = await tx.getField({\n      resourceId: tx.clientRoot,\n      fieldName: ProjectsField,\n    });\n    if (isNullSignedResourceId(fieldData.value)) {\n      throw new Error(\"No project list found for this user.\");\n    }\n    return fieldData.value;\n  });\n}\n\n/**\n * Navigates to a specific user's project list resource ID.\n * Tries ListUserResources first (new backend), falls back to SHA256 named resource lookup.\n */\nexport async function navigateToUserRoot(\n  pl: PlClient,\n  username: string,\n): Promise<{ userRoot: SignedResourceId; projectListRid: SignedResourceId }> {\n  let userRootRid: SignedResourceId | undefined;\n\n  userRootRid = await pl.getUserRoot({ login: username });\n  if (userRootRid === undefined) {\n    throw new Error(`User \"${username}\" not found on this server (no root resource).`);\n  }\n\n  // Read the projects field from the resolved user root\n  return await pl.withReadTx(\"navigateToUserProjects\", async (tx) => {\n    const projectsFieldData = await tx.getField({\n      resourceId: userRootRid,\n      fieldName: ProjectsField,\n    });\n\n    if (isNullSignedResourceId(projectsFieldData.value)) {\n      throw new Error(`User \"${username}\" has no project list.`);\n    }\n\n    return { userRoot: userRootRid, projectListRid: projectsFieldData.value };\n  });\n}\n\n// Re-export duplicateProject from pl-middle-layer for use in commands\nexport { duplicateProject };\n","export type OutputFormat = \"text\" | \"json\" | \"csv\";\n\n/** Outputs a line of text to stdout. */\nexport function outputText(message: string): void {\n  console.log(message);\n}\n\n/** Outputs data as formatted JSON to stdout. */\nexport function outputJson(data: unknown): void {\n  console.log(JSON.stringify(data, null, 2));\n}\n\n/** Outputs a header row + data rows as RFC-4180-ish CSV to stdout. */\nexport function outputCsv(headers: string[], rows: string[][]): void {\n  const esc = (v: string) => (/[\",\\r\\n]/.test(v) ? `\"${v.replace(/\"/g, '\"\"')}\"` : v);\n  const lines = [headers, ...rows].map((r) => r.map(esc).join(\",\"));\n  console.log(lines.join(\"\\n\"));\n}\n\n/** Formats a table as aligned text columns. */\nexport function formatTable(headers: string[], rows: string[][]): string {\n  const colWidths = headers.map((h, i) =>\n    Math.max(h.length, ...rows.map((r) => (r[i] ?? \"\").length)),\n  );\n\n  const sep = colWidths.map((w) => \"-\".repeat(w)).join(\"  \");\n  const headerLine = headers.map((h, i) => h.padEnd(colWidths[i])).join(\"  \");\n  const dataLines = rows.map((row) =>\n    row.map((cell, i) => (cell ?? \"\").padEnd(colWidths[i])).join(\"  \"),\n  );\n\n  return [headerLine, sep, ...dataLines].join(\"\\n\");\n}\n\n/** Formats a Date as a short human-readable string. */\nexport function formatDate(d: Date): string {\n  if (d.getTime() === 0) return \"(unknown)\";\n  return d\n    .toISOString()\n    .replace(\"T\", \" \")\n    .replace(/\\.\\d+Z$/, \"Z\");\n}\n"],"mappings":"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"}