@frontmcp/utils 1.10.15 → 1.11.0-rc.1

package/fs/fs.d.ts

@@ -11,9 +11,10 @@
  * detached worker (CLI task runners, dev-server supervisors, etc.). Throws
  * via `assertNode` on non-Node runtimes.
  *
- * **Node.js only.** Exposed because consumers (e.g. `CliTaskRunner` in the
- * SDK) need a single place to reach `spawn` without a top-level
- * `import 'node:child_process'` that V8 isolates would choke on.
+ * **Node.js only.** Exposed so consumers have a single place to reach `spawn`
+ * without a top-level `import 'node:child_process'` that V8 isolates would
+ * choke on. A worker that should be reapable once its owner dies is spawned
+ * with `spawnOwned` instead (as `CliTaskRunner` in the SDK does).
  */
 export declare function getSpawnFn(): typeof import('child_process').spawn;
 /**
@@ -64,13 +65,26 @@ export declare function readFileBuffer(p: string): Promise<Buffer>;
  *
  * @param p - Path to write to
  * @param content - Content to write
- * @param options - Optional mode (permissions)
+ * @param options - Optional mode (permissions, applied when the file is created) and flag (e.g. `'a'` to append)
  *
  * @example
  * await writeFile('/path/to/file.txt', 'hello', { mode: 0o600 });
  */
 export declare function writeFile(p: string, content: string, options?: {
     mode?: number;
+    flag?: string;
+}): Promise<void>;
+/**
+ * Append content to a file, creating the file when it is missing.
+ *
+ * **Node.js only** - throws an error if called in browser.
+ *
+ * @param p - Path to append to
+ * @param content - Content to append
+ * @param options - The mode (permissions) a file created here gets, e.g. 0o600
+ */
+export declare function appendFile(p: string, content: string, options?: {
+    mode?: number;
 }): Promise<void>;
 /**
  * Create a directory with optional mode (permissions).
@@ -152,6 +166,8 @@ export declare function fileExists(p: string): Promise<boolean>;
  * fileExistsSync('/path/to/file.txt') // true or false
  */
 export declare function fileExistsSync(p: string): boolean;
+/** Whether `p` is known to be missing: a check that fails another way (no access, a timeout) can't tell. */
+export declare function isMissingSync(p: string): boolean;
 /**
  * Read and parse a JSON file.
  *
@@ -200,6 +216,31 @@ export declare function ensureDir(p: string): Promise<void>;
  * if (stats.isDirectory()) { ... }
  */
 export declare function stat(p: string): Promise<import('fs').Stats>;
+/**
+ * Get file/directory stats without following a symlink.
+ *
+ * **Node.js only** - throws an error if called in browser.
+ *
+ * @param p - Path to file, directory, socket or symlink
+ * @returns Stats of the entry itself (isSocket(), isSymbolicLink(), mode, uid, ...)
+ *
+ * @example
+ * const stats = await lstat('/tmp/app.sock');
+ * if (stats.isSocket()) { ... }
+ */
+export declare function lstat(p: string): Promise<import('fs').Stats>;
+/**
+ * Change the permission bits of a file or directory.
+ *
+ * **Node.js only** - throws an error if called in browser.
+ *
+ * @param p - Path to file or directory
+ * @param mode - Permission bits, e.g. 0o600
+ *
+ * @example
+ * await chmod('/tmp/app.sock', 0o600);
+ */
+export declare function chmod(p: string, mode: number): Promise<void>;
 /** Link type accepted by {@link symlink}; only meaningful on Windows. */
 export type SymlinkType = 'dir' | 'file' | 'junction';
 /**

package/fs/index.d.ts

@@ -1,2 +1,2 @@
-export { readFile, readFileSync, readFileBuffer, writeFile, mkdir, rename, unlink, stat, copyFile, cp, readdir, readdirSync, realpath, rm, mkdtemp, symlink, access, fileExists, fileExistsSync, readJSON, writeJSON, ensureDir, ensureDirSync, isDirEmpty, runCmd, watchFile, getSpawnFn, } from './fs';
+export { readFile, readFileSync, readFileBuffer, writeFile, appendFile, mkdir, rename, unlink, stat, lstat, chmod, copyFile, cp, readdir, readdirSync, realpath, rm, mkdtemp, symlink, access, fileExists, fileExistsSync, readJSON, writeJSON, ensureDir, ensureDirSync, isDirEmpty, runCmd, watchFile, getSpawnFn, } from './fs';
 export type { FileWatcherHandle, SymlinkType } from './fs';

package/index.d.ts

@@ -10,13 +10,19 @@ export type { NameCase } from './naming';
 export { isValidMcpUri, extractUriScheme, isValidMcpUriTemplate, parseUriTemplate, matchUriTemplate, expandUriTemplate, extractTemplateParams, isUriTemplate, } from './uri';
 export type { ParsedUriTemplate } from './uri';
 export { trimSlashes, joinPath, pathResolve, pathJoin, basename, dirname, extname, isAbsolute, pathToFileURL, sep, } from './path';
-export { sanitizeToJson, inferMimeType, findNonFiniteNumber } from './content';
+export { sanitizeToJson, inferMimeType, findNonFiniteNumber, findDroppedKeys } from './content';
 export { validateBaseUrl, buildSetCookie, parseCookies, getCookie, isLocalhost, isSecureRequest } from './http';
 export type { CookieOptions, SecureDetectionRequest } from './http';
 export { classifyIpAddress, expandIpv6, extractEmbeddedIpv4, parseIpv4, isRedirectResponse } from './net';
 export type { IpAddressClassification, IpAddressRange, SpecialPurposeIpRange, RedirectCandidate } from './net';
-export { readFile, readFileSync, readFileBuffer, writeFile, mkdir, rename, unlink, stat, copyFile, cp, readdir, readdirSync, realpath, rm, mkdtemp, symlink, access, fileExists, fileExistsSync, readJSON, writeJSON, ensureDir, ensureDirSync, isDirEmpty, runCmd, watchFile, getSpawnFn, } from './fs';
+export { readFile, readFileSync, readFileBuffer, writeFile, appendFile, mkdir, rename, unlink, stat, lstat, chmod, copyFile, cp, readdir, readdirSync, realpath, rm, mkdtemp, symlink, access, fileExists, fileExistsSync, readJSON, writeJSON, ensureDir, ensureDirSync, isDirEmpty, runCmd, watchFile, getSpawnFn, } from './fs';
 export type { FileWatcherHandle } from './fs';
+export { processTreeSpawnOptions, signalProcessTree, isProcessTreeAlive, stopProcessTree, spawnOwned, reapOrphans, OwnedProcessError, watchParent, watchPath, } from './process';
+export type { ProcessTreeDeps, SpawnOwnedOptions, OwnedProcess, ReapOrphansOptions, ParentGoneReason, ProcessWatcher, WatchParentOptions, WatchPathOptions, } from './process';
+export { DEV_BUFFER_FULL, DEV_ERROR_MESSAGE, DEV_RELOAD_DEADLINE, DEV_SERVER_UNREACHABLE, makeDevError, listChangedNotifications, createBridgeStateMachine, createStdioFramer, createHttpUpstream, createPipeUpstream, } from './stdio-bridge';
+export type { BridgeState, BridgeStateMachine, BridgeStateMachineOptions, InflightRequest, JsonRpcFrame, StdioFramer, StdioFramerOptions, BridgeLogger, HttpUpstreamClient, HttpUpstreamOptions, PipeUpstreamOptions, UpstreamClient, UpstreamClientOptions, } from './stdio-bridge';
+export { redactFields, redactJson } from './redaction';
+export type { RedactedFields } from './redaction';
 export { escapeHtml, escapeHtmlAttr, escapeJsString, escapeScriptClose, safeJsonForScript } from './escape';
 export { brandClass, isBrandedInstance } from './class-brand';
 export { safeStringify } from './serialization';
@@ -27,8 +33,8 @@ export { EventEmitter } from './event-emitter';
 export { getEnv, getNodeEnv, getCwd, isProduction, isDevelopment, getEnvFlag, isDebug, setEnv, isEdgeRuntime, isServerless, supportsAnsi, getRuntimeContext, resetRuntimeContext, detectRuntimeContext, isEntryAvailable, checkEntryAvailability, entryAvailabilitySchema, } from './env';
 export type { RuntimeContext, EntryAvailability } from './env';
 export { analyzePattern, isPatternSafe, createSafeRegExp, safeTest, safeMatch, safeReplace, safeExec, isInputLengthSafe, DEFAULT_MAX_INPUT_LENGTH, REDOS_THRESHOLDS, trimLeading, trimTrailing, trimBoth, trimChars, extractBracedParams, expandTemplate, hasTemplatePlaceholders, collapseChar, collapseWhitespace, type SafeRegexOptions, type PatternAnalysisResult, } from './regex';
-export { createStorage, createMemoryStorage, getDetectedStorageType, NamespacedStorageImpl, createRootStorage, createNamespacedStorage, buildPrefix, NAMESPACE_SEPARATOR, StorageError, StorageConnectionError, StorageOperationError, StorageNotSupportedError, StorageConfigError, StorageTTLError, StoragePatternError, StorageNotConnectedError, EncryptedStorageError, BaseStorageAdapter, MemoryStorageAdapter, RedisStorageAdapter, createRedisClient, VercelKvStorageAdapter, createVercelKvClient, type VercelKvConnection, UpstashStorageAdapter, FileSystemStorageAdapter, type FileSystemAdapterOptions, TypedStorage, type TypedStorageOptions, type TypedSetOptions, type TypedSetEntry, EncryptedTypedStorage, type EncryptedTypedStorageOptions, type EncryptedSetOptions, type EncryptedSetEntry, type EncryptionKey, type StoredEncryptedBlob, type ClientKeyBinding, globToRegex, matchesPattern, validatePattern, escapeGlob, MAX_TTL_SECONDS, validateTTL, validateOptionalTTL, ttlToExpiresAt, expiresAtToTTL, isExpired, normalizeTTL, attachRedisErrorListener, DEFAULT_REDIS_ERROR_LOG_INTERVAL_MS, mergeRedisUrlFields, describeRedisUrlConflicts, } from './storage';
-export type { StorageAdapter, NamespacedStorage, RootStorage, SetOptions, SetEntry, MessageHandler, Unsubscribe, MemoryAdapterOptions, RedisAdapterOptions, RedisHostConnectionConfig, RedisUrlConnectionConfig, RedisUrlFillInConfig, VercelKvAdapterOptions, UpstashAdapterOptions, StorageType, StorageConfig, RedisErrorListenerOptions, RedisUrlConnection, RedisUrlMerge, RedisUrlSiblingFields, CreateRedisClientOptions, ErrorEmitterClient, } from './storage';
+export { createStorage, createMemoryStorage, getDetectedStorageType, createChangeFeed, DEFAULT_CHANGE_FEED_COALESCE_MS, DEFAULT_CHANGE_FEED_POLL_INTERVAL_MS, NamespacedStorageImpl, createRootStorage, createNamespacedStorage, buildPrefix, NAMESPACE_SEPARATOR, StorageError, StorageConnectionError, StorageOperationError, StorageNotSupportedError, StorageConfigError, StorageTTLError, StoragePatternError, StorageNotConnectedError, EncryptedStorageError, BaseStorageAdapter, MemoryStorageAdapter, RedisStorageAdapter, createRedisClient, VercelKvStorageAdapter, createVercelKvClient, type VercelKvConnection, UpstashStorageAdapter, FileSystemStorageAdapter, type FileSystemAdapterOptions, TypedStorage, type TypedStorageOptions, type TypedSetOptions, type TypedSetEntry, EncryptedTypedStorage, type EncryptedTypedStorageOptions, type EncryptedSetOptions, type EncryptedSetEntry, type EncryptionKey, type StoredEncryptedBlob, type ClientKeyBinding, globToRegex, matchesPattern, validatePattern, escapeGlob, MAX_TTL_SECONDS, validateTTL, validateOptionalTTL, ttlToExpiresAt, expiresAtToTTL, isExpired, normalizeTTL, attachRedisErrorListener, DEFAULT_REDIS_ERROR_LOG_INTERVAL_MS, mergeRedisUrlFields, describeRedisUrlConflicts, } from './storage';
+export type { StorageAdapter, NamespacedStorage, RootStorage, SetOptions, SetEntry, MessageHandler, Unsubscribe, MemoryAdapterOptions, RedisAdapterOptions, RedisHostConnectionConfig, RedisUrlConnectionConfig, RedisUrlFillInConfig, VercelKvAdapterOptions, UpstashAdapterOptions, SqliteAdapterOptions, StorageType, StorageConfig, RedisErrorListenerOptions, RedisUrlConnection, RedisUrlMerge, RedisUrlSiblingFields, CreateRedisClientOptions, ErrorEmitterClient, ChangeFeed, ChangeFeedKind, ChangeFeedOptions, } from './storage';
 export { processPlatformToolCalls } from './llm';
 export type { CallToolFn, OpenAIToolCallItem, OpenAIToolResponse, ClaudeToolUseBlock, ClaudeToolResultBlock, VercelToolCallInfo, PlatformToolCallsInput, PlatformToolCallsOutput, SupportedPlatform, } from './llm';
 export { getHostname, getMachineId, setMachineIdOverride } from './machine-id';