@platforma-sdk/pl-cli 0.7.70 → 0.7.72

package/bin/run.mjs

@@ -1,10 +1,8 @@
 #!/usr/bin/env node
 
-import { run, handle, flush } from "@oclif/core";
+import { run } from "../dist/cli.js";
 
-// eslint-disable-next-line unicorn/prefer-top-level-await
-run(process.argv.slice(2), import.meta.url)
-  .catch(async (error) => {
-    return handle(error);
-  })
-  .finally(async () => flush());
+run(process.argv).catch((error) => {
+  console.error(`error: ${error?.message ?? error}`);
+  process.exitCode = 1;
+});

package/dist/base_command.d.ts

@@ -1,43 +1,32 @@
-import { Command } from '@oclif/core';
 import { PlClient, SignedResourceId } from '@milaboratories/pl-client';
-/** Base command with dual-mode connection: user auth or admin + target-user. */
-export declare abstract class PlCommand extends Command {
-    static baseFlags: {
-        "admin-user": import('@oclif/core/interfaces').OptionFlag<string | undefined, import('@oclif/core/interfaces').CustomOptions>;
-        "admin-password": import('@oclif/core/interfaces').OptionFlag<string | undefined, import('@oclif/core/interfaces').CustomOptions>;
-        "target-user": import('@oclif/core/interfaces').OptionFlag<string | undefined, import('@oclif/core/interfaces').CustomOptions>;
-        user: import('@oclif/core/interfaces').OptionFlag<string | undefined, import('@oclif/core/interfaces').CustomOptions>;
-        password: import('@oclif/core/interfaces').OptionFlag<string | undefined, import('@oclif/core/interfaces').CustomOptions>;
-        address: import('@oclif/core/interfaces').OptionFlag<string, import('@oclif/core/interfaces').CustomOptions>;
-        format: import('@oclif/core/interfaces').OptionFlag<string, import('@oclif/core/interfaces').CustomOptions>;
-    };
-    private _pl?;
-    /**
-     * Low-level: get an authenticated PlClient without resolving a project list.
-     * Use this for commands that navigate to multiple users (e.g. admin copy-project).
-     */
-    protected connectClient(flags: {
-        address: string;
-        user?: string;
-        password?: string;
-        "admin-user"?: string;
-        "admin-password"?: string;
-    }): Promise<PlClient>;
-    /**
-     * Connect and resolve the project list for a single user.
-     * In admin mode (--admin-user + --admin-password + --target-user), operates on the target user's data.
-     * In user mode, operates on the authenticated user's own data.
-     */
-    protected connect(flags: {
-        address: string;
-        user?: string;
-        password?: string;
-        "admin-user"?: string;
-        "admin-password"?: string;
-        "target-user"?: string;
-    }): Promise<{
-        pl: PlClient;
-        projectListRid: SignedResourceId;
-    }>;
-    protected finally(_: Error | undefined): Promise<void>;
-}
+/**
+ * Low-level: get an authenticated PlClient without resolving a project list.
+ * Use this for commands that navigate to multiple users (e.g. admin copy-project).
+ *
+ * Callers own the returned client and must `await pl.close()` when done.
+ */
+export declare function connectClient(flags: {
+    address: string;
+    user?: string;
+    password?: string;
+    adminUser?: string;
+    adminPassword?: string;
+}): Promise<PlClient>;
+/**
+ * Connect and resolve the project list for a single user.
+ * In admin mode (--admin-user + --admin-password + --target-user), operates on the target user's data.
+ * In user mode, operates on the authenticated user's own data.
+ *
+ * Callers own the returned client and must `await pl.close()` when done.
+ */
+export declare function connect(flags: {
+    address: string;
+    user?: string;
+    password?: string;
+    adminUser?: string;
+    adminPassword?: string;
+    targetUser?: string;
+}): Promise<{
+    pl: PlClient;
+    projectListRid: SignedResourceId;
+}>;

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function buildProgram(): Command;
+export declare function run(argv?: string[]): Promise<void>;

package/dist/cli.js

@@ -1,106 +1,59 @@
 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-Npj-8KEL.js";
-import { Args as g, Command as _, Flags as v } from "@oclif/core";
-import { field as y, resourceIdToString as b } from "@milaboratories/pl-client";
-import { ProjectMetaKey as x } from "@milaboratories/pl-middle-layer";
-import { randomUUID as S } from "node:crypto";
-import { createInterface as C } from "node:readline";
-//#region src/cmd-opts.ts
-var w = {
-	address: v.string({
-		char: "a",
-		summary: "Platforma server address",
-		helpValue: "<url>",
-		env: "PL_ADDRESS",
-		required: !0
-	}),
-	format: v.string({
-		char: "f",
-		summary: "Output format",
-		options: ["text", "json"],
-		default: "text"
-	})
-}, T = {
-	user: v.string({
-		char: "u",
-		summary: "Username for authentication",
-		env: "PL_USER"
-	}),
-	password: v.string({
-		char: "p",
-		summary: "Password for authentication",
-		env: "PL_PASSWORD"
-	})
-}, E = {
-	"admin-user": v.string({
-		summary: "Admin/controller username",
-		env: "PL_ADMIN_USER",
-		required: !0
-	}),
-	"admin-password": v.string({
-		summary: "Admin/controller password",
-		env: "PL_ADMIN_PASSWORD",
-		required: !0
-	})
-}, D = {
-	"admin-user": v.string({
-		summary: "Admin/controller username (enables admin mode)",
-		env: "PL_ADMIN_USER"
-	}),
-	"admin-password": v.string({
-		summary: "Admin/controller password",
-		env: "PL_ADMIN_PASSWORD"
-	}),
-	"target-user": v.string({
-		summary: "Operate on this user's data (requires admin credentials)",
-		env: "PL_TARGET_USER"
-	})
-}, O = class extends _ {
-	static baseFlags = {
-		...w,
-		...T,
-		...D
+import { Command as g, Option as _ } from "commander";
+import { field as v, resourceIdToString as y } from "@milaboratories/pl-client";
+import { ProjectMetaKey as b } from "@milaboratories/pl-middle-layer";
+import { randomUUID as x } from "node:crypto";
+import { createInterface as S } from "node:readline";
+//#region src/base_command.ts
+async function C(e) {
+	return e.adminUser && e.adminPassword ? a({
+		address: e.address,
+		adminUser: e.adminUser,
+		adminPassword: e.adminPassword
+	}) : i({
+		address: e.address,
+		user: e.user,
+		password: e.password
+	});
+}
+async function w(e) {
+	let t = !!e.adminUser, n = !!e.adminPassword, i = !!e.targetUser;
+	if (i && !(t && n)) throw Error("--target-user requires --admin-user and --admin-password");
+	if ((t || n) && !i) throw Error("--admin-user/--admin-password require --target-user for project commands");
+	let a = await C(e), o;
+	return o = i ? (await r(a, e.targetUser)).projectListRid : await h(a), {
+		pl: a,
+		projectListRid: o
 	};
-	_pl;
-	async connectClient(e) {
-		if (this._pl) throw Error("connectClient() called twice");
-		return e["admin-user"] && e["admin-password"] ? this._pl = await a({
-			address: e.address,
-			adminUser: e["admin-user"],
-			adminPassword: e["admin-password"]
-		}) : this._pl = await i({
-			address: e.address,
-			user: e.user,
-			password: e.password
-		}), this._pl;
-	}
-	async connect(e) {
-		let t = !!e["admin-user"], n = !!e["admin-password"], i = !!e["target-user"];
-		if (i && !(t && n)) throw Error("--target-user requires --admin-user and --admin-password");
-		if ((t || n) && !i) throw Error("--admin-user/--admin-password require --target-user for project commands");
-		let a = await this.connectClient(e), o;
-		return o = i ? (await r(a, e["target-user"])).projectListRid : await h(a), {
-			pl: a,
-			projectListRid: o
-		};
-	}
-	async finally(e) {
-		this._pl && await this._pl.close();
-	}
-}, k = {
-	"project:list": class e extends O {
-		static description = "List all projects for the authenticated user.";
-		static flags = { ...O.baseFlags };
-		async run() {
-			let { flags: t } = await this.parse(e), { pl: r, projectListRid: i } = await this.connect(t), a = await n(r, i);
-			if (t.format === "json") f(a.map((e) => ({
+}
+//#endregion
+//#region src/cmd-opts.ts
+function T(e, ...t) {
+	for (let n of t) for (let t of n) e.addOption(t);
+	return e;
+}
+var E = () => [new _("-a, --address <url>", "Platforma server address").env("PL_ADDRESS").makeOptionMandatory(), new _("-f, --format <format>", "Output format").choices(["text", "json"]).default("text")], D = () => [new _("-u, --user <user>", "Username for authentication").env("PL_USER"), new _("-p, --password <password>", "Password for authentication").env("PL_PASSWORD")], O = () => [new _("--admin-user <user>", "Admin/controller username").env("PL_ADMIN_USER").makeOptionMandatory(), new _("--admin-password <password>", "Admin/controller password").env("PL_ADMIN_PASSWORD").makeOptionMandatory()], k = () => [
+	new _("--admin-user <user>", "Admin/controller username (enables admin mode)").env("PL_ADMIN_USER"),
+	new _("--admin-password <password>", "Admin/controller password").env("PL_ADMIN_PASSWORD"),
+	new _("--target-user <user>", "Operate on this user's data (requires admin credentials)").env("PL_TARGET_USER")
+];
+//#endregion
+//#region src/cmd/project/list.ts
+function A() {
+	let e = new g("list").description("List all projects for the authenticated user.");
+	return T(e, E(), D(), k()), e.action(async (e) => {
+		let { pl: t, projectListRid: r } = await w(e);
+		try {
+			let i = await n(t, r);
+			if (e.format === "json") f(i.map((e) => ({
 				id: e.id,
-				rid: b(e.rid),
+				rid: y(e.rid),
 				label: e.label,
 				created: e.created.toISOString(),
 				lastModified: e.lastModified.toISOString()
 			})));
 			else {
-				if (a.length === 0) {
+				if (i.length === 0) {
 					o("No projects found.");
 					return;
 				}
@@ -110,130 +63,112 @@ var w = {
 					"LABEL",
 					"CREATED",
 					"LAST MODIFIED"
-				], a.map((e) => [
+				], i.map((e) => [
 					e.id,
-					b(e.rid),
+					y(e.rid),
 					e.label,
 					m(e.created),
 					m(e.lastModified)
-				]))), o(`\n${a.length} project(s)`);
+				]))), o(`\n${i.length} project(s)`);
 			}
+		} finally {
+			await t.close();
 		}
-	},
-	"project:info": class e extends O {
-		static description = "Show detailed information about a project.";
-		static args = { project: g.string({
-			description: "Project ID or label",
-			required: !0
-		}) };
-		static flags = { ...O.baseFlags };
-		async run() {
-			let { args: t, flags: n } = await this.parse(e), { pl: r, projectListRid: i } = await this.connect(n), { id: a, rid: l } = await c(r, i, t.project), u = await s(r, a, l);
-			if (n.format === "json") f({
-				id: u.id,
-				rid: b(u.rid),
-				label: u.label,
-				schemaVersion: u.schemaVersion,
-				blockCount: u.blockCount,
-				blockIds: u.blockIds,
-				created: u.created.toISOString(),
-				lastModified: u.lastModified.toISOString()
+	}), e;
+}
+//#endregion
+//#region src/cmd/project/info.ts
+function j() {
+	let e = new g("info").description("Show detailed information about a project.");
+	return e.argument("<project>", "Project ID or label"), T(e, E(), D(), k()), e.action(async (e, t) => {
+		let { pl: n, projectListRid: r } = await w(t);
+		try {
+			let { id: i, rid: a } = await c(n, r, e), l = await s(n, i, a);
+			if (t.format === "json") f({
+				id: l.id,
+				rid: y(l.rid),
+				label: l.label,
+				schemaVersion: l.schemaVersion,
+				blockCount: l.blockCount,
+				blockIds: l.blockIds,
+				created: l.created.toISOString(),
+				lastModified: l.lastModified.toISOString()
 			});
 			else {
-				if (o(`Project: ${u.label}`), o(`ID:      ${u.id}`), o(`RID:     ${b(u.rid)}`), o(`Schema:  ${u.schemaVersion ?? "(unknown)"}`), o(`Blocks:  ${u.blockCount}`), u.blockIds.length > 0) for (let e of u.blockIds) o(`  - ${e}`);
-				o(`Created:       ${m(u.created)}`), o(`Last Modified: ${m(u.lastModified)}`);
+				if (o(`Project: ${l.label}`), o(`ID:      ${l.id}`), o(`RID:     ${y(l.rid)}`), o(`Schema:  ${l.schemaVersion ?? "(unknown)"}`), o(`Blocks:  ${l.blockCount}`), l.blockIds.length > 0) for (let e of l.blockIds) o(`  - ${e}`);
+				o(`Created:       ${m(l.created)}`), o(`Last Modified: ${m(l.lastModified)}`);
 			}
+		} finally {
+			await n.close();
 		}
-	},
-	"project:duplicate": class n extends O {
-		static description = "Duplicate a project within the same user. Auto-renames on collision by default.";
-		static args = { project: g.string({
-			description: "Project ID or label",
-			required: !0
-		}) };
-		static flags = {
-			...O.baseFlags,
-			name: v.string({
-				char: "n",
-				summary: "Name for the duplicate",
-				helpValue: "<name>"
-			}),
-			"auto-rename": v.boolean({
-				summary: "Auto-rename on collision (default: true)",
-				default: !0,
-				allowNo: !0
-			})
-		};
-		async run() {
-			let { args: r, flags: i } = await this.parse(n), { pl: a, projectListRid: s } = await this.connect(i), { rid: l } = await c(a, s, r.project), u = S(), d = await a.withWriteTx("duplicateProject", async (n) => {
-				let r = await n.getKValueString(l, x), a = JSON.parse(r).label, o = await t(n, s), c;
-				if (i.name) {
-					if (!i["auto-rename"] && o.includes(i.name)) throw Error(`Project name "${i.name}" already exists.`);
-					c = o.includes(i.name) ? e(i.name, o) : i.name;
-				} else c = e(a, o);
-				let d = await p(n, l, { label: c });
-				n.createField(y(s, u), "Dynamic", d), await n.commit();
+	}), e;
+}
+//#endregion
+//#region src/cmd/project/duplicate.ts
+function M() {
+	let n = new g("duplicate").description("Duplicate a project within the same user. Auto-renames on collision by default.");
+	return n.argument("<project>", "Project ID or label"), T(n, E(), D(), k()), n.option("-n, --name <name>", "Name for the duplicate"), n.addOption(new _("--auto-rename", "Auto-rename on collision (default: true)").default(!0)), n.option("--no-auto-rename", "Fail on name collision instead of auto-renaming"), n.action(async (n, r) => {
+		let { pl: i, projectListRid: a } = await w(r);
+		try {
+			let { rid: s } = await c(i, a, n), l = x(), u = await i.withWriteTx("duplicateProject", async (n) => {
+				let i = await n.getKValueString(s, b), o = JSON.parse(i).label, c = await t(n, a), u;
+				if (r.name) {
+					if (!r.autoRename && c.includes(r.name)) throw Error(`Project name "${r.name}" already exists.`);
+					u = c.includes(r.name) ? e(r.name, c) : r.name;
+				} else u = e(o, c);
+				let d = await p(n, s, { label: u });
+				n.createField(v(a, l), "Dynamic", d), await n.commit();
 				let f = await d.globalId;
 				return {
-					id: b(f),
+					id: y(f),
 					rid: f,
-					label: c
+					label: u
 				};
 			});
-			i.format === "json" ? f({
-				id: d.id,
-				rid: b(d.rid),
-				label: d.label
-			}) : o(`Duplicated project as "${d.label}" (id: ${d.id})`);
+			r.format === "json" ? f({
+				id: u.id,
+				rid: y(u.rid),
+				label: u.label
+			}) : o(`Duplicated project as "${u.label}" (id: ${u.id})`);
+		} finally {
+			await i.close();
 		}
-	},
-	"project:rename": class e extends O {
-		static description = "Rename a project.";
-		static args = { project: g.string({
-			description: "Project ID or label",
-			required: !0
-		}) };
-		static flags = {
-			...O.baseFlags,
-			name: v.string({
-				char: "n",
-				summary: "New name for the project",
-				helpValue: "<name>",
-				required: !0
-			})
-		};
-		async run() {
-			let { args: t, flags: n } = await this.parse(e), { pl: r, projectListRid: i } = await this.connect(n), { id: a, rid: s } = await c(r, i, t.project);
-			await d(r, s, n.name), n.format === "json" ? f({
-				id: a,
-				rid: b(s),
-				label: n.name
-			}) : o(`Renamed project to "${n.name}"`);
+	}), n;
+}
+//#endregion
+//#region src/cmd/project/rename.ts
+function N() {
+	let e = new g("rename").description("Rename a project.");
+	return e.argument("<project>", "Project ID or label"), T(e, E(), D(), k()), e.addOption(new _("-n, --name <name>", "New name for the project").makeOptionMandatory()), e.action(async (e, t) => {
+		let { pl: n, projectListRid: r } = await w(t);
+		try {
+			let { id: i, rid: a } = await c(n, r, e);
+			await d(n, a, t.name), t.format === "json" ? f({
+				id: i,
+				rid: y(a),
+				label: t.name
+			}) : o(`Renamed project to "${t.name}"`);
+		} finally {
+			await n.close();
 		}
-	},
-	"project:delete": class e extends O {
-		static description = "Delete a project. This permanently destroys all project data.";
-		static args = { project: g.string({
-			description: "Project ID or label",
-			required: !0
-		}) };
-		static flags = {
-			...O.baseFlags,
-			force: v.boolean({
-				summary: "Skip confirmation",
-				default: !1
-			})
-		};
-		async run() {
-			let { args: t, flags: n } = await this.parse(e), { pl: r, projectListRid: i } = await this.connect(n), { id: a, rid: l, fieldName: d } = await c(r, i, t.project), p = await s(r, a, l);
-			if (!n.force) {
-				let e = C({
+	}), e;
+}
+//#endregion
+//#region src/cmd/project/delete.ts
+function P() {
+	let e = new g("delete").description("Delete a project. This permanently destroys all project data.");
+	return e.argument("<project>", "Project ID or label"), T(e, E(), D(), k()), e.option("--force", "Skip confirmation", !1), e.action(async (e, t) => {
+		let { pl: n, projectListRid: r } = await w(t);
+		try {
+			let { id: i, rid: a, fieldName: l } = await c(n, r, e), d = await s(n, i, a);
+			if (!t.force) {
+				let e = S({
 					input: process.stdin,
 					output: process.stderr
 				});
 				try {
 					if ((await new Promise((t) => {
-						e.question(`Delete project "${p.label}" (${p.blockCount} blocks)? [y/N] `, t);
+						e.question(`Delete project "${d.label}" (${d.blockCount} blocks)? [y/N] `, t);
 					})).toLowerCase() !== "y") {
 						o("Aborted.");
 						return;
@@ -242,65 +177,64 @@ var w = {
 					e.close();
 				}
 			}
-			await u(r, i, d), n.format === "json" ? f({
+			await u(n, r, l), t.format === "json" ? f({
 				deleted: !0,
-				id: a,
-				label: p.label
-			}) : o(`Deleted project "${p.label}"`);
+				id: i,
+				label: d.label
+			}) : o(`Deleted project "${d.label}"`);
+		} finally {
+			await n.close();
 		}
-	},
-	"admin:copy-project": class n extends O {
-		static description = "Copy a project from one user to another. Requires admin/controller credentials.";
-		static flags = {
-			...w,
-			...E,
-			"source-user": v.string({
-				summary: "Username of the source project owner",
-				required: !0
-			}),
-			"source-project": v.string({
-				summary: "Source project ID or label",
-				required: !0
-			}),
-			"target-user": v.string({ summary: "Username of the target user (defaults to source-user for same-user copy)" }),
-			name: v.string({
-				char: "n",
-				summary: "Name for the copied project",
-				helpValue: "<name>"
-			}),
-			"auto-rename": v.boolean({
-				summary: "Auto-rename on collision (default: true)",
-				default: !0,
-				allowNo: !0
-			})
-		};
-		async run() {
-			let { flags: i } = await this.parse(n), a = await this.connectClient(i), s = i["target-user"] ?? i["source-user"], l = await r(a, i["source-user"]), { rid: u } = await c(a, l.projectListRid, i["source-project"]), d = s === i["source-user"] ? l : await r(a, s), m = S(), h = await a.withWriteTx("adminCopyProject", async (n) => {
-				let r = await n.getKValueString(u, x), a = JSON.parse(r).label, o = await t(n, d.projectListRid), s = i.name ?? a;
+	}), e;
+}
+//#endregion
+//#region src/cmd/admin/copy-project.ts
+function F() {
+	let n = new g("copy-project").description("Copy a project from one user to another. Requires admin/controller credentials.");
+	return T(n, E(), O()), n.addOption(new _("--source-user <user>", "Username of the source project owner").makeOptionMandatory()), n.addOption(new _("--source-project <project>", "Source project ID or label").makeOptionMandatory()), n.option("--target-user <user>", "Username of the target user (defaults to source-user for same-user copy)"), n.option("-n, --name <name>", "Name for the copied project"), n.addOption(new _("--auto-rename", "Auto-rename on collision (default: true)").default(!0)), n.option("--no-auto-rename", "Fail on name collision instead of auto-renaming"), n.action(async (n) => {
+		let i = await C(n);
+		try {
+			let a = n.targetUser ?? n.sourceUser, s = await r(i, n.sourceUser), { rid: l } = await c(i, s.projectListRid, n.sourceProject), u = a === n.sourceUser ? s : await r(i, a), d = x(), m = await i.withWriteTx("adminCopyProject", async (r) => {
+				let i = await r.getKValueString(l, b), a = JSON.parse(i).label, o = await t(r, u.projectListRid), s = n.name ?? a;
 				if (o.includes(s)) {
-					if (!i["auto-rename"]) throw Error(`Project name "${s}" already exists for target user.`);
-					s = e(i.name ?? a, o);
+					if (!n.autoRename) throw Error(`Project name "${s}" already exists for target user.`);
+					s = e(n.name ?? a, o);
 				}
-				let c = await p(n, u, { label: s });
-				n.createField(y(d.projectListRid, m), "Dynamic", c), await n.commit();
-				let l = await c.globalId;
+				let c = await p(r, l, { label: s });
+				r.createField(v(u.projectListRid, d), "Dynamic", c), await r.commit();
+				let f = await c.globalId;
 				return {
-					id: b(l),
-					rid: l,
+					id: y(f),
+					rid: f,
 					label: s
 				};
 			});
-			i.format === "json" ? f({
-				id: h.id,
-				rid: b(h.rid),
-				label: h.label,
-				sourceUser: i["source-user"],
-				targetUser: s
-			}) : o(`Copied project from ${i["source-user"]} to ${s} as "${h.label}" (id: ${h.id}, rid: ${b(h.rid)})`);
+			n.format === "json" ? f({
+				id: m.id,
+				rid: y(m.rid),
+				label: m.label,
+				sourceUser: n.sourceUser,
+				targetUser: a
+			}) : o(`Copied project from ${n.sourceUser} to ${a} as "${m.label}" (id: ${m.id}, rid: ${y(m.rid)})`);
+		} finally {
+			await i.close();
 		}
-	}
-};
+	}), n;
+}
+//#endregion
+//#region src/cli.ts
+function I() {
+	let e = new g();
+	e.name("pl-cli").description("Platforma command-line client");
+	let t = new g("project").description("Manage projects");
+	t.addCommand(A()), t.addCommand(j()), t.addCommand(M()), t.addCommand(N()), t.addCommand(P()), e.addCommand(t);
+	let n = new g("admin").description("Admin operations (requires controller credentials)");
+	return n.addCommand(F()), e.addCommand(n), e;
+}
+async function L(e = process.argv) {
+	await I().parseAsync(e);
+}
 //#endregion
-export { k as COMMANDS };
+export { I as buildProgram, L as run };
 
 //# sourceMappingURL=cli.js.map