@durable-streams/cli 0.1.5 → 0.1.7

package/README.md

@@ -69,6 +69,11 @@ durable-stream-dev read my-stream
 ### Environment Variables
 
 - `STREAM_URL` - Base URL of the stream server (default: `http://localhost:4437`)
+- `STREAM_AUTH` - Authorization header value (e.g., `Bearer my-token`)
+
+### Global Options
+
+- `--auth <value>` - Authorization header value (overrides `STREAM_AUTH` env var)
 
 ### Write Options
 
@@ -125,6 +130,23 @@ durable-stream-dev read <stream_id>
 durable-stream-dev delete <stream_id>
 ```
 
+### Authentication
+
+Use the `--auth` flag or `STREAM_AUTH` environment variable to authenticate:
+
+```bash
+# Using environment variable
+export STREAM_AUTH="Bearer my-token"
+durable-stream-dev read my-stream
+
+# Using --auth flag (overrides env var)
+durable-stream-dev --auth "Bearer my-token" read my-stream
+
+# Works with any auth scheme
+durable-stream-dev --auth "Basic dXNlcjpwYXNz" read my-stream
+durable-stream-dev --auth "ApiKey abc123" read my-stream
+```
+
 ## Complete Example Workflow
 
 ```bash

package/dist/index.cjs

@@ -92,6 +92,38 @@ function parseWriteArgs(args) {
 //#endregion
 //#region src/index.ts
 const STREAM_URL = process.env.STREAM_URL || `http://localhost:4437`;
+const STREAM_AUTH = process.env.STREAM_AUTH;
+/**
+* Parse global options (like --auth) from args.
+* Falls back to STREAM_AUTH env var if --auth flag not provided.
+* Returns the parsed options and remaining args.
+*/
+function parseGlobalOptions(args) {
+	const options = {};
+	const remainingArgs = [];
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === `--auth`) {
+			const value = args[i + 1];
+			if (!value || value.startsWith(`--`)) throw new Error(`--auth requires a value (e.g., --auth "Bearer token")`);
+			if (!value.trim()) throw new Error(`--auth value cannot be empty or whitespace`);
+			options.auth = value;
+			i++;
+		} else remainingArgs.push(arg);
+	}
+	if (!options.auth && STREAM_AUTH) {
+		if (!STREAM_AUTH.trim()) throw new Error(`STREAM_AUTH environment variable cannot be empty or whitespace`);
+		options.auth = STREAM_AUTH;
+	}
+	return {
+		options,
+		remainingArgs
+	};
+}
+function buildHeaders(options) {
+	if (options.auth) return { Authorization: options.auth };
+	return {};
+}
 function printUsage() {
 	console.error(`
 Usage:
@@ -101,6 +133,9 @@ Usage:
   durable-stream read <stream_id>                Follow a stream and write to stdout
   durable-stream delete <stream_id>              Delete a stream
 
+Global Options:
+  --auth <value>          Authorization header value (e.g., "Bearer my-token")
+
 Write Options:
   --content-type <type>   Content-Type for the message (default: application/octet-stream)
   --json                  Write as JSON (input stored as single message)
@@ -108,18 +143,21 @@ Write Options:
 
 Environment Variables:
   STREAM_URL    Base URL of the stream server (default: http://localhost:4437)
+  STREAM_AUTH   Authorization header value (overridden by --auth flag)
 `);
 }
-async function createStream(streamId) {
+async function createStream(streamId, headers) {
 	const url = `${STREAM_URL}/v1/stream/${streamId}`;
 	try {
 		await __durable_streams_client.DurableStream.create({
 			url,
+			headers,
 			contentType: `application/octet-stream`
 		});
 		console.log(`Created stream: ${streamId}`);
 	} catch (error) {
-		if (error instanceof Error) node_process.stderr.write(`Error creating stream: ${error.message}\n`);
+		const message = error instanceof Error ? error.message : String(error);
+		node_process.stderr.write(`Error creating stream: ${message}\n`);
 		process.exit(1);
 	}
 }
@@ -134,12 +172,13 @@ async function appendJson(stream, parsed) {
 	}
 	return count;
 }
-async function writeStream(streamId, contentType, batchJson, content) {
+async function writeStream(streamId, contentType, batchJson, headers, content) {
 	const url = `${STREAM_URL}/v1/stream/${streamId}`;
 	const isJson = isJsonContentType(contentType);
 	try {
 		const stream = new __durable_streams_client.DurableStream({
 			url,
+			headers,
 			contentType
 		});
 		if (content) {
@@ -182,34 +221,54 @@ async function writeStream(streamId, contentType, batchJson, content) {
 			}
 		}
 	} catch (error) {
-		if (error instanceof Error) node_process.stderr.write(`Error writing to stream: ${error.message}\n`);
+		const message = error instanceof Error ? error.message : String(error);
+		node_process.stderr.write(`Error writing to stream: ${message}\n`);
 		process.exit(1);
 	}
 }
-async function readStream(streamId) {
+async function readStream(streamId, headers) {
 	const url = `${STREAM_URL}/v1/stream/${streamId}`;
 	try {
-		const stream = new __durable_streams_client.DurableStream({ url });
+		const stream = new __durable_streams_client.DurableStream({
+			url,
+			headers
+		});
 		const res = await stream.stream({ live: `auto` });
 		for await (const chunk of res.bodyStream()) if (chunk.length > 0) node_process.stdout.write(chunk);
 	} catch (error) {
-		if (error instanceof Error) node_process.stderr.write(`Error reading stream: ${error.message}\n`);
+		const message = error instanceof Error ? error.message : String(error);
+		node_process.stderr.write(`Error reading stream: ${message}\n`);
 		process.exit(1);
 	}
 }
-async function deleteStream(streamId) {
+async function deleteStream(streamId, headers) {
 	const url = `${STREAM_URL}/v1/stream/${streamId}`;
 	try {
-		const stream = new __durable_streams_client.DurableStream({ url });
+		const stream = new __durable_streams_client.DurableStream({
+			url,
+			headers
+		});
 		await stream.delete();
 		console.log(`Deleted stream: ${streamId}`);
 	} catch (error) {
-		if (error instanceof Error) node_process.stderr.write(`Error deleting stream: ${error.message}\n`);
+		const message = error instanceof Error ? error.message : String(error);
+		node_process.stderr.write(`Error deleting stream: ${message}\n`);
 		process.exit(1);
 	}
 }
 async function main() {
-	const args = process.argv.slice(2);
+	let options;
+	let args;
+	try {
+		const parsed = parseGlobalOptions(process.argv.slice(2));
+		options = parsed.options;
+		args = parsed.remainingArgs;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		node_process.stderr.write(`Error: ${message}\n`);
+		process.exit(1);
+	}
+	const headers = buildHeaders(options);
 	if (args.length < 1) {
 		printUsage();
 		process.exit(1);
@@ -222,7 +281,7 @@ async function main() {
 				printUsage();
 				process.exit(1);
 			}
-			await createStream(args[1]);
+			await createStream(args[1], headers);
 			break;
 		}
 		case `write`: {
@@ -236,11 +295,12 @@ async function main() {
 			try {
 				parsed = parseWriteArgs(args.slice(2));
 			} catch (error) {
-				if (error instanceof Error) node_process.stderr.write(`Error: ${error.message}\n`);
+				const message = error instanceof Error ? error.message : String(error);
+				node_process.stderr.write(`Error: ${message}\n`);
 				process.exit(1);
 			}
-			if (!node_process.stdin.isTTY) await writeStream(streamId, parsed.contentType, parsed.batchJson);
-			else if (parsed.content) await writeStream(streamId, parsed.contentType, parsed.batchJson, parsed.content);
+			if (!node_process.stdin.isTTY) await writeStream(streamId, parsed.contentType, parsed.batchJson, headers);
+			else if (parsed.content) await writeStream(streamId, parsed.contentType, parsed.batchJson, headers, parsed.content);
 			else {
 				node_process.stderr.write(`Error: content required (provide as argument or pipe to stdin)\n`);
 				printUsage();
@@ -254,7 +314,7 @@ async function main() {
 				printUsage();
 				process.exit(1);
 			}
-			await readStream(args[1]);
+			await readStream(args[1], headers);
 			break;
 		}
 		case `delete`: {
@@ -263,7 +323,7 @@ async function main() {
 				printUsage();
 				process.exit(1);
 			}
-			await deleteStream(args[1]);
+			await deleteStream(args[1], headers);
 			break;
 		}
 		default:
@@ -279,11 +339,14 @@ function isMainModule() {
 	return scriptPath === modulePath;
 }
 if (isMainModule()) main().catch((error) => {
-	node_process.stderr.write(`Fatal error: ${error.message}\n`);
+	const message = error instanceof Error ? error.message : String(error);
+	node_process.stderr.write(`Fatal error: ${message}\n`);
 	process.exit(1);
 });
 
 //#endregion
+exports.buildHeaders = buildHeaders
 exports.flattenJsonForAppend = flattenJsonForAppend
 exports.isJsonContentType = isJsonContentType
+exports.parseGlobalOptions = parseGlobalOptions
 exports.parseWriteArgs = parseWriteArgs

package/dist/index.d.cts

@@ -30,4 +30,20 @@ interface ParsedWriteArgs {
 declare function parseWriteArgs(args: Array<string>): ParsedWriteArgs;
 
 //#endregion
-export { ParsedWriteArgs, flattenJsonForAppend, isJsonContentType, parseWriteArgs };
+//#region src/index.d.ts
+interface GlobalOptions {
+  auth?: string;
+}
+/**
+* Parse global options (like --auth) from args.
+* Falls back to STREAM_AUTH env var if --auth flag not provided.
+* Returns the parsed options and remaining args.
+*/
+declare function parseGlobalOptions(args: Array<string>): {
+  options: GlobalOptions;
+  remainingArgs: Array<string>;
+};
+declare function buildHeaders(options: GlobalOptions): Record<string, string>;
+
+//#endregion
+export { GlobalOptions, ParsedWriteArgs, buildHeaders, flattenJsonForAppend, isJsonContentType, parseGlobalOptions, parseWriteArgs };

package/dist/index.d.ts

@@ -30,4 +30,20 @@ interface ParsedWriteArgs {
 declare function parseWriteArgs(args: Array<string>): ParsedWriteArgs;
 
 //#endregion
-export { ParsedWriteArgs, flattenJsonForAppend, isJsonContentType, parseWriteArgs };
+//#region src/index.d.ts
+interface GlobalOptions {
+  auth?: string;
+}
+/**
+* Parse global options (like --auth) from args.
+* Falls back to STREAM_AUTH env var if --auth flag not provided.
+* Returns the parsed options and remaining args.
+*/
+declare function parseGlobalOptions(args: Array<string>): {
+  options: GlobalOptions;
+  remainingArgs: Array<string>;
+};
+declare function buildHeaders(options: GlobalOptions): Record<string, string>;
+
+//#endregion
+export { GlobalOptions, ParsedWriteArgs, buildHeaders, flattenJsonForAppend, isJsonContentType, parseGlobalOptions, parseWriteArgs };

package/dist/index.js

@@ -68,6 +68,38 @@ function parseWriteArgs(args) {
 //#endregion
 //#region src/index.ts
 const STREAM_URL = process.env.STREAM_URL || `http://localhost:4437`;
+const STREAM_AUTH = process.env.STREAM_AUTH;
+/**
+* Parse global options (like --auth) from args.
+* Falls back to STREAM_AUTH env var if --auth flag not provided.
+* Returns the parsed options and remaining args.
+*/
+function parseGlobalOptions(args) {
+	const options = {};
+	const remainingArgs = [];
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === `--auth`) {
+			const value = args[i + 1];
+			if (!value || value.startsWith(`--`)) throw new Error(`--auth requires a value (e.g., --auth "Bearer token")`);
+			if (!value.trim()) throw new Error(`--auth value cannot be empty or whitespace`);
+			options.auth = value;
+			i++;
+		} else remainingArgs.push(arg);
+	}
+	if (!options.auth && STREAM_AUTH) {
+		if (!STREAM_AUTH.trim()) throw new Error(`STREAM_AUTH environment variable cannot be empty or whitespace`);
+		options.auth = STREAM_AUTH;
+	}
+	return {
+		options,
+		remainingArgs
+	};
+}
+function buildHeaders(options) {
+	if (options.auth) return { Authorization: options.auth };
+	return {};
+}
 function printUsage() {
 	console.error(`
 Usage:
@@ -77,6 +109,9 @@ Usage:
   durable-stream read <stream_id>                Follow a stream and write to stdout
   durable-stream delete <stream_id>              Delete a stream
 
+Global Options:
+  --auth <value>          Authorization header value (e.g., "Bearer my-token")
+
 Write Options:
   --content-type <type>   Content-Type for the message (default: application/octet-stream)
   --json                  Write as JSON (input stored as single message)
@@ -84,18 +119,21 @@ Write Options:
 
 Environment Variables:
   STREAM_URL    Base URL of the stream server (default: http://localhost:4437)
+  STREAM_AUTH   Authorization header value (overridden by --auth flag)
 `);
 }
-async function createStream(streamId) {
+async function createStream(streamId, headers) {
 	const url = `${STREAM_URL}/v1/stream/${streamId}`;
 	try {
 		await DurableStream.create({
 			url,
+			headers,
 			contentType: `application/octet-stream`
 		});
 		console.log(`Created stream: ${streamId}`);
 	} catch (error) {
-		if (error instanceof Error) stderr.write(`Error creating stream: ${error.message}\n`);
+		const message = error instanceof Error ? error.message : String(error);
+		stderr.write(`Error creating stream: ${message}\n`);
 		process.exit(1);
 	}
 }
@@ -110,12 +148,13 @@ async function appendJson(stream, parsed) {
 	}
 	return count;
 }
-async function writeStream(streamId, contentType, batchJson, content) {
+async function writeStream(streamId, contentType, batchJson, headers, content) {
 	const url = `${STREAM_URL}/v1/stream/${streamId}`;
 	const isJson = isJsonContentType(contentType);
 	try {
 		const stream = new DurableStream({
 			url,
+			headers,
 			contentType
 		});
 		if (content) {
@@ -158,34 +197,54 @@ async function writeStream(streamId, contentType, batchJson, content) {
 			}
 		}
 	} catch (error) {
-		if (error instanceof Error) stderr.write(`Error writing to stream: ${error.message}\n`);
+		const message = error instanceof Error ? error.message : String(error);
+		stderr.write(`Error writing to stream: ${message}\n`);
 		process.exit(1);
 	}
 }
-async function readStream(streamId) {
+async function readStream(streamId, headers) {
 	const url = `${STREAM_URL}/v1/stream/${streamId}`;
 	try {
-		const stream = new DurableStream({ url });
+		const stream = new DurableStream({
+			url,
+			headers
+		});
 		const res = await stream.stream({ live: `auto` });
 		for await (const chunk of res.bodyStream()) if (chunk.length > 0) stdout.write(chunk);
 	} catch (error) {
-		if (error instanceof Error) stderr.write(`Error reading stream: ${error.message}\n`);
+		const message = error instanceof Error ? error.message : String(error);
+		stderr.write(`Error reading stream: ${message}\n`);
 		process.exit(1);
 	}
 }
-async function deleteStream(streamId) {
+async function deleteStream(streamId, headers) {
 	const url = `${STREAM_URL}/v1/stream/${streamId}`;
 	try {
-		const stream = new DurableStream({ url });
+		const stream = new DurableStream({
+			url,
+			headers
+		});
 		await stream.delete();
 		console.log(`Deleted stream: ${streamId}`);
 	} catch (error) {
-		if (error instanceof Error) stderr.write(`Error deleting stream: ${error.message}\n`);
+		const message = error instanceof Error ? error.message : String(error);
+		stderr.write(`Error deleting stream: ${message}\n`);
 		process.exit(1);
 	}
 }
 async function main() {
-	const args = process.argv.slice(2);
+	let options;
+	let args;
+	try {
+		const parsed = parseGlobalOptions(process.argv.slice(2));
+		options = parsed.options;
+		args = parsed.remainingArgs;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		stderr.write(`Error: ${message}\n`);
+		process.exit(1);
+	}
+	const headers = buildHeaders(options);
 	if (args.length < 1) {
 		printUsage();
 		process.exit(1);
@@ -198,7 +257,7 @@ async function main() {
 				printUsage();
 				process.exit(1);
 			}
-			await createStream(args[1]);
+			await createStream(args[1], headers);
 			break;
 		}
 		case `write`: {
@@ -212,11 +271,12 @@ async function main() {
 			try {
 				parsed = parseWriteArgs(args.slice(2));
 			} catch (error) {
-				if (error instanceof Error) stderr.write(`Error: ${error.message}\n`);
+				const message = error instanceof Error ? error.message : String(error);
+				stderr.write(`Error: ${message}\n`);
 				process.exit(1);
 			}
-			if (!stdin.isTTY) await writeStream(streamId, parsed.contentType, parsed.batchJson);
-			else if (parsed.content) await writeStream(streamId, parsed.contentType, parsed.batchJson, parsed.content);
+			if (!stdin.isTTY) await writeStream(streamId, parsed.contentType, parsed.batchJson, headers);
+			else if (parsed.content) await writeStream(streamId, parsed.contentType, parsed.batchJson, headers, parsed.content);
 			else {
 				stderr.write(`Error: content required (provide as argument or pipe to stdin)\n`);
 				printUsage();
@@ -230,7 +290,7 @@ async function main() {
 				printUsage();
 				process.exit(1);
 			}
-			await readStream(args[1]);
+			await readStream(args[1], headers);
 			break;
 		}
 		case `delete`: {
@@ -239,7 +299,7 @@ async function main() {
 				printUsage();
 				process.exit(1);
 			}
-			await deleteStream(args[1]);
+			await deleteStream(args[1], headers);
 			break;
 		}
 		default:
@@ -255,9 +315,10 @@ function isMainModule() {
 	return scriptPath === modulePath;
 }
 if (isMainModule()) main().catch((error) => {
-	stderr.write(`Fatal error: ${error.message}\n`);
+	const message = error instanceof Error ? error.message : String(error);
+	stderr.write(`Fatal error: ${message}\n`);
 	process.exit(1);
 });
 
 //#endregion
-export { flattenJsonForAppend, isJsonContentType, parseWriteArgs };
+export { buildHeaders, flattenJsonForAppend, isJsonContentType, parseGlobalOptions, parseWriteArgs };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@durable-streams/cli",
   "description": "CLI tool for working with Durable Streams",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "author": "Durable Stream contributors",
   "bin": {
     "cli": "./dist/index.js",
@@ -12,7 +12,7 @@
     "url": "https://github.com/durable-streams/durable-streams/issues"
   },
   "dependencies": {
-    "@durable-streams/client": "0.1.4"
+    "@durable-streams/client": "0.1.5"
   },
   "devDependencies": {
     "@types/node": "^22.15.21",
@@ -20,7 +20,7 @@
     "tsx": "^4.19.2",
     "typescript": "^5.5.2",
     "vitest": "^3.1.3",
-    "@durable-streams/server": "0.1.5"
+    "@durable-streams/server": "0.1.6"
   },
   "engines": {
     "node": ">=18.0.0"