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

package/dist/index.cjs

@@ -26,6 +26,7 @@ const __optique_core_primitives = __toESM(require("@optique/core/primitives"));
 const __optique_core_modifiers = __toESM(require("@optique/core/modifiers"));
 const __optique_core_message = __toESM(require("@optique/core/message"));
 const node_path = __toESM(require("node:path"));
+const __optique_core_nonempty = __toESM(require("@optique/core/nonempty"));
 const __optique_core_constructs = __toESM(require("@optique/core/constructs"));
 
 //#region src/loglevel.ts
@@ -219,11 +220,14 @@ function debug(options = {}) {
 *
 * @param options Configuration options for the parser.
 * @returns A {@link ValueParser} that produces a {@link LogOutput}.
+* @throws {TypeError} If `options.metavar` is an empty string.
 */
 function logOutputValueParser(options = {}) {
+	const metavar = options.metavar ?? "FILE";
+	(0, __optique_core_nonempty.ensureNonEmptyString)(metavar);
 	return {
 		$mode: "sync",
-		metavar: options.metavar ?? "FILE",
+		metavar,
 		parse(input) {
 			if (input === "-") return {
 				success: true,
@@ -266,6 +270,7 @@ function logOutputValueParser(options = {}) {
 *
 * @param options Configuration options for the log output parser.
 * @returns A {@link Parser} that produces a {@link LogOutput} or `undefined`.
+* @throws {TypeError} If `options.metavar` is an empty string.
 *
 * @example Basic usage
 * ```typescript
@@ -301,6 +306,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 +331,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.
@@ -287,6 +288,7 @@ interface LogOutputOptions {
  *
  * @param options Configuration options for the log output parser.
  * @returns A {@link Parser} that produces a {@link LogOutput} or `undefined`.
+ * @throws {TypeError} If `options.metavar` is an empty string.
  *
  * @example Basic usage
  * ```typescript
@@ -313,6 +315,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.
@@ -287,6 +288,7 @@ interface LogOutputOptions {
  *
  * @param options Configuration options for the log output parser.
  * @returns A {@link Parser} that produces a {@link LogOutput} or `undefined`.
+ * @throws {TypeError} If `options.metavar` is an empty string.
  *
  * @example Basic usage
  * ```typescript
@@ -313,6 +315,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

@@ -3,6 +3,7 @@ import { flag, option } from "@optique/core/primitives";
 import { map, multiple, optional, withDefault } from "@optique/core/modifiers";
 import { message } from "@optique/core/message";
 import { basename } from "node:path";
+import { ensureNonEmptyString } from "@optique/core/nonempty";
 import { group, object } from "@optique/core/constructs";
 
 //#region src/loglevel.ts
@@ -196,11 +197,14 @@ function debug(options = {}) {
 *
 * @param options Configuration options for the parser.
 * @returns A {@link ValueParser} that produces a {@link LogOutput}.
+* @throws {TypeError} If `options.metavar` is an empty string.
 */
 function logOutputValueParser(options = {}) {
+	const metavar = options.metavar ?? "FILE";
+	ensureNonEmptyString(metavar);
 	return {
 		$mode: "sync",
-		metavar: options.metavar ?? "FILE",
+		metavar,
 		parse(input) {
 			if (input === "-") return {
 				success: true,
@@ -243,6 +247,7 @@ function logOutputValueParser(options = {}) {
 *
 * @param options Configuration options for the log output parser.
 * @returns A {@link Parser} that produces a {@link LogOutput} or `undefined`.
+* @throws {TypeError} If `options.metavar` is an empty string.
 *
 * @example Basic usage
 * ```typescript
@@ -278,6 +283,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 +308,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.1400+437307fc",
   "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.1400+437307fc"
   },
   "devDependencies": {
     "@logtape/file": "^2.0.4",