@picked/cli 0.0.85-next.4 → 0.0.85-next.5

package/dist/cjs/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const e=require("../workspace-use-CT6_jewh.cjs");let t=require("@picked/config"),n=require("node:util"),r=require("@picked/telemetry");var i=2e3,a=null,o=0;function s(e){if((0,t.isTelemetryForcedOffByEnvironment)())return;o=Date.now();let n=(0,t.detectHostEnvironment)();a={name:`picked.cli.${e}`,traceId:(0,r.createTraceId)(),spanId:(0,r.createSpanId)(),startTimeUnixNano:(0,r.toUnixNano)(o),endTimeUnixNano:(0,r.toUnixNano)(o),attributes:{"picked.cli.command":e,"picked.env.provider":n.provider,"picked.env.ci":n.ci},status:`unset`}}function c(e){a&&(a.endTimeUnixNano=(0,r.toUnixNano)(Date.now()),a.status=e===0?`ok`:`error`)}async function l(){let e=a;if(a=null,e)try{let n=await(0,t.loadResolvedPickedConfig)();if(!n||!(0,t.isTelemetryEnabled)(n))return;let a=(0,r.createTelemetryEmitter)({resource:{"service.name":`picked-cli`},headers:{"Picked-Telemetry":`cli`}});a.record(e),await Promise.race([a.flush(),new Promise(e=>{setTimeout(e,i).unref()})])}catch{}}var u=`Usage:
+const e=require("../workspace-use-Cjn8sjJj.cjs");let t=require("@picked/config"),n=require("node:util"),r=require("@picked/telemetry");var i=2e3,a=null,o=0;function s(e){if((0,t.isTelemetryForcedOffByEnvironment)())return;o=Date.now();let n=(0,t.detectHostEnvironment)();a={name:`picked.cli.${e}`,traceId:(0,r.createTraceId)(),spanId:(0,r.createSpanId)(),startTimeUnixNano:(0,r.toUnixNano)(o),endTimeUnixNano:(0,r.toUnixNano)(o),attributes:{"picked.cli.command":e,"picked.env.provider":n.provider,"picked.env.ci":n.ci},status:`unset`}}function c(e){a&&(a.endTimeUnixNano=(0,r.toUnixNano)(Date.now()),a.status=e===0?`ok`:`error`)}async function l(){let e=a;if(a=null,e)try{let n=await(0,t.loadResolvedPickedConfig)();if(!n||!(0,t.isTelemetryEnabled)(n))return;let a=(0,r.createTelemetryEmitter)({resource:{"service.name":`picked-cli`},headers:{"Picked-Telemetry":`cli`}});a.record(e),await Promise.race([a.flush(),new Promise(e=>{setTimeout(e,i).unref()})])}catch{}}var u=`Usage:
   picked login
   picked logout
   picked whoami
@@ -7,4 +7,6 @@ const e=require("../workspace-use-CT6_jewh.cjs");let t=require("@picked/config")
   picked workspace list [--json]
   picked workspace use [--project <id>] [--workspace <id>] [--no-generate]
   picked use [--project <id>] [--workspace <id>] [--no-generate]
-  picked generate types [--check]`;async function d(){let{positionals:t,values:r}=(0,n.parseArgs)({allowPositionals:!0,options:{check:{type:`boolean`,default:!1},project:{type:`string`},workspace:{type:`string`},json:{type:`boolean`,default:!1},generate:{type:`boolean`,default:!0},"no-generate":{type:`boolean`,default:!1}}}),[i,a]=t,o=r.generate&&!r[`no-generate`];if(i===`login`){s(`login`),process.exitCode=await e.o({});return}if(i===`logout`){s(`logout`),process.exitCode=await e.a();return}if(i===`whoami`){s(`whoami`),process.exitCode=await e.r();return}if(i===`status`){s(`status`),process.exitCode=await e.i({});return}if(i===`workspace`&&(a===`list`||a===`ls`)){s(`workspace list`),process.exitCode=await e.n({json:r.json});return}if(i===`workspace`&&a===`use`||i===`use`){s(`workspace use`),process.exitCode=await e.t({project:r.project,workspace:r.workspace,generate:o});return}if(i===`generate`&&a===`types`){s(`generate types`),process.exitCode=await e.s({check:r.check});return}s(`unknown`),console.error(u),process.exitCode=1}function f(e){let t=2,n=()=>{--t,t<=0&&process.exit(e)};setTimeout(()=>{process.exit(e)},2e3).unref(),process.stdout.write(``,n),process.stderr.write(``,n)}d().then(async()=>{let e=typeof process.exitCode==`number`?process.exitCode:0;c(e),await l(),f(e)}).catch(e=>{let t=e instanceof Error?e.message:String(e);console.error(t),c(1),l().finally(()=>{f(1)})});
+  picked workspace export --project <id> (--workspace <id> | --live) --out <dir>
+  picked workspace import --project <id> --in <dir> [--name <name>] [--publish]
+  picked generate types [--check]`;async function d(){let{positionals:t,values:r}=(0,n.parseArgs)({allowPositionals:!0,options:{check:{type:`boolean`,default:!1},project:{type:`string`},workspace:{type:`string`},json:{type:`boolean`,default:!1},generate:{type:`boolean`,default:!0},"no-generate":{type:`boolean`,default:!1},live:{type:`boolean`,default:!1},out:{type:`string`},in:{type:`string`},name:{type:`string`},publish:{type:`boolean`,default:!1}}}),[i,a]=t,o=r.generate&&!r[`no-generate`];if(i===`login`){s(`login`),process.exitCode=await e.c({});return}if(i===`logout`){s(`logout`),process.exitCode=await e.s();return}if(i===`whoami`){s(`whoami`),process.exitCode=await e.a();return}if(i===`status`){s(`status`),process.exitCode=await e.o({});return}if(i===`workspace`&&(a===`list`||a===`ls`)){s(`workspace list`),process.exitCode=await e.n({json:r.json});return}if(i===`workspace`&&a===`use`||i===`use`){s(`workspace use`),process.exitCode=await e.t({project:r.project,workspace:r.workspace,generate:o});return}if(i===`workspace`&&a===`export`){s(`workspace export`),process.exitCode=await e.i({project:r.project,workspace:r.workspace,live:r.live,out:r.out});return}if(i===`workspace`&&a===`import`){s(`workspace import`),process.exitCode=await e.r({project:r.project,in:r.in,name:r.name,publish:r.publish});return}if(i===`generate`&&a===`types`){s(`generate types`),process.exitCode=await e.l({check:r.check});return}s(`unknown`),console.error(u),process.exitCode=1}function f(e){let t=2,n=()=>{--t,t<=0&&process.exit(e)};setTimeout(()=>{process.exit(e)},2e3).unref(),process.stdout.write(``,n),process.stderr.write(``,n)}d().then(async()=>{let e=typeof process.exitCode==`number`?process.exitCode:0;c(e),await l(),f(e)}).catch(e=>{let t=e instanceof Error?e.message:String(e);console.error(t),c(1),l().finally(()=>{f(1)})});

package/dist/cjs/index.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../workspace-use-CT6_jewh.cjs");exports.runGenerateTypes=e.s,exports.runLogin=e.o,exports.runLogout=e.a,exports.runStatus=e.i,exports.runWhoami=e.r,exports.runWorkspaceList=e.n,exports.runWorkspaceUse=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../workspace-use-Cjn8sjJj.cjs");exports.runGenerateTypes=e.l,exports.runLogin=e.c,exports.runLogout=e.s,exports.runStatus=e.o,exports.runWhoami=e.a,exports.runWorkspaceExport=e.i,exports.runWorkspaceImport=e.r,exports.runWorkspaceList=e.n,exports.runWorkspaceUse=e.t;

package/dist/esm/cli.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
-import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../workspace-use-Cbz1Bxse.js";
-import { detectHostEnvironment as s, isTelemetryEnabled as c, isTelemetryForcedOffByEnvironment as l, loadResolvedPickedConfig as u } from "@picked/config";
-import { parseArgs as d } from "node:util";
-import { createSpanId as f, createTelemetryEmitter as p, createTraceId as m, toUnixNano as h } from "@picked/telemetry";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "../workspace-use-CnR5FkxR.js";
+import { detectHostEnvironment as l, isTelemetryEnabled as u, isTelemetryForcedOffByEnvironment as d, loadResolvedPickedConfig as f } from "@picked/config";
+import { parseArgs as p } from "node:util";
+import { createSpanId as m, createTelemetryEmitter as h, createTraceId as g, toUnixNano as _ } from "@picked/telemetry";
 //#region src/telemetry.ts
-var g = 2e3, _ = null, v = 0;
-function y(e) {
-	if (l()) return;
-	v = Date.now();
-	let t = s();
-	_ = {
+var v = 2e3, y = null, b = 0;
+function x(e) {
+	if (d()) return;
+	b = Date.now();
+	let t = l();
+	y = {
 		name: `picked.cli.${e}`,
-		traceId: m(),
-		spanId: f(),
-		startTimeUnixNano: h(v),
-		endTimeUnixNano: h(v),
+		traceId: g(),
+		spanId: m(),
+		startTimeUnixNano: _(b),
+		endTimeUnixNano: _(b),
 		attributes: {
 			"picked.cli.command": e,
 			"picked.env.provider": t.provider,
@@ -23,28 +23,28 @@ function y(e) {
 		status: "unset"
 	};
 }
-function b(e) {
-	_ && (_.endTimeUnixNano = h(Date.now()), _.status = e === 0 ? "ok" : "error");
+function S(e) {
+	y && (y.endTimeUnixNano = _(Date.now()), y.status = e === 0 ? "ok" : "error");
 }
-async function x() {
-	let e = _;
-	if (_ = null, e) try {
-		let t = await u();
-		if (!t || !c(t)) return;
-		let n = p({
+async function C() {
+	let e = y;
+	if (y = null, e) try {
+		let t = await f();
+		if (!t || !u(t)) return;
+		let n = h({
 			resource: { "service.name": "picked-cli" },
 			headers: { "Picked-Telemetry": "cli" }
 		});
 		n.record(e), await Promise.race([n.flush(), new Promise((e) => {
-			setTimeout(e, g).unref();
+			setTimeout(e, v).unref();
 		})]);
 	} catch {}
 }
 //#endregion
 //#region src/cli.ts
-var S = "Usage:\n  picked login\n  picked logout\n  picked whoami\n  picked status\n  picked workspace list [--json]\n  picked workspace use [--project <id>] [--workspace <id>] [--no-generate]\n  picked use [--project <id>] [--workspace <id>] [--no-generate]\n  picked generate types [--check]";
-async function C() {
-	let { positionals: s, values: c } = d({
+var w = "Usage:\n  picked login\n  picked logout\n  picked whoami\n  picked status\n  picked workspace list [--json]\n  picked workspace use [--project <id>] [--workspace <id>] [--no-generate]\n  picked use [--project <id>] [--workspace <id>] [--no-generate]\n  picked workspace export --project <id> (--workspace <id> | --live) --out <dir>\n  picked workspace import --project <id> --in <dir> [--name <name>] [--publish]\n  picked generate types [--check]";
+async function T() {
+	let { positionals: l, values: u } = p({
 		allowPositionals: !0,
 		options: {
 			check: {
@@ -64,44 +64,73 @@ async function C() {
 			"no-generate": {
 				type: "boolean",
 				default: !1
+			},
+			live: {
+				type: "boolean",
+				default: !1
+			},
+			out: { type: "string" },
+			in: { type: "string" },
+			name: { type: "string" },
+			publish: {
+				type: "boolean",
+				default: !1
 			}
 		}
-	}), [l, u] = s, f = c.generate && !c["no-generate"];
-	if (l === "login") {
-		y("login"), process.exitCode = await r({});
+	}), [d, f] = l, m = u.generate && !u["no-generate"];
+	if (d === "login") {
+		x("login"), process.exitCode = await t({});
+		return;
+	}
+	if (d === "logout") {
+		x("logout"), process.exitCode = await s();
 		return;
 	}
-	if (l === "logout") {
-		y("logout"), process.exitCode = await e();
+	if (d === "whoami") {
+		x("whoami"), process.exitCode = await e();
 		return;
 	}
-	if (l === "whoami") {
-		y("whoami"), process.exitCode = await i();
+	if (d === "status") {
+		x("status"), process.exitCode = await a({});
 		return;
 	}
-	if (l === "status") {
-		y("status"), process.exitCode = await t({});
+	if (d === "workspace" && (f === "list" || f === "ls")) {
+		x("workspace list"), process.exitCode = await i({ json: u.json });
 		return;
 	}
-	if (l === "workspace" && (u === "list" || u === "ls")) {
-		y("workspace list"), process.exitCode = await n({ json: c.json });
+	if (d === "workspace" && f === "use" || d === "use") {
+		x("workspace use"), process.exitCode = await c({
+			project: u.project,
+			workspace: u.workspace,
+			generate: m
+		});
+		return;
+	}
+	if (d === "workspace" && f === "export") {
+		x("workspace export"), process.exitCode = await n({
+			project: u.project,
+			workspace: u.workspace,
+			live: u.live,
+			out: u.out
+		});
 		return;
 	}
-	if (l === "workspace" && u === "use" || l === "use") {
-		y("workspace use"), process.exitCode = await o({
-			project: c.project,
-			workspace: c.workspace,
-			generate: f
+	if (d === "workspace" && f === "import") {
+		x("workspace import"), process.exitCode = await o({
+			project: u.project,
+			in: u.in,
+			name: u.name,
+			publish: u.publish
 		});
 		return;
 	}
-	if (l === "generate" && u === "types") {
-		y("generate types"), process.exitCode = await a({ check: c.check });
+	if (d === "generate" && f === "types") {
+		x("generate types"), process.exitCode = await r({ check: u.check });
 		return;
 	}
-	y("unknown"), console.error(S), process.exitCode = 1;
+	x("unknown"), console.error(w), process.exitCode = 1;
 }
-function w(e) {
+function E(e) {
 	let t = 2, n = () => {
 		--t, t <= 0 && process.exit(e);
 	};
@@ -109,13 +138,13 @@ function w(e) {
 		process.exit(e);
 	}, 2e3).unref(), process.stdout.write("", n), process.stderr.write("", n);
 }
-C().then(async () => {
+T().then(async () => {
 	let e = typeof process.exitCode == "number" ? process.exitCode : 0;
-	b(e), await x(), w(e);
+	S(e), await C(), E(e);
 }).catch((e) => {
 	let t = e instanceof Error ? e.message : String(e);
-	console.error(t), b(1), x().finally(() => {
-		w(1);
+	console.error(t), S(1), C().finally(() => {
+		E(1);
 	});
 });
 //#endregion

package/dist/esm/index.js

@@ -1,2 +1,2 @@
-import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "../workspace-use-Cbz1Bxse.js";
-export { a as runGenerateTypes, r as runLogin, e as runLogout, t as runStatus, i as runWhoami, n as runWorkspaceList, o as runWorkspaceUse };
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "../workspace-use-CnR5FkxR.js";
+export { r as runGenerateTypes, t as runLogin, s as runLogout, a as runStatus, e as runWhoami, n as runWorkspaceExport, o as runWorkspaceImport, i as runWorkspaceList, c as runWorkspaceUse };

package/dist/types/commands/login.d.ts

@@ -1,6 +1,7 @@
 /**
  * Runs `picked login`: runs the browser + loopback PKCE OAuth flow and persists the
- * resulting session to the current directory's API origin auth config.
+ * resulting session to the current directory's API origin auth config. Fails without
+ * signing in while `PICKED_API_KEY` is set.
  *
  * @param {object} [options] - Command options.
  * @param {string} [options.cwd] - Working directory used to resolve the API origin.

package/dist/types/commands/login.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/commands/login.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB1E"}
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../../src/commands/login.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB1E"}

package/dist/types/commands/whoami.d.ts

@@ -1,5 +1,6 @@
 /**
  * Runs `picked whoami`: prints the identity signed in to the current directory's API origin.
+ * Fails without reading a session while `PICKED_API_KEY` is set.
  *
  * @param {object} [options] - Command options.
  * @param {string} [options.cwd] - Working directory used to resolve the API origin.

package/dist/types/commands/whoami.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../../src/commands/whoami.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3E"}
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../../src/commands/whoami.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB3E"}

package/dist/types/commands/workspace-export.d.ts

@@ -0,0 +1,28 @@
+/** Options for {@link runWorkspaceExport}. */
+interface RunWorkspaceExportOptions {
+    cwd?: string;
+    /** The project the exported workspace belongs to. */
+    project?: string;
+    /** The workspace to export. */
+    workspace?: string;
+    /** Export the snapshot workspace of the project's live version. */
+    live?: boolean;
+    /** The bundle directory to write, inside `cwd`. */
+    out?: string;
+}
+/**
+ * Runs `picked workspace export`: exports a workspace, or with `--live` the snapshot
+ * workspace of the project's live version, into a bundle directory. Every manifest asset is
+ * downloaded, checked against the manifest's size and SHA-256, and written to
+ * `assets/<sha256>`; a manifest item with no SHA-256 gets the hash of the downloaded bytes.
+ * `bundle.json` is written last, into a temporary sibling directory that becomes `--out` only
+ * once complete, so a failed run leaves `--out` as it was.
+ *
+ * @param {RunWorkspaceExportOptions} options - Command options.
+ * @returns {Promise<number>} Process exit code.
+ * @example
+ * await runWorkspaceExport({ project: 'proj-1', live: true, out: 'bundle' })
+ */
+export declare function runWorkspaceExport(options: RunWorkspaceExportOptions): Promise<number>;
+export {};
+//# sourceMappingURL=workspace-export.d.ts.map

package/dist/types/commands/workspace-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-export.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace-export.ts"],"names":[],"mappings":"AAqBA,8CAA8C;AAC9C,UAAU,yBAAyB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mEAAmE;IACnE,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAsKD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB5F"}

package/dist/types/commands/workspace-import.d.ts

@@ -0,0 +1,26 @@
+/** Options for {@link runWorkspaceImport}. */
+interface RunWorkspaceImportOptions {
+    cwd?: string;
+    /** The project to import into. */
+    project?: string;
+    /** The bundle directory to read, inside `cwd`. */
+    in?: string;
+    /** The new workspace's name; the bundle's workspace name when omitted. */
+    name?: string;
+    /** Publish the new workspace after importing it. */
+    publish?: boolean;
+}
+/**
+ * Runs `picked workspace import`: stores the bundle's assets in the project, reusing the
+ * project's existing versions of identical bytes, imports the bundle as a new draft
+ * workspace, and with `--publish` publishes it. Prints the new workspace id. When storing
+ * fails or the API refuses the import, the assets this run uploaded are deleted.
+ *
+ * @param {RunWorkspaceImportOptions} options - Command options.
+ * @returns {Promise<number>} Process exit code.
+ * @example
+ * await runWorkspaceImport({ project: 'proj-1', in: 'bundle', publish: true })
+ */
+export declare function runWorkspaceImport(options: RunWorkspaceImportOptions): Promise<number>;
+export {};
+//# sourceMappingURL=workspace-import.d.ts.map

package/dist/types/commands/workspace-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-import.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace-import.ts"],"names":[],"mappings":"AAyBA,8CAA8C;AAC9C,UAAU,yBAAyB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAmPD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC5F"}

package/dist/types/commands/workspace-list.d.ts

@@ -4,7 +4,7 @@
  *
  * @param {object} [options] - Command options.
  * @param {string} [options.cwd] - Working directory used to resolve the API URL.
- * @param {boolean} [options.json] - Print machine-readable JSON to stdout instead of a table.
+ * @param {boolean} [options.json] - Print machine-readable JSON to stdout; the default is an indented list.
  * @returns {Promise<number>} Process exit code.
  * @example
  * await runWorkspaceList({ json: false })

package/dist/types/commands/workspace-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-list.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace-list.ts"],"names":[],"mappings":"AAiCA;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBlB"}
+{"version":3,"file":"workspace-list.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace-list.ts"],"names":[],"mappings":"AAiCA;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB"}

package/dist/types/commands/workspace-use.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-use.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace-use.ts"],"names":[],"mappings":"AAcA,2CAA2C;AAC3C,UAAU,sBAAsB;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAqID;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBvF"}
+{"version":3,"file":"workspace-use.d.ts","sourceRoot":"","sources":["../../../src/commands/workspace-use.ts"],"names":[],"mappings":"AAeA,2CAA2C;AAC3C,UAAU,sBAAsB;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AA+HD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBvF"}

package/dist/types/index.d.ts

@@ -4,6 +4,8 @@ export { runLogin } from './commands/login';
 export { runLogout } from './commands/logout';
 export { runStatus } from './commands/status';
 export { runWhoami } from './commands/whoami';
+export { runWorkspaceExport } from './commands/workspace-export';
+export { runWorkspaceImport } from './commands/workspace-import';
 export { runWorkspaceList } from './commands/workspace-list';
 export { runWorkspaceUse } from './commands/workspace-use';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/types/lib/admin-client.d.ts

@@ -0,0 +1,22 @@
+import type { AdminApiClient } from '@picked/admin-api-client';
+/**
+ * Reads the API key for non-interactive runs from `PICKED_API_KEY`.
+ *
+ * @returns {string | undefined} The trimmed key, or undefined when the variable is unset or blank.
+ * @example
+ * if (readApiKey()) console.error('Using PICKED_API_KEY')
+ */
+export declare function readApiKey(): string | undefined;
+/**
+ * Creates an admin API client for an API origin. With `PICKED_API_KEY` set, every request
+ * carries it as `X-API-Key` and the stored OAuth session is never read. Otherwise requests
+ * carry that origin's OAuth access token, refreshed as it nears expiry.
+ *
+ * @param {string} apiUrl - The API origin.
+ * @returns {Promise<AdminApiClient>} The client.
+ * @throws {Error} When there is no API key and no session for `apiUrl`.
+ * @example
+ * const client = await createCliAdminClient(await resolveApiUrl())
+ */
+export declare function createCliAdminClient(apiUrl: string): Promise<AdminApiClient>;
+//# sourceMappingURL=admin-client.d.ts.map

package/dist/types/lib/admin-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-client.d.ts","sourceRoot":"","sources":["../../../src/lib/admin-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAG9D;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAG/C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAMlF"}

package/dist/types/lib/bundle.d.ts

@@ -0,0 +1,79 @@
+/** File name of the bundle document inside a bundle directory. */
+export declare const BUNDLE_FILE = "bundle.json";
+/** Directory inside a bundle directory that holds the asset files. */
+export declare const ASSETS_DIR = "assets";
+/**
+ * Resolves the bundle directory a flag names against the current directory.
+ *
+ * @param {string} cwd - The current directory.
+ * @param {string} value - The flag's value.
+ * @param {string} flag - The flag, for the error message.
+ * @returns {string} The absolute bundle directory, strictly inside `cwd`.
+ * @throws {Error} When the directory is `cwd` itself or lies outside it.
+ * @example
+ * resolveBundleDir('/work', 'bundle', '--out') // '/work/bundle'
+ */
+export declare function resolveBundleDir(cwd: string, value: string, flag: string): string;
+/** One asset version of a bundle's `assets` manifest, as the CLI reads it. */
+export interface BundleAsset {
+    /** The asset version id in the source project. */
+    versionId: string;
+    fileName: string;
+    mimeType: string;
+    sizeBytes: number;
+    /** Lower-case hex SHA-256 of the bytes, or null when the source never recorded one. */
+    sha256: string | null;
+    downloadUrl: string;
+}
+/**
+ * Narrows a value to a plain JSON object.
+ *
+ * @param {unknown} value - The value.
+ * @returns {boolean} True for a non-null, non-array object.
+ * @example
+ * isRecord(JSON.parse(text))
+ */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/**
+ * Returns the path of an asset file inside a bundle directory.
+ *
+ * @param {string} bundleDir - The bundle directory.
+ * @param {string} sha256 - The lower-case hex SHA-256 of the file's bytes.
+ * @returns {string} `<bundleDir>/assets/<sha256>`.
+ * @example
+ * assetPath('./bundle', asset.sha256)
+ */
+export declare function assetPath(bundleDir: string, sha256: string): string;
+/**
+ * Reads the `assets` manifest of a bundle.
+ *
+ * @param {Record<string, unknown>} bundle - The bundle document.
+ * @returns {BundleAsset[]} Its items, in manifest order.
+ * @throws {Error} When `assets` is not an array of well-formed items.
+ * @example
+ * const assets = readAssetManifest(bundle)
+ */
+export declare function readAssetManifest(bundle: Record<string, unknown>): BundleAsset[];
+/**
+ * Checks bytes against the size and, when it has one, the SHA-256 of a manifest item.
+ *
+ * @param {BundleAsset} asset - The manifest item.
+ * @param {Uint8Array} bytes - The bytes.
+ * @param {string} source - Where the bytes came from, for the error message.
+ * @returns {string} The lower-case hex SHA-256 of `bytes`.
+ * @throws {Error} When the size or the SHA-256 differs from the manifest.
+ * @example
+ * const sha256 = verifyAssetBytes(asset, bytes, asset.downloadUrl)
+ */
+export declare function verifyAssetBytes(asset: BundleAsset, bytes: Uint8Array, source: string): string;
+/**
+ * Returns a copy of a bundle whose manifest items carry the given SHA-256 digests.
+ *
+ * @param {Record<string, unknown>} bundle - The bundle document.
+ * @param {string[]} hashes - The digest of each manifest item, in manifest order.
+ * @returns {Record<string, unknown>} The bundle with every item's `sha256` set.
+ * @example
+ * const written = withAssetHashes(bundle, [sha256])
+ */
+export declare function withAssetHashes(bundle: Record<string, unknown>, hashes: string[]): Record<string, unknown>;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/types/lib/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../src/lib/bundle.ts"],"names":[],"mappings":"AAOA,kEAAkE;AAClE,eAAO,MAAM,WAAW,gBAAgB,CAAA;AAExC,sEAAsE;AACtE,eAAO,MAAM,UAAU,WAAW,CAAA;AAIlC;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASjF;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,uFAAuF;IACvF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAcD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE;AAuCD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,EAAE,CAIhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAe9F;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}

package/dist/types/lib/workspace-transfer.d.ts

@@ -0,0 +1,120 @@
+import type { AdminApiClient } from '@picked/admin-api-client';
+/** One `workspaceImport` asset mapping: a bundle asset version and the target version for it. */
+export interface AssetMapping {
+    sourceVersionId: string;
+    assetId: string;
+    versionId: string;
+}
+/** The target project's asset version for some bytes, and whether they had to be uploaded. */
+interface UploadedAsset {
+    assetId: string;
+    versionId: string;
+    /** True when the project already held the bytes and nothing was uploaded. */
+    deduplicated: boolean;
+}
+/**
+ * The error thrown when a mutation payload carries user errors: the API answered and
+ * rejected the operation.
+ *
+ * @example
+ * if (error instanceof PayloadUserErrorsError) console.error(error.message)
+ */
+export declare class PayloadUserErrorsError extends Error {
+    readonly name = "PayloadUserErrorsError";
+}
+/**
+ * Resolves the workspace that holds a project's live version: the snapshot workspace of
+ * the version the project serves.
+ *
+ * @param {AdminApiClient} client - The admin API client.
+ * @param {string} projectId - The project.
+ * @returns {Promise<string>} The snapshot workspace id.
+ * @throws {Error} When the project is not found, has no published version, or its live
+ *   version has no snapshot workspace.
+ * @example
+ * const workspaceId = await resolveLiveWorkspaceId(client, 'proj-1')
+ */
+export declare function resolveLiveWorkspaceId(client: AdminApiClient, projectId: string): Promise<string>;
+/**
+ * Exports a workspace as a bundle.
+ *
+ * @param {AdminApiClient} client - The admin API client.
+ * @param {string} workspaceId - The workspace.
+ * @returns {Promise<Record<string, unknown>>} The bundle document.
+ * @throws {Error} On user errors, or when the payload has no bundle object.
+ * @example
+ * const bundle = await exportWorkspaceBundle(client, 'ws-1')
+ */
+export declare function exportWorkspaceBundle(client: AdminApiClient, workspaceId: string): Promise<Record<string, unknown>>;
+/**
+ * Stores bytes as an asset of a project. `assetUploadInit` receives their SHA-256: when the
+ * project already holds them it returns that version and nothing is uploaded; otherwise the
+ * bytes are PUT to the upload URL and committed with the same SHA-256.
+ *
+ * @param {AdminApiClient} client - The admin API client.
+ * @param {object} params - The upload.
+ * @param {string} params.projectId - The target project.
+ * @param {string} params.fileName - The asset's file name.
+ * @param {string} params.mimeType - The bytes' content type.
+ * @param {string} params.sha256 - Lower-case hex SHA-256 of `bytes`.
+ * @param {Uint8Array<ArrayBuffer>} params.bytes - The bytes.
+ * @returns {Promise<UploadedAsset>} The project's asset version for the bytes.
+ * @throws {Error} When storage rejects the upload or the commit returns user errors.
+ * @example
+ * const uploaded = await uploadAsset(client, { projectId, fileName, mimeType, sha256, bytes })
+ */
+export declare function uploadAsset(client: AdminApiClient, params: {
+    projectId: string;
+    fileName: string;
+    mimeType: string;
+    sha256: string;
+    bytes: Uint8Array<ArrayBuffer>;
+}): Promise<UploadedAsset>;
+/**
+ * Deletes an asset of a project.
+ *
+ * @param {AdminApiClient} client - The admin API client.
+ * @param {string} assetId - The asset.
+ * @returns {Promise<void>} Resolves once deleted.
+ * @example
+ * await deleteAsset(client, 'asset-1')
+ */
+export declare function deleteAsset(client: AdminApiClient, assetId: string): Promise<void>;
+/**
+ * Imports a bundle as a new draft workspace of a project. The request may run for up to
+ * five minutes.
+ *
+ * @param {AdminApiClient} client - The admin API client.
+ * @param {object} params - The import.
+ * @param {string} params.projectId - The target project.
+ * @param {string} [params.name] - The new workspace's name; the bundle's name when omitted.
+ * @param {Record<string, unknown>} params.bundle - The bundle document.
+ * @param {AssetMapping[]} params.assetMap - The target version of every bundle asset version.
+ * @returns {Promise<{ id: string; name: string }>} The new workspace.
+ * @throws {PayloadUserErrorsError} On user errors.
+ * @throws {Error} When the request fails, or the payload has neither a workspace nor user errors.
+ * @example
+ * const workspace = await importWorkspaceBundle(client, { projectId, bundle, assetMap })
+ */
+export declare function importWorkspaceBundle(client: AdminApiClient, params: {
+    projectId: string;
+    name?: string;
+    bundle: Record<string, unknown>;
+    assetMap: AssetMapping[];
+}): Promise<{
+    id: string;
+    name: string;
+}>;
+/**
+ * Publishes a workspace, making it its project's live version.
+ *
+ * @param {AdminApiClient} client - The admin API client.
+ * @param {string} workspaceId - The workspace.
+ * @returns {Promise<void>} Resolves once published.
+ * @throws {Error} On user errors.
+ * @example
+ * await publishWorkspace(client, 'ws-1')
+ */
+export declare function publishWorkspace(client: AdminApiClient, workspaceId: string): Promise<void>;
+export {};
+//# sourceMappingURL=workspace-transfer.d.ts.map

package/dist/types/lib/workspace-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-transfer.d.ts","sourceRoot":"","sources":["../../../src/lib/workspace-transfer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAe9D,iGAAiG;AACjG,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,8FAA8F;AAC9F,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,6EAA6E;IAC7E,YAAY,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;GAMG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAkB,IAAI,4BAA2B;CAClD;AAqBD;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAUlC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,CAAA;CAC/B,GACA,OAAO,CAAC,aAAa,CAAC,CAmCxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE;IACN,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,QAAQ,EAAE,YAAY,EAAE,CAAA;CACzB,GACA,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAYvC;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKjG"}

package/dist/types/lib/workspaces.d.ts

@@ -1,3 +1,4 @@
+import type { AdminApiClient } from '@picked/admin-api-client';
 import type { WorkspaceStatus } from '@picked/config';
 /** A workspace within a project, as returned by the workspace-tree query. */
 export interface WorkspaceNode {
@@ -30,25 +31,23 @@ export interface WorkspacePreviewInfo {
 /**
  * Fetches every organization, project, and workspace visible to the authenticated user.
  *
- * @param {string} apiUrl - Base Picked API URL.
- * @param {string} token - Bearer access token.
+ * @param {AdminApiClient} client - The admin API client.
  * @returns {Promise<OrgNode[]>} The organization/project/workspace tree.
- * @throws {Error} When the request fails or the caller is not authenticated.
+ * @throws {Error} When the request fails or the caller is not a signed-in user.
  * @example
- * const orgs = await fetchWorkspaceTree(apiUrl, token)
+ * const orgs = await fetchWorkspaceTree(client)
  */
-export declare function fetchWorkspaceTree(apiUrl: string, token: string): Promise<OrgNode[]>;
+export declare function fetchWorkspaceTree(client: AdminApiClient): Promise<OrgNode[]>;
 /**
  * Fetches a single workspace's status, name, and stateless preview delivery token.
  *
- * @param {string} apiUrl - Base Picked API URL.
- * @param {string} token - Bearer access token.
+ * @param {AdminApiClient} client - The admin API client.
  * @param {string} projectId - Project the workspace belongs to.
  * @param {string} workspaceId - Workspace to fetch.
  * @returns {Promise<WorkspacePreviewInfo>} The workspace's status, name, and preview token.
  * @throws {Error} When the request fails or the workspace cannot be found.
  * @example
- * const info = await fetchPreviewToken(apiUrl, token, projectId, workspaceId)
+ * const info = await fetchPreviewToken(client, projectId, workspaceId)
  */
-export declare function fetchPreviewToken(apiUrl: string, token: string, projectId: string, workspaceId: string): Promise<WorkspacePreviewInfo>;
+export declare function fetchPreviewToken(client: AdminApiClient, projectId: string, workspaceId: string): Promise<WorkspacePreviewInfo>;
 //# sourceMappingURL=workspaces.d.ts.map