@optique/logtape 1.0.0-dev.1388 → 1.0.0-dev.1390

package/dist/index.cjs

@@ -301,6 +301,10 @@ function logOutput(options = {}) {
 *
 * @param options Configuration options for the console sink.
 * @returns A {@link Sink} function.
+* @throws {TypeError} If `options.stream` is not `"stdout"` or `"stderr"`
+*   when `streamResolver` is not provided.
+* @throws {TypeError} If `streamResolver` returns a value other than
+*   `"stdout"` or `"stderr"`.
 *
 * @example Static stream selection
 * ```typescript
@@ -322,10 +326,23 @@ function logOutput(options = {}) {
 * @since 0.8.0
 */
 function createConsoleSink(options = {}) {
-	const defaultStream = options.stream ?? "stderr";
 	const streamResolver = options.streamResolver;
+	const defaultStream = options.stream ?? "stderr";
+	const invalidStreamError = (value) => {
+		let repr;
+		if (typeof value === "string") repr = JSON.stringify(value);
+		else if (value === null || typeof value !== "object") repr = String(value);
+		else try {
+			repr = JSON.stringify(value) ?? String(value);
+		} catch {
+			repr = String(value);
+		}
+		return /* @__PURE__ */ new TypeError(`Invalid stream: expected "stdout" or "stderr", got ${repr}.`);
+	};
+	if (!streamResolver && defaultStream !== "stdout" && defaultStream !== "stderr") throw invalidStreamError(defaultStream);
 	return (record) => {
 		const stream = streamResolver ? streamResolver(record.level) : defaultStream;
+		if (stream !== "stdout" && stream !== "stderr") throw invalidStreamError(stream);
 		const messageParts = [];
 		for (let i = 0; i < record.message.length; i++) {
 			const part = record.message[i];

package/dist/index.d.cts

@@ -228,9 +228,10 @@ type LogOutput = {
 interface ConsoleSinkOptions {
   /**
    * The stream to write to. Either `"stdout"` or `"stderr"`.
+   * If `null` or `undefined`, defaults to `"stderr"`.
    * @default `"stderr"`
    */
-  readonly stream?: "stdout" | "stderr";
+  readonly stream?: "stdout" | "stderr" | null;
   /**
    * A function that determines which stream to use based on the log level.
    * If provided, this takes precedence over the `stream` option.
@@ -313,6 +314,10 @@ declare function logOutput(options?: LogOutputOptions): Parser<"sync", LogOutput
  *
  * @param options Configuration options for the console sink.
  * @returns A {@link Sink} function.
+ * @throws {TypeError} If `options.stream` is not `"stdout"` or `"stderr"`
+ *   when `streamResolver` is not provided.
+ * @throws {TypeError} If `streamResolver` returns a value other than
+ *   `"stdout"` or `"stderr"`.
  *
  * @example Static stream selection
  * ```typescript

package/dist/index.d.ts

@@ -228,9 +228,10 @@ type LogOutput = {
 interface ConsoleSinkOptions {
   /**
    * The stream to write to. Either `"stdout"` or `"stderr"`.
+   * If `null` or `undefined`, defaults to `"stderr"`.
    * @default `"stderr"`
    */
-  readonly stream?: "stdout" | "stderr";
+  readonly stream?: "stdout" | "stderr" | null;
   /**
    * A function that determines which stream to use based on the log level.
    * If provided, this takes precedence over the `stream` option.
@@ -313,6 +314,10 @@ declare function logOutput(options?: LogOutputOptions): Parser<"sync", LogOutput
  *
  * @param options Configuration options for the console sink.
  * @returns A {@link Sink} function.
+ * @throws {TypeError} If `options.stream` is not `"stdout"` or `"stderr"`
+ *   when `streamResolver` is not provided.
+ * @throws {TypeError} If `streamResolver` returns a value other than
+ *   `"stdout"` or `"stderr"`.
  *
  * @example Static stream selection
  * ```typescript

package/dist/index.js

@@ -278,6 +278,10 @@ function logOutput(options = {}) {
 *
 * @param options Configuration options for the console sink.
 * @returns A {@link Sink} function.
+* @throws {TypeError} If `options.stream` is not `"stdout"` or `"stderr"`
+*   when `streamResolver` is not provided.
+* @throws {TypeError} If `streamResolver` returns a value other than
+*   `"stdout"` or `"stderr"`.
 *
 * @example Static stream selection
 * ```typescript
@@ -299,10 +303,23 @@ function logOutput(options = {}) {
 * @since 0.8.0
 */
 function createConsoleSink(options = {}) {
-	const defaultStream = options.stream ?? "stderr";
 	const streamResolver = options.streamResolver;
+	const defaultStream = options.stream ?? "stderr";
+	const invalidStreamError = (value) => {
+		let repr;
+		if (typeof value === "string") repr = JSON.stringify(value);
+		else if (value === null || typeof value !== "object") repr = String(value);
+		else try {
+			repr = JSON.stringify(value) ?? String(value);
+		} catch {
+			repr = String(value);
+		}
+		return /* @__PURE__ */ new TypeError(`Invalid stream: expected "stdout" or "stderr", got ${repr}.`);
+	};
+	if (!streamResolver && defaultStream !== "stdout" && defaultStream !== "stderr") throw invalidStreamError(defaultStream);
 	return (record) => {
 		const stream = streamResolver ? streamResolver(record.level) : defaultStream;
+		if (stream !== "stdout" && stream !== "stderr") throw invalidStreamError(stream);
 		const messageParts = [];
 		for (let i = 0; i < record.message.length; i++) {
 			const part = record.message[i];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/logtape",
-  "version": "1.0.0-dev.1388+3660675f",
+  "version": "1.0.0-dev.1390+84b0f473",
   "description": "LogTape logging integration for Optique CLI parser",
   "keywords": [
     "CLI",
@@ -63,7 +63,7 @@
     }
   },
   "dependencies": {
-    "@optique/core": "1.0.0-dev.1388+3660675f"
+    "@optique/core": "1.0.0-dev.1390+84b0f473"
   },
   "devDependencies": {
     "@logtape/file": "^2.0.4",