feat: support stdin for object upload via - path

- When path is `-`, read upload data from stdin
- Require --name and --content-type for stdin uploads since they
  cannot be inferred from a filename
- Update command description to document stdin support

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: jason-rl

src/commands/object/upload.ts

@@ -32,13 +32,40 @@ const CONTENT_TYPE_MAP: Record<string, ContentType> = {
   ".tar.gz": "tgz",
 };
 
+async function readStdinBuffer(): Promise<Buffer> {
+  const chunks: Buffer[] = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks);
+}
+
 export async function uploadObject(options: UploadObjectOptions) {
   try {
     const client = getClient();
+    const isStdin = options.path === "-";
+
+    if (isStdin) {
+      if (!options.name) {
+        outputError("--name is required when uploading from stdin");
+      }
+      if (!options.contentType) {
+        outputError("--content-type is required when uploading from stdin");
+      }
+    }
+
+    // Read file data
+    let fileBuffer: Buffer;
+    let fileSize: number;
 
-    // Check if file exists and get stats
-    const stats = await stat(options.path);
-    const fileBuffer = await readFile(options.path);
+    if (isStdin) {
+      fileBuffer = await readStdinBuffer();
+      fileSize = fileBuffer.length;
+    } else {
+      const stats = await stat(options.path);
+      fileSize = stats.size;
+      fileBuffer = await readFile(options.path);
+    }
 
     // Auto-detect content type if not provided
     let detectedContentType: ContentType = options.contentType as ContentType;
@@ -73,7 +100,7 @@ export async function uploadObject(options: UploadObjectOptions) {
       id: createResponse.id,
       name: options.name,
       contentType: detectedContentType,
-      size: stats.size,
+      size: fileSize,
     };
 
     // Default: just output the ID for easy scripting

src/utils/commands.ts

@@ -651,8 +651,8 @@ export function createProgram(): Command {
 
   object
     .command("upload <path>")
-    .description("Upload a file as an object")
-    .option("--name <name>", "Object name (required)")
+    .description("Upload a file as an object (use - to read from stdin)")
+    .option("--name <name>", "Object name (required; mandatory for stdin)")
     .option(
       "--content-type <type>",
       "Content type: unspecified|text|binary|gzip|tar|tgz",