@durable-streams/cli 0.1.2 → 0.1.4

package/README.md

@@ -4,31 +4,38 @@ A command-line tool for interacting with durable streams.
 
 ## Installation
 
-### Local Development
+### From npm
 
 ```bash
-# Install dependencies
-pnpm install
+# Global installation
+npm install -g @durable-streams/cli
 
-# Build the CLI (for production bin)
-pnpm build
+# Or run directly with npx
+npx @durable-streams/cli create my-stream
+npx @durable-streams/cli read my-stream
 ```
 
-### Global Installation for Development
-
-For development, you can link the CLI globally with live TypeScript execution (no rebuild needed):
+### From source (for development)
 
 ```bash
-# From the CLI package directory
+# Clone the repository
+git clone https://github.com/durable-streams/durable-streams.git
+cd durable-streams
+
+# Install dependencies
+pnpm install
+
+# Build the CLI
+pnpm build
+
+# Link globally for development (uses tsx, no rebuild needed)
+cd packages/cli
 pnpm link:dev
 
 # Now you can use durable-stream-dev anywhere
-# Changes to src/index.ts are immediately available
 durable-stream-dev create my-stream
 ```
 
-This uses `tsx` to run the TypeScript source directly, so you see changes immediately without rebuilding.
-
 ## Quick Start
 
 The easiest way to get started is to run the local development server and use the CLI:
@@ -63,6 +70,11 @@ durable-stream-dev read my-stream
 
 - `STREAM_URL` - Base URL of the stream server (default: `http://localhost:4437`)
 
+### Write Options
+
+- `--content-type <type>` - Content-Type for the message (default: `application/octet-stream`)
+- `--json` - Shorthand for `--content-type application/json`
+
 ### Commands
 
 #### Create a stream
@@ -80,6 +92,12 @@ durable-stream-dev write <stream_id> "Hello, world!"
 # Pipe content from stdin
 echo "Hello from stdin" | durable-stream-dev write <stream_id>
 cat file.txt | durable-stream-dev write <stream_id>
+
+# Specify content type
+durable-stream-dev write <stream_id> '{"key": "value"}' --content-type application/json
+
+# Shorthand for JSON
+durable-stream-dev write <stream_id> '{"key": "value"}' --json
 ```
 
 #### Read from a stream

package/dist/index.cjs

@@ -23,9 +23,39 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
+const node_path = __toESM(require("node:path"));
 const node_process = __toESM(require("node:process"));
+const node_url = __toESM(require("node:url"));
 const __durable_streams_client = __toESM(require("@durable-streams/client"));
 
+//#region src/parseWriteArgs.ts
+/**
+* Parse write command arguments, extracting content-type flags and content.
+* @param args - Arguments after the stream_id (starting from index 2)
+* @returns Parsed content type and content string
+* @throws Error if --content-type is missing its value or if unknown flags are provided
+*/
+function parseWriteArgs(args) {
+	let contentType = `application/octet-stream`;
+	const contentParts = [];
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === `--json`) contentType = `application/json`;
+		else if (arg === `--content-type`) {
+			const nextArg = args[i + 1];
+			if (!nextArg || nextArg.startsWith(`--`)) throw new Error(`--content-type requires a value`);
+			contentType = nextArg;
+			i++;
+		} else if (arg.startsWith(`--`)) throw new Error(`unknown flag: ${arg}`);
+		else contentParts.push(arg);
+	}
+	return {
+		contentType,
+		content: contentParts.join(` `)
+	};
+}
+
+//#endregion
 //#region src/index.ts
 const STREAM_URL = process.env.STREAM_URL || `http://localhost:4437`;
 function printUsage() {
@@ -37,6 +67,10 @@ Usage:
   durable-stream read <stream_id>                Follow a stream and write to stdout
   durable-stream delete <stream_id>              Delete a stream
 
+Write Options:
+  --content-type <type>   Content-Type for the message (default: application/octet-stream)
+  --json                  Shorthand for --content-type application/json
+
 Environment Variables:
   STREAM_URL    Base URL of the stream server (default: http://localhost:4437)
 `);
@@ -54,10 +88,13 @@ async function createStream(streamId) {
 		process.exit(1);
 	}
 }
-async function writeStream(streamId, content) {
+async function writeStream(streamId, contentType, content) {
 	const url = `${STREAM_URL}/v1/stream/${streamId}`;
 	try {
-		const stream = new __durable_streams_client.DurableStream({ url });
+		const stream = new __durable_streams_client.DurableStream({
+			url,
+			contentType
+		});
 		if (content) {
 			const processedContent = content.replace(/\\n/g, `\n`).replace(/\\t/g, `\t`).replace(/\\r/g, `\r`).replace(/\\\\/g, `\\`);
 			await stream.append(processedContent);
@@ -126,9 +163,15 @@ async function main() {
 				process.exit(1);
 			}
 			const streamId = args[1];
-			const content = args.slice(2).join(` `);
-			if (!node_process.stdin.isTTY) await writeStream(streamId);
-			else if (content) await writeStream(streamId, content);
+			let parsed;
+			try {
+				parsed = parseWriteArgs(args.slice(2));
+			} catch (error) {
+				if (error instanceof Error) node_process.stderr.write(`Error: ${error.message}\n`);
+				process.exit(1);
+			}
+			if (!node_process.stdin.isTTY) await writeStream(streamId, parsed.contentType);
+			else if (parsed.content) await writeStream(streamId, parsed.contentType, parsed.content);
 			else {
 				node_process.stderr.write(`Error: content required (provide as argument or pipe to stdin)\n`);
 				printUsage();
@@ -160,9 +203,16 @@ async function main() {
 			process.exit(1);
 	}
 }
-main().catch((error) => {
+function isMainModule() {
+	if (!process.argv[1]) return false;
+	const scriptPath = (0, node_path.resolve)(process.argv[1]);
+	const modulePath = (0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href);
+	return scriptPath === modulePath;
+}
+if (isMainModule()) main().catch((error) => {
 	node_process.stderr.write(`Fatal error: ${error.message}\n`);
 	process.exit(1);
 });
 
-//#endregion
+//#endregion
+exports.parseWriteArgs = parseWriteArgs

package/dist/index.d.cts

@@ -1 +1,15 @@
-export { };
+//#region src/parseWriteArgs.d.ts
+interface ParsedWriteArgs {
+  contentType: string;
+  content: string;
+}
+/**
+* Parse write command arguments, extracting content-type flags and content.
+* @param args - Arguments after the stream_id (starting from index 2)
+* @returns Parsed content type and content string
+* @throws Error if --content-type is missing its value or if unknown flags are provided
+*/
+declare function parseWriteArgs(args: Array<string>): ParsedWriteArgs;
+
+//#endregion
+export { ParsedWriteArgs, parseWriteArgs };

package/dist/index.d.ts

@@ -1 +1,15 @@
-export { };
+//#region src/parseWriteArgs.d.ts
+interface ParsedWriteArgs {
+  contentType: string;
+  content: string;
+}
+/**
+* Parse write command arguments, extracting content-type flags and content.
+* @param args - Arguments after the stream_id (starting from index 2)
+* @returns Parsed content type and content string
+* @throws Error if --content-type is missing its value or if unknown flags are provided
+*/
+declare function parseWriteArgs(args: Array<string>): ParsedWriteArgs;
+
+//#endregion
+export { ParsedWriteArgs, parseWriteArgs };

package/dist/index.js

@@ -1,7 +1,37 @@
 #!/usr/bin/env node
+import { resolve } from "node:path";
 import { stderr, stdin, stdout } from "node:process";
+import { fileURLToPath } from "node:url";
 import { DurableStream } from "@durable-streams/client";
 
+//#region src/parseWriteArgs.ts
+/**
+* Parse write command arguments, extracting content-type flags and content.
+* @param args - Arguments after the stream_id (starting from index 2)
+* @returns Parsed content type and content string
+* @throws Error if --content-type is missing its value or if unknown flags are provided
+*/
+function parseWriteArgs(args) {
+	let contentType = `application/octet-stream`;
+	const contentParts = [];
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === `--json`) contentType = `application/json`;
+		else if (arg === `--content-type`) {
+			const nextArg = args[i + 1];
+			if (!nextArg || nextArg.startsWith(`--`)) throw new Error(`--content-type requires a value`);
+			contentType = nextArg;
+			i++;
+		} else if (arg.startsWith(`--`)) throw new Error(`unknown flag: ${arg}`);
+		else contentParts.push(arg);
+	}
+	return {
+		contentType,
+		content: contentParts.join(` `)
+	};
+}
+
+//#endregion
 //#region src/index.ts
 const STREAM_URL = process.env.STREAM_URL || `http://localhost:4437`;
 function printUsage() {
@@ -13,6 +43,10 @@ Usage:
   durable-stream read <stream_id>                Follow a stream and write to stdout
   durable-stream delete <stream_id>              Delete a stream
 
+Write Options:
+  --content-type <type>   Content-Type for the message (default: application/octet-stream)
+  --json                  Shorthand for --content-type application/json
+
 Environment Variables:
   STREAM_URL    Base URL of the stream server (default: http://localhost:4437)
 `);
@@ -30,10 +64,13 @@ async function createStream(streamId) {
 		process.exit(1);
 	}
 }
-async function writeStream(streamId, content) {
+async function writeStream(streamId, contentType, content) {
 	const url = `${STREAM_URL}/v1/stream/${streamId}`;
 	try {
-		const stream = new DurableStream({ url });
+		const stream = new DurableStream({
+			url,
+			contentType
+		});
 		if (content) {
 			const processedContent = content.replace(/\\n/g, `\n`).replace(/\\t/g, `\t`).replace(/\\r/g, `\r`).replace(/\\\\/g, `\\`);
 			await stream.append(processedContent);
@@ -43,8 +80,8 @@ async function writeStream(streamId, content) {
 			stdin.on(`data`, (chunk) => {
 				chunks.push(chunk);
 			});
-			await new Promise((resolve, reject) => {
-				stdin.on(`end`, resolve);
+			await new Promise((resolve$1, reject) => {
+				stdin.on(`end`, resolve$1);
 				stdin.on(`error`, reject);
 			});
 			const data = Buffer.concat(chunks);
@@ -102,9 +139,15 @@ async function main() {
 				process.exit(1);
 			}
 			const streamId = args[1];
-			const content = args.slice(2).join(` `);
-			if (!stdin.isTTY) await writeStream(streamId);
-			else if (content) await writeStream(streamId, content);
+			let parsed;
+			try {
+				parsed = parseWriteArgs(args.slice(2));
+			} catch (error) {
+				if (error instanceof Error) stderr.write(`Error: ${error.message}\n`);
+				process.exit(1);
+			}
+			if (!stdin.isTTY) await writeStream(streamId, parsed.contentType);
+			else if (parsed.content) await writeStream(streamId, parsed.contentType, parsed.content);
 			else {
 				stderr.write(`Error: content required (provide as argument or pipe to stdin)\n`);
 				printUsage();
@@ -136,9 +179,16 @@ async function main() {
 			process.exit(1);
 	}
 }
-main().catch((error) => {
+function isMainModule() {
+	if (!process.argv[1]) return false;
+	const scriptPath = resolve(process.argv[1]);
+	const modulePath = fileURLToPath(import.meta.url);
+	return scriptPath === modulePath;
+}
+if (isMainModule()) main().catch((error) => {
 	stderr.write(`Fatal error: ${error.message}\n`);
 	process.exit(1);
 });
 
-//#endregion
+//#endregion
+export { parseWriteArgs };

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@durable-streams/cli",
   "description": "CLI tool for working with Durable Streams",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "author": "Durable Stream contributors",
   "bin": {
+    "cli": "./dist/index.js",
     "durable-stream": "./dist/index.js",
     "durable-stream-dev": "./bin/durable-stream-dev.mjs"
   },
@@ -11,14 +12,15 @@
     "url": "https://github.com/durable-streams/durable-streams/issues"
   },
   "dependencies": {
-    "@durable-streams/client": "0.1.2"
+    "@durable-streams/client": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^22.15.21",
     "tsdown": "^0.9.0",
     "tsx": "^4.19.2",
     "typescript": "^5.5.2",
-    "@durable-streams/server": "0.1.2"
+    "vitest": "^3.1.3",
+    "@durable-streams/server": "0.1.4"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -61,6 +63,7 @@
     "build": "tsdown",
     "dev": "tsdown --watch",
     "link:dev": "pnpm link --global",
-    "start:dev": "tsx --watch example-server.ts"
+    "start:dev": "tsx --watch example-server.ts",
+    "test": "vitest run"
   }
 }