monday-cli 0.4.0 → 0.5.0

package/dist/utils/source-content.js

@@ -0,0 +1,120 @@
+/**
+ * Generic file-or-stdin-or-inline-string source-content reader
+ * (R-v0.5-NEW-18 lift, v0.5-M37 IMPL kickoff — ahead-of-feat per
+ * R-NEW-29 M25 + R-NEW-70 M34 cadence; `v0.5-plan.md` §22 R-v0.5-NEW-18
+ * entry).
+ *
+ * Five sites consume the same shape post-lift:
+ *
+ *   - `src/commands/update/create.ts` (M13; `--body <md>` /
+ *     `--body-file <path|->`).
+ *   - `src/commands/update/reply.ts` (M13).
+ *   - `src/commands/update/edit.ts` (M13).
+ *   - `src/commands/doc/import-html.ts` (M37; `--html-string <s>` /
+ *     `--html <file|->`).
+ *   - `src/commands/doc/append-markdown.ts` (M37; `--markdown-string
+ *     <s>` / `--markdown <file|->`).
+ *
+ * All five materialise a content payload from one of three mutually-
+ * exclusive sources:
+ *
+ *   1. `inline` — literal content via an inline-string flag (e.g.
+ *      `--body <md>`, `--html-string <s>`, `--markdown-string <s>`).
+ *   2. `file` — file path via a file-source flag (e.g.
+ *      `--body-file <path>`, `--html <file>`, `--markdown <file>`).
+ *   3. `file === '-'` — stdin (requires the `stdin` slot wired by
+ *      the runner).
+ *
+ * Mutex of (1) vs (2) is typically enforced at the parse boundary via
+ * a cross-field `.refine()` on the argv schema (see R-v0.5-NEW-20);
+ * the helper rejects the both-set case defensively. Inline byte-length
+ * cap is enforced at the parse boundary via `.refine()` (see
+ * R-v0.5-NEW-21); when {@link ReadSourceContentInputs.maxBytes} is
+ * supplied here, the same cap is applied at the runtime read boundary
+ * for the file / stdin path (file content size isn't known at argv-
+ * parse time).
+ *
+ * Throws `UsageError` for:
+ *   - Both `inline` and `file` set (pre-parse-boundary drift).
+ *   - Neither set (no source).
+ *   - `file === '-'` with no `stdin` (programmer wiring bug).
+ *   - Empty (or whitespace-only) result after read.
+ *   - File-read failure (ENOENT / EACCES / etc.) wrapped with the
+ *     underlying error message.
+ *   - Oversized payload (when `maxBytes` is set) with
+ *     `details.size_bytes` + `details.limit_bytes` + `details.source`
+ *     ('inline' / 'file' / 'stdin') for agent introspection.
+ */
+import { readFile } from 'node:fs/promises';
+import { UsageError, errorMessage } from './errors.js';
+const enforceMaxBytes = (content, source, maxBytes, inputs) => {
+    const size = Buffer.byteLength(content, 'utf8');
+    if (size <= maxBytes)
+        return;
+    const flagName = source === 'inline' ? inputs.inlineFlagName : inputs.fileFlagName;
+    const details = {
+        source,
+        size_bytes: size,
+        limit_bytes: maxBytes,
+    };
+    if (source === 'file' && inputs.file !== undefined) {
+        details.file_path = inputs.file;
+    }
+    throw new UsageError(`${flagName}: payload (${String(size)} bytes) exceeds the ${String(maxBytes)}-byte wire-side limit. Pass a smaller payload, or split the call.`, { details });
+};
+export const readSourceContent = async (inputs) => {
+    const { inline, file, stdin, inlineFlagName, fileFlagName, maxBytes, } = inputs;
+    const trimTrailing = inputs.trimTrailingWhitespace ?? true;
+    if (inline !== undefined && file !== undefined) {
+        throw new UsageError(`${inlineFlagName} and ${fileFlagName} are mutually exclusive; pick one.`, { details: { [`has_inline_value`]: true, file_path: file } });
+    }
+    if (inline !== undefined) {
+        if (inline.trim().length === 0) {
+            throw new UsageError(`${inlineFlagName} cannot be empty (or whitespace-only). Pass content or use ${fileFlagName} <path> to read from disk / stdin.`);
+        }
+        if (maxBytes !== undefined) {
+            enforceMaxBytes(inline, 'inline', maxBytes, inputs);
+        }
+        return inline;
+    }
+    if (file === undefined) {
+        const verbHint = inputs.verbHint ??
+            `requires either ${inlineFlagName} <s> or ${fileFlagName} <file>. Use ${fileFlagName} - to read from stdin.`;
+        throw new UsageError(verbHint);
+    }
+    if (file === '-') {
+        if (stdin === undefined) {
+            throw new UsageError(`${fileFlagName} - requested stdin, but no stdin is wired into the runner. This is a programmer wiring bug.`);
+        }
+        const chunks = [];
+        for await (const chunk of stdin) {
+            chunks.push(Buffer.from(chunk));
+        }
+        const raw = Buffer.concat(chunks).toString('utf8');
+        const body = trimTrailing ? raw.trimEnd() : raw;
+        if (body.length === 0) {
+            throw new UsageError(`stdin produced an empty payload. Pipe non-empty content into ${fileFlagName} - or pass ${inlineFlagName} <s> inline.`, { details: { source: 'stdin' } });
+        }
+        if (maxBytes !== undefined) {
+            enforceMaxBytes(body, 'stdin', maxBytes, inputs);
+        }
+        return body;
+    }
+    // File on disk. UTF-8 always; binary content would corrupt the
+    // markdown / HTML payload anyway.
+    const raw = await readFile(file, 'utf8').catch((err) => {
+        throw new UsageError(`${fileFlagName}: failed to read ${JSON.stringify(file)} (${errorMessage(err)}).`, {
+            cause: err,
+            details: { file_path: file },
+        });
+    });
+    const body = trimTrailing ? raw.trimEnd() : raw;
+    if (body.length === 0) {
+        throw new UsageError(`${fileFlagName}: ${JSON.stringify(file)} is empty (after trim). Pass non-empty content.`, { details: { file_path: file } });
+    }
+    if (maxBytes !== undefined) {
+        enforceMaxBytes(body, 'file', maxBytes, inputs);
+    }
+    return body;
+};
+//# sourceMappingURL=source-content.js.map

package/dist/utils/source-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-content.js","sourceRoot":"","sources":["../../src/utils/source-content.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monday-cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Agent-first CLI for Monday.com — read boards, file backlog items, transition statuses, and post comments from the terminal. Built for AI coding agents (Claude Code, Codex) with humans as a welcome second audience.",
   "type": "module",
   "engines": {