@platforma-sdk/pl-cli 0.2.41 → 0.3.1

package/dist/cli.js

@@ -1,4 +1,4 @@
-import { a as e, c as t, d as n, f as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./output-CXaoTHzT.js";
+import { a as e, c as t, d as n, f as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./output-BLm2ZDFN.js";
 import { Args as g, Command as _, Flags as v } from "@oclif/core";
 import { field as y, toGlobalResourceId as b } from "@milaboratories/pl-client";
 import { ProjectMetaKey as x } from "@milaboratories/pl-middle-layer";

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, d as n, f as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./output-CXaoTHzT.js";
+import { a as e, c as t, d as n, f as r, g as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./output-BLm2ZDFN.js";
 export { a as createAdminPlConnection, i as createPlConnection, e as deduplicateName, u as deleteProject, p as duplicateProject, m as formatDate, l as formatTable, t as getExistingLabelsInTx, s as getProjectInfo, h as getProjectListRid, n as listProjects, r as navigateToUserRoot, f as outputJson, o as outputText, d as renameProject, c as resolveProject };

package/dist/{output-CXaoTHzT.js → output-BLm2ZDFN.js}

@@ -1,56 +1,56 @@
-import { PlClient as e, UnauthenticatedPlClient as t, field as n, isNullResourceId as r, plAddressToConfig as i } from "@milaboratories/pl-client";
-import { ProjectCreatedTimestamp as a, ProjectLastModifiedTimestamp as o, ProjectMetaKey as s, ProjectStructureKey as c, ProjectsField as l, SchemaVersionKey as u, duplicateProject as d } from "@milaboratories/pl-middle-layer";
-import { createHash as f } from "node:crypto";
+import { PlClient as e, UnauthenticatedPlClient as t, field as n, isNullResourceId as r, isUnimplementedError as i, plAddressToConfig 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";
+import { createHash as p } from "node:crypto";
 //#region src/connection.ts
-async function p(n) {
-	let r = i(n.address);
+async function m(n) {
+	let r = a(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()) {
+	let i = await t.build(r), o;
+	if (await i.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);
+		o = await i.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 });
+async function h(n) {
+	let r = a(n.address), i = await (await t.build(r)).login(n.adminUser, n.adminPassword);
+	return await e.init(r, { authInformation: i });
 }
 //#endregion
 //#region src/project_ops.ts
-async function h(e, t) {
+async function g(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, c, l] = await Promise.all([
-				e.getKValueStringIfExists(t.value, s),
-				e.getKValueStringIfExists(t.value, a),
-				e.getKValueStringIfExists(t.value, o)
+			let [n, a, l] = await Promise.all([
+				e.getKValueStringIfExists(t.value, c),
+				e.getKValueStringIfExists(t.value, o),
+				e.getKValueStringIfExists(t.value, s)
 			]), u = n ? JSON.parse(n) : { label: "(unknown)" };
 			i.push({
 				id: t.name,
 				rid: String(t.value),
 				label: u.label,
-				created: c ? new Date(Number(c)) : /* @__PURE__ */ new Date(0),
+				created: a ? new Date(Number(a)) : /* @__PURE__ */ new Date(0),
 				lastModified: l ? new Date(Number(l)) : /* @__PURE__ */ new Date(0)
 			});
 		}
 		return i.sort((e, t) => t.lastModified.getTime() - e.lastModified.getTime()), i;
 	});
 }
-async function g(e, t, i) {
+async function _(e, t, i) {
 	return await e.withReadTx("getProjectInfo", async (e) => {
-		let l = await e.getField(n(t, i));
-		if (r(l.value)) throw Error(`Project "${i}" not found.`);
-		let d = l.value, f = await e.listKeyValuesString(d), p = f.find((e) => e.key === s), m = f.find((e) => e.key === a), h = f.find((e) => e.key === o), g = f.find((e) => e.key === u), _ = f.find((e) => e.key === c), v = p ? JSON.parse(p.value) : { label: "(unknown)" }, y = g ? JSON.parse(g.value) : void 0, b = [];
+		let a = await e.getField(n(t, i));
+		if (r(a.value)) throw Error(`Project "${i}" not found.`);
+		let u = a.value, f = await e.listKeyValuesString(u), p = f.find((e) => e.key === c), m = f.find((e) => e.key === o), h = f.find((e) => e.key === s), g = f.find((e) => e.key === d), _ = f.find((e) => e.key === l), v = p ? JSON.parse(p.value) : { label: "(unknown)" }, y = g ? JSON.parse(g.value) : void 0, b = [];
 		if (_) {
 			let e = JSON.parse(_.value);
 			for (let t of e.groups ?? []) for (let e of t.blocks ?? []) b.push(e.id);
 		}
 		return {
 			id: i,
-			rid: String(d),
+			rid: String(u),
 			label: v.label,
 			created: m ? new Date(Number(m.value)) : /* @__PURE__ */ new Date(0),
 			lastModified: h ? new Date(Number(h.value)) : /* @__PURE__ */ new Date(0),
@@ -60,7 +60,7 @@ async function g(e, t, i) {
 		};
 	});
 }
-async function _(e, t, n) {
+async function v(e, t, n) {
 	return await e.withReadTx("resolveProject", async (e) => {
 		let i = await e.getResourceData(t, !0);
 		for (let t of i.fields) {
@@ -69,7 +69,7 @@ async function _(e, t, n) {
 				id: t.name,
 				rid: t.value
 			};
-			let i = await e.getKValueStringIfExists(t.value, s);
+			let i = await e.getKValueStringIfExists(t.value, c);
 			if (i && JSON.parse(i).label === n) return {
 				id: t.name,
 				rid: t.value
@@ -78,11 +78,11 @@ async function _(e, t, n) {
 		throw Error(`Project "${n}" not found (searched by id and label).`);
 	});
 }
-async function v(e, t) {
+async function y(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, s);
+		let n = await e.getKValueStringIfExists(t.value, c);
 		if (n) {
 			let e = JSON.parse(n);
 			i.push(e.label);
@@ -90,59 +90,70 @@ async function v(e, t) {
 	}
 	return i;
 }
-function y(e, t) {
+function b(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) {
+async function x(e, t, n) {
 	await e.withWriteTx("renameProject", async (e) => {
-		let r = await e.getKValueString(t, s), i = {
+		let r = await e.getKValueString(t, c), i = {
 			...JSON.parse(r),
 			label: n
 		};
-		e.setKValue(t, s, JSON.stringify(i)), e.setKValue(t, o, String(Date.now())), await e.commit();
+		e.setKValue(t, c, JSON.stringify(i)), e.setKValue(t, s, String(Date.now())), await e.commit();
 	});
 }
-async function x(e, t, r) {
+async function S(e, t, r) {
 	await e.withWriteTx("deleteProject", async (e) => {
 		e.removeField(n(t, r)), await e.commit();
 	});
 }
-async function S(e) {
+async function C(e) {
 	return await e.withReadTx("getProjectList", async (e) => {
 		let t = await e.getField({
 			resourceId: e.clientRoot,
-			fieldName: l
+			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 = f("sha256").update(t).digest("hex");
+async function w(e, t) {
+	let n;
+	try {
+		n = await e.getUserRoot({ login: t });
+	} catch (e) {
+		if (!i(e)) throw e;
+	}
+	if (n === void 0) {
+		let r = p("sha256").update(t).digest("hex");
+		n = await e.withReadTx("navigateToUserRoot:legacy", async (e) => {
+			if (!await e.checkResourceNameExists(r)) throw Error(`User "${t}" not found on this server (no root resource).`);
+			return await e.getResourceByName(r);
+		});
+	}
 	return await e.withReadTx("navigateToUserRoot", async (e) => {
-		if (!await e.checkResourceNameExists(n)) throw Error(`User "${t}" not found on this server (no root resource).`);
-		let i = await e.getResourceByName(n), a = await e.getField({
-			resourceId: i,
-			fieldName: l
+		let i = await e.getField({
+			resourceId: n,
+			fieldName: u
 		});
-		if (r(a.value)) throw Error(`User "${t}" has no project list.`);
+		if (r(i.value)) throw Error(`User "${t}" has no project list.`);
 		return {
-			userRoot: i,
-			projectListRid: a.value
+			userRoot: n,
+			projectListRid: i.value
 		};
 	});
 }
 //#endregion
 //#region src/output.ts
-function w(e) {
+function T(e) {
 	console.log(e);
 }
-function T(e) {
+function E(e) {
 	console.log(JSON.stringify(e, null, 2));
 }
-function E(e, t) {
+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("  "),
@@ -150,10 +161,10 @@ function E(e, t) {
 		...t.map((e) => e.map((e, t) => (e ?? "").padEnd(n[t])).join("  "))
 	].join("\n");
 }
-function D(e) {
+function O(e) {
 	return e.getTime() === 0 ? "(unknown)" : e.toISOString().replace("T", " ").replace(/\.\d+Z$/, "Z");
 }
 //#endregion
-export { y as a, v as c, h as d, C as f, p as g, m as h, w as i, g as l, _ as m, E as n, x as o, b as p, T as r, d as s, D as t, S as u };
+export { b as a, y as c, g as d, w as f, m as g, h, T as i, _ as l, v as m, D as n, S as o, x as p, E as r, f as s, O as t, C as u };
 
-//# sourceMappingURL=output-CXaoTHzT.js.map
+//# sourceMappingURL=output-BLm2ZDFN.js.map

package/dist/output-BLm2ZDFN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-BLm2ZDFN.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, ResourceId, PlTransaction } from \"@milaboratories/pl-client\";\nimport { field, isNullResourceId, isUnimplementedError } 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\";\nimport { createHash } from \"node:crypto\";\n\nexport interface ProjectEntry {\n  id: string;\n  rid: string;\n  label: string;\n  created: Date;\n  lastModified: Date;\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: ResourceId,\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 (isNullResourceId(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      entries.push({\n        id: f.name,\n        rid: String(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  projectListRid: ResourceId,\n  projectId: string,\n): Promise<ProjectInfo> {\n  return await pl.withReadTx(\"getProjectInfo\", async (tx) => {\n    const fieldData = await tx.getField(field(projectListRid, projectId));\n    if (isNullResourceId(fieldData.value)) {\n      throw new Error(`Project \"${projectId}\" not found.`);\n    }\n\n    const rid = fieldData.value;\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: String(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 field ID and ResourceId. */\nexport async function resolveProject(\n  pl: PlClient,\n  projectListRid: ResourceId,\n  identifier: string,\n): Promise<{ id: string; rid: ResourceId }> {\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 (isNullResourceId(f.value)) continue;\n      if (f.name === identifier) {\n        return { id: f.name, rid: f.value };\n      }\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: f.name, rid: f.value };\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: ResourceId,\n): Promise<string[]> {\n  const data = await tx.getResourceData(projectListRid, true);\n  const labels: string[] = [];\n  for (const f of data.fields) {\n    if (isNullResourceId(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: ResourceId,\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: ResourceId,\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: ResourceId,\n  projectId: string,\n): Promise<void> {\n  await pl.withWriteTx(\"deleteProject\", async (tx) => {\n    tx.removeField(field(projectListRid, projectId));\n    await tx.commit();\n  });\n}\n\n/** Get the project list ResourceId for the connected user. */\nexport async function getProjectListRid(pl: PlClient): Promise<ResourceId> {\n  return await pl.withReadTx(\"getProjectList\", async (tx) => {\n    const fieldData = await tx.getField({\n      resourceId: tx.clientRoot,\n      fieldName: ProjectsField,\n    });\n    if (isNullResourceId(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: ResourceId; projectListRid: ResourceId }> {\n  let userRootRid: ResourceId | undefined;\n\n  // Try new ListUserResources API first\n  try {\n    userRootRid = await pl.getUserRoot({ login: username });\n  } catch (err) {\n    if (!isUnimplementedError(err)) throw err;\n    // Backend doesn't support ListUserResources — fall through to legacy\n  }\n\n  // Legacy fallback: SHA256 named resource lookup\n  if (userRootRid === undefined) {\n    const rootName = createHash(\"sha256\").update(username).digest(\"hex\");\n    userRootRid = await pl.withReadTx(\"navigateToUserRoot:legacy\", async (tx) => {\n      if (!(await tx.checkResourceNameExists(rootName))) {\n        throw new Error(`User \"${username}\" not found on this server (no root resource).`);\n      }\n      return await tx.getResourceByName(rootName);\n    });\n  }\n\n  // Read the projects field from the resolved user root\n  return await pl.withReadTx(\"navigateToUserRoot\", async (tx) => {\n    const projectsFieldData = await tx.getField({\n      resourceId: userRootRid!,\n      fieldName: ProjectsField,\n    });\n\n    if (isNullResourceId(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\";\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/** 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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"}

package/dist/project_ops.d.ts

@@ -38,7 +38,7 @@ export declare function deleteProject(pl: PlClient, projectListRid: ResourceId,
 export declare function getProjectListRid(pl: PlClient): Promise<ResourceId>;
 /**
  * Navigates to a specific user's project list resource ID.
- * Computes SHA256(username) to find the user's root, then reads the "projects" field.
+ * Tries ListUserResources first (new backend), falls back to SHA256 named resource lookup.
  */
 export declare function navigateToUserRoot(pl: PlClient, username: string): Promise<{
     userRoot: ResourceId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/pl-cli",
-  "version": "0.2.41",
+  "version": "0.3.1",
   "description": "CLI for Platforma server state manipulation",
   "license": "UNLICENSED",
   "bin": {
@@ -23,8 +23,8 @@
   },
   "dependencies": {
     "@oclif/core": "^4.0.37",
-    "@milaboratories/pl-client": "3.1.8",
-    "@milaboratories/pl-middle-layer": "1.55.23"
+    "@milaboratories/pl-client": "3.2.1",
+    "@milaboratories/pl-middle-layer": "1.55.25"
   },
   "devDependencies": {
     "@types/node": "~24.5.2",
@@ -34,8 +34,8 @@
     "vite-plugin-dts": "^4.5.3",
     "vitest": "^4.1.3",
     "@milaboratories/build-configs": "2.0.0",
-    "@milaboratories/ts-builder": "1.3.2",
     "@milaboratories/oclif-index": "1.1.1",
+    "@milaboratories/ts-builder": "1.3.2",
     "@milaboratories/ts-configs": "1.2.3"
   },
   "oclif": {

package/src/project_ops.ts

@@ -1,5 +1,5 @@
 import type { PlClient, ResourceId, PlTransaction } from "@milaboratories/pl-client";
-import { field, isNullResourceId } from "@milaboratories/pl-client";
+import { field, isNullResourceId, isUnimplementedError } from "@milaboratories/pl-client";
 import {
   ProjectMetaKey,
   ProjectCreatedTimestamp,
@@ -219,23 +219,37 @@ export async function getProjectListRid(pl: PlClient): Promise<ResourceId> {
 
 /**
  * Navigates to a specific user's project list resource ID.
- * Computes SHA256(username) to find the user's root, then reads the "projects" field.
+ * Tries ListUserResources first (new backend), falls back to SHA256 named resource lookup.
  */
 export async function navigateToUserRoot(
   pl: PlClient,
   username: string,
 ): Promise<{ userRoot: ResourceId; projectListRid: ResourceId }> {
-  const rootName = createHash("sha256").update(username).digest("hex");
+  let userRootRid: ResourceId | undefined;
 
-  return await pl.withReadTx("navigateToUserRoot", async (tx) => {
-    if (!(await tx.checkResourceNameExists(rootName))) {
-      throw new Error(`User "${username}" not found on this server (no root resource).`);
-    }
+  // Try new ListUserResources API first
+  try {
+    userRootRid = await pl.getUserRoot({ login: username });
+  } catch (err) {
+    if (!isUnimplementedError(err)) throw err;
+    // Backend doesn't support ListUserResources — fall through to legacy
+  }
 
-    const userRootRid = await tx.getResourceByName(rootName);
+  // Legacy fallback: SHA256 named resource lookup
+  if (userRootRid === undefined) {
+    const rootName = createHash("sha256").update(username).digest("hex");
+    userRootRid = await pl.withReadTx("navigateToUserRoot:legacy", async (tx) => {
+      if (!(await tx.checkResourceNameExists(rootName))) {
+        throw new Error(`User "${username}" not found on this server (no root resource).`);
+      }
+      return await tx.getResourceByName(rootName);
+    });
+  }
 
+  // Read the projects field from the resolved user root
+  return await pl.withReadTx("navigateToUserRoot", async (tx) => {
     const projectsFieldData = await tx.getField({
-      resourceId: userRootRid,
+      resourceId: userRootRid!,
       fieldName: ProjectsField,
     });
 
@@ -243,7 +257,7 @@ export async function navigateToUserRoot(
       throw new Error(`User "${username}" has no project list.`);
     }
 
-    return { userRoot: userRootRid, projectListRid: projectsFieldData.value };
+    return { userRoot: userRootRid!, projectListRid: projectsFieldData.value };
   });
 }
 

package/dist/output-CXaoTHzT.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"output-CXaoTHzT.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, ResourceId, PlTransaction } from \"@milaboratories/pl-client\";\nimport { field, isNullResourceId } 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\";\nimport { createHash } from \"node:crypto\";\n\nexport interface ProjectEntry {\n  id: string;\n  rid: string;\n  label: string;\n  created: Date;\n  lastModified: Date;\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: ResourceId,\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 (isNullResourceId(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      entries.push({\n        id: f.name,\n        rid: String(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  projectListRid: ResourceId,\n  projectId: string,\n): Promise<ProjectInfo> {\n  return await pl.withReadTx(\"getProjectInfo\", async (tx) => {\n    const fieldData = await tx.getField(field(projectListRid, projectId));\n    if (isNullResourceId(fieldData.value)) {\n      throw new Error(`Project \"${projectId}\" not found.`);\n    }\n\n    const rid = fieldData.value;\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: String(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 field ID and ResourceId. */\nexport async function resolveProject(\n  pl: PlClient,\n  projectListRid: ResourceId,\n  identifier: string,\n): Promise<{ id: string; rid: ResourceId }> {\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 (isNullResourceId(f.value)) continue;\n      if (f.name === identifier) {\n        return { id: f.name, rid: f.value };\n      }\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: f.name, rid: f.value };\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: ResourceId,\n): Promise<string[]> {\n  const data = await tx.getResourceData(projectListRid, true);\n  const labels: string[] = [];\n  for (const f of data.fields) {\n    if (isNullResourceId(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: ResourceId,\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: ResourceId,\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: ResourceId,\n  projectId: string,\n): Promise<void> {\n  await pl.withWriteTx(\"deleteProject\", async (tx) => {\n    tx.removeField(field(projectListRid, projectId));\n    await tx.commit();\n  });\n}\n\n/** Get the project list ResourceId for the connected user. */\nexport async function getProjectListRid(pl: PlClient): Promise<ResourceId> {\n  return await pl.withReadTx(\"getProjectList\", async (tx) => {\n    const fieldData = await tx.getField({\n      resourceId: tx.clientRoot,\n      fieldName: ProjectsField,\n    });\n    if (isNullResourceId(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 * Computes SHA256(username) to find the user's root, then reads the \"projects\" field.\n */\nexport async function navigateToUserRoot(\n  pl: PlClient,\n  username: string,\n): Promise<{ userRoot: ResourceId; projectListRid: ResourceId }> {\n  const rootName = createHash(\"sha256\").update(username).digest(\"hex\");\n\n  return await pl.withReadTx(\"navigateToUserRoot\", async (tx) => {\n    if (!(await tx.checkResourceNameExists(rootName))) {\n      throw new Error(`User \"${username}\" not found on this server (no root resource).`);\n    }\n\n    const userRootRid = await tx.getResourceByName(rootName);\n\n    const projectsFieldData = await tx.getField({\n      resourceId: userRootRid,\n      fieldName: ProjectsField,\n    });\n\n    if (isNullResourceId(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\";\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/** 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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"}