@standards/cli 1.0.0-alpha.445 → 1.0.0-alpha.447

package/dist/bin.mjs

@@ -3,17 +3,17 @@
 import { t as discoverBundles } from "./discover-bundles-DPpEZVv0.mjs";
 import { createRequire } from "node:module";
 import { styleText } from "node:util";
-import { BundleConflictError, StandardsRequestError, createTransport, previewBundleSync, syncBundle } from "@standards/client";
+import { BundleConflictError, StandardsRequestError, createTransport, previewBundleSync, syncBundle, uploadAll } from "@standards/client";
 import { Command, Option } from "commander";
 import { BUNDLE_LOCALES, COUNT_MODES, DECISION_TYPE_AGENT_SETUP, DECISION_TYPE_BUNDLE_SETUP, ENVIRONMENT_HARNESSES, ENVIRONMENT_IMAGES, ENVIRONMENT_SIZES, LINK_MAX_MS, NotFoundError, PROVIDER_NAMES, RECORD_ACCESS_ROLES, RESOURCE_VISIBILITIES, SchemaError, SchemaErrorCode, ValidationError, canonicalStringify, diffSchemaState, environmentHarness, formatByteSize, formatDecisionLink, isEnvironmentHarnessId, isPlainRecord, isSkillRepository, parseRecordAccessRole, parseSchemaState, parseSkillSource, schemaStateSourcePayload } from "@standards/schema";
-import { createWriteStream } from "node:fs";
+import { createWriteStream, openAsBlob } from "node:fs";
 import { chmod, lstat, mkdir, readFile, readdir, readlink, stat, symlink, unlink, writeFile } from "node:fs/promises";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
 import Table from "cli-table3";
 import { StandardsRequestError as StandardsRequestError$1, TURN_END_TYPES, createAppClient, openAgentStream, schemaApiErrorCode } from "@standards/client/app";
-import { homedir, hostname } from "node:os";
 import { Readable } from "node:stream";
 import { pipeline } from "node:stream/promises";
+import { homedir, hostname } from "node:os";
 import { buildOperationPath, recordsOperations } from "@standards/schema/api";
 import { stdin } from "node:process";
 import { createInterface } from "node:readline/promises";
@@ -960,6 +960,36 @@ function registerEnvironmentsCommand(program) {
 		printDone(`Environment ${id} archived.`);
 	});
 }
+// src/commands/transfer.ts
+/**
+* Local files sent straight to storage, resumable, read from disk as they go
+* (never whole in memory). One answer per path, in order; the first file the
+* API refuses stops the command with its reason, and the files of the batch
+* already stored are deleted.
+*/
+async function uploadLocalFiles(client, paths, options = {}) {
+	const files = await Promise.all(paths.map(async (path) => Object.assign(await openAsBlob(path), { name: basename(path) })));
+	return await uploadAll(client, {
+		files,
+		protocol: "tus",
+		...options.attachTo === void 0 ? {} : { attachTo: options.attachTo }
+	});
+}
+/**
+* Streams a response's body to `output`, or to stdout without one. A file
+* left half written is removed: a truncated file would pass for a whole one.
+*/
+async function writeBody(response, output) {
+	if (!response.body) throw new StandardsRequestError(response.status, "The response had no body");
+	const source = Readable.fromWeb(response.body);
+	if (!output) return await pipeline(source, process.stdout);
+	try {
+		await pipeline(source, createWriteStream(output));
+	} catch (error) {
+		await unlink(output).catch(() => void 0);
+		throw error;
+	}
+}
 // src/commands/files.ts
 function registerFilesCommand(program) {
 	const files = program.command("files").description("Upload, list, download and delete files");
@@ -975,15 +1005,17 @@ function registerFilesCommand(program) {
 	files.command("get").description("Get a file by ID").argument("<id>", "file ID").action(async (id, _opts, cmd) => {
 		formatOutput(await getAppClientFromCommand(cmd).files.get({ id }), getFormat(cmd));
 	});
-	files.command("upload").description("Upload local files (private); prints the stored files and their IDs").argument("<paths...>", "local file paths (at most 10)").action(async (paths, _opts, cmd) => {
-		const uploads = await Promise.all(paths.map(async (path) => new File([await readFile(path)], basename(path))));
-		formatOutput(await getAppClientFromCommand(cmd).files.upload({ files: uploads }), getFormat(cmd));
+	files.command("upload").description("Upload local files (private), resuming after a dropped connection; prints the stored files and their IDs").argument("<paths...>", "local file paths").action(async (paths, _opts, cmd) => {
+		formatOutput((await uploadLocalFiles(getAppClientFromCommand(cmd), paths)).map(({ file }) => file), getFormat(cmd));
 	});
 	files.command("content").description("Download a file's bytes (to stdout, or -o <file>)").argument("<id>", "file ID").option("-o, --output <file>", "write to a file instead of stdout").action(async (id, opts, cmd) => {
-		const { blob } = await getAppClientFromCommand(cmd).files.content({ id });
-		const bytes = new Uint8Array(await blob.arrayBuffer());
-		if (opts.output) return await writeFile(opts.output, bytes);
-		process.stdout.write(bytes);
+		const { url } = await getAppClientFromCommand(cmd).files.signedUrl({
+			id,
+			download: true
+		});
+		const response = await fetch(url);
+		if (!response.ok) throw new StandardsRequestError(response.status, `Storage refused the download (HTTP ${response.status})`);
+		await writeBody(response, opts.output);
 	});
 	files.command("delete").description("Delete a file you uploaded and its stored bytes (not a file in a document pack)").argument("<id>", "file ID").option("--yes", "delete without confirmation").action(async (id, opts, cmd) => {
 		requireConfirmation(opts.yes, "Deleting a file purges its bytes. Re-run with \"--yes\" to confirm.");
@@ -1453,22 +1485,13 @@ function registerRecordsCommand(program) {
 			filter: opts.filter,
 			sort: opts.sort
 		});
-		const response = await client.postRaw(buildOperationPath(recordsOperations.export, { objectName }), {
+		await writeBody(await client.postRaw(buildOperationPath(recordsOperations.export, { objectName }), {
 			q: opts.query ?? "",
 			columns: parseCsvList(opts.columns),
 			...filters ? { filters } : {},
 			...sorts ? { sorts } : {},
 			timezone: opts.timezone ?? Intl.DateTimeFormat().resolvedOptions().timeZone
-		});
-		if (!response.body) throw new StandardsRequestError(response.status, "The export response had no body");
-		const source = Readable.fromWeb(response.body);
-		if (!opts.output) return await pipeline(source, process.stdout);
-		try {
-			await pipeline(source, createWriteStream(opts.output));
-		} catch (error) {
-			await unlink(opts.output).catch(() => void 0);
-			throw error;
-		}
+		}), opts.output);
 	});
 	records.command("set-logo").description("Set a record's image to the logo of a company's domain").argument("<object>", "object name (e.g. companies)").argument("<recordId>", "record ID").argument("<domain>", "website or bare domain (e.g. acme.com)").action(async (objectName, recordId, domain, _opts, cmd) => {
 		formatOutput(await getAppClientFromCommand(cmd).records.setLogo({
@@ -1478,16 +1501,14 @@ function registerRecordsCommand(program) {
 		}), getFormat(cmd));
 	});
 	records.command("attach-document").description("Upload and attach a local file to a record").argument("<object>", "object name (e.g. contacts)").argument("<recordId>", "record ID").requiredOption("--file <path>", "local file path to upload").option("--attribute <attr>", "attribute name to attach the document to").option("--parent-id <folderId>", "parent folder ID").option("--title <title>", "document title (defaults to filename)").action(async (objectName, recordId, opts, cmd) => {
-		const fileContent = await readFile(opts.file);
-		const fileName = basename(opts.file);
-		formatOutput(await getAppClientFromCommand(cmd).records.attachDocument({
+		const [uploaded] = await uploadLocalFiles(getAppClientFromCommand(cmd), [opts.file], { attachTo: {
 			objectName,
-			id: recordId,
-			title: opts.title ?? fileName,
+			recordId,
+			title: opts.title ?? basename(opts.file),
 			...opts.attribute ? { attributeName: opts.attribute } : {},
-			...opts.parentId ? { parentId: opts.parentId } : {},
-			files: new File([fileContent], fileName)
-		}), getFormat(cmd));
+			...opts.parentId ? { parentId: opts.parentId } : {}
+		} });
+		formatOutput(uploaded?.attached, getFormat(cmd));
 	});
 	records.command("attach-file").description("Attach an already uploaded file to a record").argument("<object>", "object name (e.g. contacts)").argument("<recordId>", "record ID").requiredOption("--file-id <fileId>", "ID of a private uploaded file").option("--attribute <attr>", "document attribute (defaults to the record's attachments)").option("--document-id <documentId>", "append to this document's pack instead of creating one").option("--title <title>", "title of a new document (defaults to the file name without its extension)").action(async (objectName, recordId, opts, cmd) => {
 		formatOutput(await getAppClientFromCommand(cmd).records.attachFile({
@@ -2586,11 +2607,11 @@ async function readFolder(client, dir, skipped) {
 			});
 			continue;
 		}
-		const [stored] = await client.files.upload({ files: [new File([bytes], basename(absolute))] });
+		const [stored] = await uploadLocalFiles(client, [absolute]);
 		if (!stored) throw new Error(`The upload of ${absolute} answered no file`);
 		files.push({
 			path,
-			fileId: stored.id
+			fileId: stored.file.id
 		});
 	}
 	return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@standards/cli",
-  "version": "1.0.0-alpha.445",
+  "version": "1.0.0-alpha.447",
   "description": "CLI tool to interact with Standards API",
   "type": "module",
   "bin": {
@@ -24,9 +24,9 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@standards/client": "1.0.0-alpha.445",
-    "@standards/constants": "1.0.0-alpha.445",
-    "@standards/schema": "1.0.0-alpha.445",
+    "@standards/client": "1.0.0-alpha.447",
+    "@standards/constants": "1.0.0-alpha.447",
+    "@standards/schema": "1.0.0-alpha.447",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
     "jiti": "2.7.0",