outrank-cli 0.8.0 → 0.9.0

package/src/core/constants.js

@@ -27,6 +27,8 @@ export const MCP_STARTUP_RESOLVE_TIMEOUT_MS = 3_000;
 
 export const MAX_IMAGE_UPLOAD_MEGABYTES = 5;
 export const MAX_IMAGE_UPLOAD_BYTES = MAX_IMAGE_UPLOAD_MEGABYTES * BYTES_PER_MB;
+export const MAX_TEXT_FILE_MEGABYTES = 1;
+export const MAX_TEXT_FILE_BYTES = MAX_TEXT_FILE_MEGABYTES * BYTES_PER_MB;
 export const MAX_UPSTREAM_ERROR_BODY_CHARS = 500;
 export const MAX_RATE_LIMIT_HEADER_LENGTH = 64;
 export const MAX_TOOL_NAME_LENGTH = 46;
@@ -50,6 +52,7 @@ export const BLOG_TEMPLATES = Object.freeze(['classic', 'editorial', 'journal',
 export const BLOG_ANALYTICS_RANGES = Object.freeze(['7d', '30d', '90d']);
 export const BLOG_DOMAIN_MODES = Object.freeze(['subdomain', 'apex', 'subfolder']);
 export const BLOG_POST_LIST_STATUSES = Object.freeze(['all', 'published', 'scheduled', 'draft']);
+export const BLOG_POST_WRITE_STATUSES = Object.freeze(['draft', 'published', 'scheduled']);
 export const BLOG_SUBSCRIBER_STATUSES = Object.freeze(['subscribed', 'unsubscribed']);
 export const BLOG_PREVIEW_DESIGN_SCOPE = 'design';
 export const BLOG_PREVIEW_SCOPES = Object.freeze([BLOG_PREVIEW_DESIGN_SCOPE, 'post', 'page']);

package/src/core/files.js

@@ -1,7 +1,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 
-import { MAX_IMAGE_UPLOAD_BYTES } from './constants.js';
+import { MAX_IMAGE_UPLOAD_BYTES, MAX_TEXT_FILE_BYTES } from './constants.js';
 import { usageError } from './errors.js';
 
 const ImageMime = Object.freeze({
@@ -184,3 +184,39 @@ export const readImageUpload = async ({ filePath, allowedDir }) => {
 
   return toUpload(buffer, fileName);
 };
+
+const UTF8_ENCODING = 'utf-8';
+const BYTE_ORDER_MARK = '\uFEFF';
+const LINE_BREAK_PATTERN = /\r\n?/g;
+const LINE_FEED = '\n';
+const TEXT_OVERSIZE_GUIDANCE = 'Split the content or shorten it below the limit, then retry.';
+const TEXT_ENCODING_GUIDANCE = 'Save the file as UTF-8 text, then retry.';
+
+export const readTextFile = async ({ filePath, option }) => {
+  if (typeof filePath !== 'string' || filePath === '') {
+    throw usageError(`Missing required option: ${option} <path>.`, `Pass a local file path with \`${option} <path>\`.`);
+  }
+  let buffer;
+  try {
+    const stats = await fs.stat(filePath);
+    if (!stats.isFile()) throw usageError(`Not a file: ${filePath}`, readGuidance(filePath));
+    if (stats.size > MAX_TEXT_FILE_BYTES) {
+      throw usageError(
+        `${filePath} is ${stats.size} bytes; the maximum is ${MAX_TEXT_FILE_BYTES} bytes.`,
+        TEXT_OVERSIZE_GUIDANCE,
+      );
+    }
+    buffer = await fs.readFile(filePath);
+  } catch (error) {
+    if (error?.cliCode) throw error;
+    throw usageError(`Failed to read file: ${error.message}`, readGuidance(filePath));
+  }
+  let text;
+  try {
+    text = new TextDecoder(UTF8_ENCODING, { fatal: true }).decode(buffer);
+  } catch {
+    throw usageError(`${filePath} is not valid UTF-8 text.`, TEXT_ENCODING_GUIDANCE);
+  }
+  const withoutBom = text.startsWith(BYTE_ORDER_MARK) ? text.slice(BYTE_ORDER_MARK.length) : text;
+  return withoutBom.replace(LINE_BREAK_PATTERN, LINE_FEED);
+};

package/src/core/schema.js

@@ -11,6 +11,7 @@ export const FieldKind = Object.freeze({
   OBJECT: 'object',
   JSON: 'json',
   IMAGE: 'image',
+  TEXT_FILE: 'text-file',
 });
 
 export const BoolSerialize = Object.freeze({
@@ -63,6 +64,7 @@ export const list = ({ split = DEFAULT_LIST_SEPARATOR, serialize = ListSerialize
 export const object = () => createField(FieldKind.OBJECT, { properties: undefined });
 export const json = () => createField(FieldKind.JSON);
 export const image = () => createField(FieldKind.IMAGE);
+export const textFile = () => createField(FieldKind.TEXT_FILE);
 
 export const isField = (value) => Boolean(value) && Object.values(FieldKind).includes(value.kind);
 
@@ -124,6 +126,10 @@ const parseScalar = (field, value, label) => {
     if (!valid) throw usageError(`${label} must be an image upload (file_base64, file_name, file_type).`);
     return value;
   }
+  if (field.kind === FieldKind.TEXT_FILE) {
+    if (typeof value !== 'string') throw usageError(`${label} must be the path of a text file.`);
+    return value;
+  }
   throw new Error(`Unknown field kind: ${field.kind}`);
 };
 
@@ -254,6 +260,7 @@ const zodScalar = (z, field, options = {}) => {
   if (field.kind === FieldKind.IMAGE) {
     return z.object({ file_base64: z.string().min(1), file_name: z.string().min(1), file_type: z.string().min(1) });
   }
+  if (field.kind === FieldKind.TEXT_FILE) return z.string();
   throw new Error(`Unknown field kind: ${field.kind}`);
 };