@easbot/utils 0.2.10 → 0.2.13

package/dist/index.d.ts

@@ -1,13 +1,12 @@
 import { ChildProcess } from 'node:child_process';
 import z, { z as z$1 } from 'zod';
-export { z } from 'zod';
 import { statSync } from 'node:fs';
 import * as stream from 'stream';
 import { Readable } from 'stream';
 import * as _hono_node_ws from '@hono/node-ws';
 export { createNodeWebSocket } from '@hono/node-ws';
 import * as fs from 'fs';
-import { Context as Context$1, Next, Hono } from 'hono';
+import { Hono, Context as Context$1, Next } from 'hono';
 export { Hono, Next } from 'hono';
 import { ServerType } from '@hono/node-server';
 import { cors } from 'hono/cors';
@@ -111,6 +110,20 @@ declare namespace Shell {
     function platformShells(): string[];
     function isValid(file: string): boolean;
     function version(file: string): Promise<string | undefined>;
+    interface InstallOptions {
+        cwd?: string;
+        env?: Record<string, string | undefined>;
+        timeout?: number;
+        windowsHide?: boolean;
+    }
+    class InstallFailedError extends Error {
+        message: string;
+        pkg: string;
+        version: string;
+        originalError?: string | undefined;
+        constructor(message: string, pkg: string, version: string, originalError?: string | undefined);
+    }
+    function install(pkg: string, version?: string, installPath?: string): Promise<string>;
     interface RunOptions {
         cwd?: string;
         env?: Record<string, string | undefined>;
@@ -118,18 +131,21 @@ declare namespace Shell {
         signal?: AbortSignal;
         windowsHide?: boolean;
         shell?: boolean;
+        stdin?: 'null' | 'pipe';
+        stdout?: 'pipe' | 'ignore';
+        stderr?: 'pipe' | 'ignore';
     }
-    interface SpawnOptions extends RunOptions {
-        stdout?: 'pipe' | 'inherit' | 'null';
-        stderr?: 'pipe' | 'inherit' | 'null';
+    interface SpawnOptions extends Omit<RunOptions, 'stdin' | 'stdout' | 'stderr'> {
+        stdout?: 'pipe' | 'inherit' | 'null' | 'ignore';
+        stderr?: 'pipe' | 'inherit' | 'null' | 'ignore';
         stdin?: 'pipe' | 'inherit' | 'null';
     }
-    function run(shell: string, command: string, options?: RunOptions): Promise<{
+    function run(shell: string | undefined, command: string, options?: RunOptions): Promise<{
         code: number;
         stdout: string;
         stderr: string;
     }>;
-    function spawn(shell: string, command: string, options?: SpawnOptions): {
+    function spawn(shell: string | undefined, command: string, options?: SpawnOptions): {
         stdout: any;
         stderr: any;
         stdin: any;
@@ -137,7 +153,37 @@ declare namespace Shell {
         exited: Promise<number>;
         kill: (signal?: string | number) => boolean;
     };
+    interface DollarRunOptions {
+        cwd?: string;
+        quiet?: boolean;
+        nothrow?: boolean;
+        env?: Record<string, string | undefined>;
+        stdin?: 'null' | 'pipe';
+        stdout?: 'pipe' | 'ignore';
+        stderr?: 'pipe' | 'ignore';
+        windowsHide?: boolean;
+        shell?: boolean;
+    }
+    function $(strings: TemplateStringsArray, ...values: unknown[]): {
+        quiet: () => any;
+        nothrow: () => any;
+        cwd: (dir: string) => any;
+        env: (env: Record<string, string | undefined>) => any;
+        stdin: (stdin: "null" | "pipe") => any;
+        stdout: (stdout: "pipe" | "ignore") => any;
+        stderr: (stderr: "pipe" | "ignore") => any;
+        text: () => Promise<string>;
+        lines: () => Promise<string[]>;
+        then: (onfulfilled: (result: {
+            exitCode: number;
+            stdout: Uint8Array;
+            stderr: Uint8Array;
+            text: () => string;
+            lines: () => string[];
+        }) => void, onrejected?: (error: Error) => void) => Promise<void>;
+    };
 }
+declare const $: typeof Shell.$;
 
 declare function formatLocalISO(date: Date | number, includeMilliseconds?: boolean): string;
 declare function formatLocalISOCompact(date: Date | number): string;
@@ -325,6 +371,7 @@ declare abstract class NamedError extends Error {
     };
 }
 
+declare const MIME_TYPES: Record<string, string>;
 declare namespace Filesystem {
     function mkdir(p: string, options?: {
         recursive?: boolean;
@@ -341,10 +388,14 @@ declare namespace Filesystem {
     function writeJson(p: string, data: unknown, mode?: number): Promise<void>;
     function writeStream(p: string, stream: ReadableStream<Uint8Array> | Readable, mode?: number): Promise<void>;
     function mimeType(p: string): string;
+    function dirname(p: string): string;
+    function basename(p: string, ext?: string): string;
+    function extname(p: string): string;
     function toUnixPath(p: string): string;
     function normalize(p: string): string;
-    const normalizePath: typeof normalize;
     function resolve(p: string): string;
+    function isAbsolute(p: string): boolean;
+    function join(base: string, ...paths: string[]): string;
     function windowsPath(p: string): string;
     function overlaps(a: string, b: string): boolean;
     function contains(parent: string, child: string): boolean;
@@ -845,8 +896,8 @@ interface NodeWhichOptions {
 interface NodeSpawnOptions {
     cwd?: string;
     env?: Record<string, string | undefined>;
-    stdout?: 'pipe' | 'inherit' | 'null';
-    stderr?: 'pipe' | 'inherit' | 'null';
+    stdout?: 'pipe' | 'inherit' | 'null' | 'ignore';
+    stderr?: 'pipe' | 'inherit' | 'null' | 'ignore';
     stdin?: 'pipe' | 'inherit' | 'null';
     signal?: AbortSignal;
     timeout?: number | false;
@@ -857,8 +908,8 @@ interface NodeSpawnObjectArgs {
     cmd: string[];
     cwd?: string;
     env?: Record<string, string | undefined>;
-    stdout?: 'pipe' | 'inherit' | 'null';
-    stderr?: 'pipe' | 'inherit' | 'null';
+    stdout?: 'pipe' | 'inherit' | 'null' | 'ignore';
+    stderr?: 'pipe' | 'inherit' | 'null' | 'ignore';
     stdin?: 'pipe' | 'inherit' | 'null';
     signal?: AbortSignal;
     timeout?: number | false;
@@ -875,6 +926,11 @@ interface NodeSpawnResult {
     exitCode?: number;
 }
 declare namespace PKG {
+    type PackageManager = 'npm' | 'pnpm' | 'bun';
+    function packageManager(preferred?: PackageManager): Promise<{
+        name: PackageManager;
+        path: string;
+    } | undefined>;
     function which(command?: string, options?: NodeWhichOptions): Promise<string | null>;
     function whichSync(command?: string, options?: NodeWhichOptions): string | null;
     function clearWhichCache(): void;
@@ -908,6 +964,9 @@ declare namespace PKG {
         timeout?: number;
         windowsHide?: boolean;
         shell?: boolean;
+        stdin?: 'null' | 'pipe';
+        stdout?: 'pipe' | 'ignore';
+        stderr?: 'pipe' | 'ignore';
     }): Promise<{
         code: number;
         stdout: string;
@@ -926,21 +985,6 @@ declare namespace PKG {
         stdout: string;
         stderr: string;
     }>;
-    function $(strings: TemplateStringsArray, ...values: unknown[]): {
-        quiet: () => any;
-        nothrow: () => any;
-        cwd: (dir: string) => any;
-        env: (env: Record<string, string | undefined>) => any;
-        text: () => Promise<string>;
-        lines: () => Promise<string[]>;
-        then: (onfulfilled: (result: {
-            exitCode: number;
-            stdout: Uint8Array;
-            stderr: Uint8Array;
-            text: () => string;
-            lines: () => string[];
-        }) => void, onrejected?: (error: Error) => void) => Promise<void>;
-    };
     function readableStreamToText(stream: ReadableStream<Uint8Array>): Promise<string>;
     function nodeReadableStreamToText(stream: NodeJS.ReadableStream): Promise<string>;
     function xxHash32(str: string, seed?: number): number;
@@ -964,257 +1008,6 @@ declare namespace PKG {
         }): Generator<string>;
         match(filepath: string): boolean;
     }
-    const InstallFailedError: {
-        new (data: {
-            message: string;
-            pkg: string;
-            version: string;
-            originalError?: string | undefined;
-        }, options?: ErrorOptions): {
-            readonly name: "PKGInstallFailedError";
-            readonly data: {
-                message: string;
-                pkg: string;
-                version: string;
-                originalError?: string | undefined;
-            };
-            schema(): z.ZodObject<{
-                name: z.ZodLiteral<"PKGInstallFailedError">;
-                data: z.ZodObject<{
-                    message: z.ZodString;
-                    pkg: z.ZodString;
-                    version: z.ZodString;
-                    originalError: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>;
-            }, z.core.$strip>;
-            toObject(): {
-                name: "PKGInstallFailedError";
-                data: {
-                    message: string;
-                    pkg: string;
-                    version: string;
-                    originalError?: string | undefined;
-                };
-            };
-            message: string;
-            stack?: string;
-            cause?: unknown;
-        };
-        readonly Schema: z.ZodObject<{
-            name: z.ZodLiteral<"PKGInstallFailedError">;
-            data: z.ZodObject<{
-                message: z.ZodString;
-                pkg: z.ZodString;
-                version: z.ZodString;
-                originalError: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>;
-        }, z.core.$strip>;
-        isInstance(input: any): input is {
-            readonly name: "PKGInstallFailedError";
-            readonly data: {
-                message: string;
-                pkg: string;
-                version: string;
-                originalError?: string | undefined;
-            };
-            schema(): z.ZodObject<{
-                name: z.ZodLiteral<"PKGInstallFailedError">;
-                data: z.ZodObject<{
-                    message: z.ZodString;
-                    pkg: z.ZodString;
-                    version: z.ZodString;
-                    originalError: z.ZodOptional<z.ZodString>;
-                }, z.core.$strip>;
-            }, z.core.$strip>;
-            toObject(): {
-                name: "PKGInstallFailedError";
-                data: {
-                    message: string;
-                    pkg: string;
-                    version: string;
-                    originalError?: string | undefined;
-                };
-            };
-            message: string;
-            stack?: string;
-            cause?: unknown;
-        };
-        create<Name extends string, Data extends z.core.$ZodType>(name: Name, data: Data): {
-            new (data: z.input<Data>, options?: ErrorOptions): {
-                readonly name: Name;
-                readonly data: z.core.input<Data>;
-                schema(): z.ZodObject<{
-                    name: z.ZodLiteral<Name>;
-                    data: Data;
-                }, z.core.$strip>;
-                toObject(): {
-                    name: Name;
-                    data: z.core.input<Data>;
-                };
-                message: string;
-                stack?: string;
-                cause?: unknown;
-            };
-            readonly Schema: z.ZodObject<{
-                name: z.ZodLiteral<Name>;
-                data: Data;
-            }, z.core.$strip>;
-            isInstance(input: any): input is InstanceType<any>;
-            create<Name extends string, Data extends z.core.$ZodType>(name: Name, data: Data): any;
-            readonly Unknown: {
-                new (data: {
-                    message: string;
-                }, options?: ErrorOptions): {
-                    readonly name: "UnknownError";
-                    readonly data: {
-                        message: string;
-                    };
-                    schema(): z.ZodObject<{
-                        name: z.ZodLiteral<"UnknownError">;
-                        data: z.ZodObject<{
-                            message: z.ZodString;
-                        }, z.core.$strip>;
-                    }, z.core.$strip>;
-                    toObject(): {
-                        name: "UnknownError";
-                        data: {
-                            message: string;
-                        };
-                    };
-                    message: string;
-                    stack?: string;
-                    cause?: unknown;
-                };
-                readonly Schema: z.ZodObject<{
-                    name: z.ZodLiteral<"UnknownError">;
-                    data: z.ZodObject<{
-                        message: z.ZodString;
-                    }, z.core.$strip>;
-                }, z.core.$strip>;
-                isInstance(input: any): input is {
-                    readonly name: "UnknownError";
-                    readonly data: {
-                        message: string;
-                    };
-                    schema(): z.ZodObject<{
-                        name: z.ZodLiteral<"UnknownError">;
-                        data: z.ZodObject<{
-                            message: z.ZodString;
-                        }, z.core.$strip>;
-                    }, z.core.$strip>;
-                    toObject(): {
-                        name: "UnknownError";
-                        data: {
-                            message: string;
-                        };
-                    };
-                    message: string;
-                    stack?: string;
-                    cause?: unknown;
-                };
-                create<Name extends string, Data extends z.core.$ZodType>(name: Name, data: Data): any;
-                readonly Unknown: any;
-                isError(error: unknown): error is Error;
-                captureStackTrace(targetObject: object, constructorOpt?: Function): void;
-                prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
-                stackTraceLimit: number;
-            };
-            isError(error: unknown): error is Error;
-            captureStackTrace(targetObject: object, constructorOpt?: Function): void;
-            prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
-            stackTraceLimit: number;
-        };
-        readonly Unknown: {
-            new (data: {
-                message: string;
-            }, options?: ErrorOptions): {
-                readonly name: "UnknownError";
-                readonly data: {
-                    message: string;
-                };
-                schema(): z.ZodObject<{
-                    name: z.ZodLiteral<"UnknownError">;
-                    data: z.ZodObject<{
-                        message: z.ZodString;
-                    }, z.core.$strip>;
-                }, z.core.$strip>;
-                toObject(): {
-                    name: "UnknownError";
-                    data: {
-                        message: string;
-                    };
-                };
-                message: string;
-                stack?: string;
-                cause?: unknown;
-            };
-            readonly Schema: z.ZodObject<{
-                name: z.ZodLiteral<"UnknownError">;
-                data: z.ZodObject<{
-                    message: z.ZodString;
-                }, z.core.$strip>;
-            }, z.core.$strip>;
-            isInstance(input: any): input is {
-                readonly name: "UnknownError";
-                readonly data: {
-                    message: string;
-                };
-                schema(): z.ZodObject<{
-                    name: z.ZodLiteral<"UnknownError">;
-                    data: z.ZodObject<{
-                        message: z.ZodString;
-                    }, z.core.$strip>;
-                }, z.core.$strip>;
-                toObject(): {
-                    name: "UnknownError";
-                    data: {
-                        message: string;
-                    };
-                };
-                message: string;
-                stack?: string;
-                cause?: unknown;
-            };
-            create<Name extends string, Data extends z.core.$ZodType>(name: Name, data: Data): {
-                new (data: z.input<Data>, options?: ErrorOptions): {
-                    readonly name: Name;
-                    readonly data: z.core.input<Data>;
-                    schema(): z.ZodObject<{
-                        name: z.ZodLiteral<Name>;
-                        data: Data;
-                    }, z.core.$strip>;
-                    toObject(): {
-                        name: Name;
-                        data: z.core.input<Data>;
-                    };
-                    message: string;
-                    stack?: string;
-                    cause?: unknown;
-                };
-                readonly Schema: z.ZodObject<{
-                    name: z.ZodLiteral<Name>;
-                    data: Data;
-                }, z.core.$strip>;
-                isInstance(input: any): input is InstanceType<any>;
-                create<Name extends string, Data extends z.core.$ZodType>(name: Name, data: Data): any;
-                readonly Unknown: any;
-                isError(error: unknown): error is Error;
-                captureStackTrace(targetObject: object, constructorOpt?: Function): void;
-                prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
-                stackTraceLimit: number;
-            };
-            readonly Unknown: any;
-            isError(error: unknown): error is Error;
-            captureStackTrace(targetObject: object, constructorOpt?: Function): void;
-            prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
-            stackTraceLimit: number;
-        };
-        isError(error: unknown): error is Error;
-        captureStackTrace(targetObject: object, constructorOpt?: Function): void;
-        prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
-        stackTraceLimit: number;
-    };
-    function install(pkg: string, version?: string, installPath?: string): Promise<string>;
     const stdin: NodeJS.ReadStream & {
         fd: 0;
     };
@@ -1237,7 +1030,6 @@ declare namespace PKG {
     const streamingServer: typeof createStreamingServer;
     const webSocketServer: typeof createWebSocketServer;
 }
-declare const $: typeof PKG.$;
 declare const readableStreamToText: typeof PKG.readableStreamToText;
 declare const whichSync: typeof PKG.whichSync;
 
@@ -1442,4 +1234,4 @@ declare function initLog(options: {
     level?: 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
 }): Promise<void>;
 
-export { $, Archive, AsyncQueue, Binary, type CodeSpanIndex$1 as CodeSpanIndex, Color, Context, type EasServer, Encode, EventLoop, type FenceSpan$1 as FenceSpan, Filesystem, Fn, type FormatOptions, type GitResult, Glob, Identifier, Ignore, type InlineCodeState$1 as InlineCodeState, Keybind, Lazy, Locale, Lock, Markdown, type MarkdownConfig, type MarkdownIR, type MarkdownLinkSpan, type MarkdownParseOptions, type MarkdownStyle, type MarkdownStyleSpan, type MarkdownTableMode, type MiddlewareDefinition, NamedError, type NodeSpawnObjectArgs, type NodeSpawnOptions, type NodeSpawnResult, type NodeWhichOptions, PKG, PackageRegistry, type ParseCommandResult, type ParsedFrontmatter, type ParsedVersion, PkgShell, type RPCMethod, type RenderLink, type RenderOptions, type RouteDefinition, type SSEHandler, Semver, type ServerOptions, Shell, Slug, type StreamHandler, type StyleMarker, Token, TruncateContent, type WebSocketHandler, type WebSocketRouteDefinition, Wildcard, abortAfter, abortAfterAny, buildCodeSpanIndex, chunkMarkdownIR, chunkText, chunkTextByBreakResolver, convertMarkdownTables, createInlineCodeState, createPkgShell, createRESTServer, createRPCServer, createServer, createStreamingServer, createWebSocketServer, defer, detectPlatform, escapeCommandArg, escapeCommandArgSafe, extractFrontmatter, findFenceSpanAt, findLast, fn, formatDuration, formatLocalISO, formatLocalISOCompact, formatLogTime, formatMarkdown, getDirectory, getFileExtension, getFilename, getFilenameTruncated, getTimezoneOffset, git, iife, initLog, isSafeFenceBreak, joinCommandArgs, lazy, lazyAsync, loadEnv, loadTextFile, loadTextFileAsync, markdownToIR, markdownToIRWithMeta, needsShellExecution, now, nowLocalISO, parseCommand, parseCommandWithOptions, parseFenceSpans, parseFrontmatterBlock, parseLocalISO, parseModelId, proxied, readableStreamToText, renderMarkdown, renderMarkdownWithMarkers, retry, scanParenAwareBreakpoints, serializeFrontmatter, shell, signal, startServer, truncateMiddle, updateSchema, whichSync, withTimeout, work };
+export { $, Archive, AsyncQueue, Binary, type CodeSpanIndex$1 as CodeSpanIndex, Color, Context, type EasServer, Encode, EventLoop, type FenceSpan$1 as FenceSpan, Filesystem, Fn, type FormatOptions, type GitResult, Glob, Identifier, Ignore, type InlineCodeState$1 as InlineCodeState, Keybind, Lazy, Locale, Lock, MIME_TYPES, Markdown, type MarkdownConfig, type MarkdownIR, type MarkdownLinkSpan, type MarkdownParseOptions, type MarkdownStyle, type MarkdownStyleSpan, type MarkdownTableMode, type MiddlewareDefinition, NamedError, type NodeSpawnObjectArgs, type NodeSpawnOptions, type NodeSpawnResult, type NodeWhichOptions, PKG, PackageRegistry, type ParseCommandResult, type ParsedFrontmatter, type ParsedVersion, PkgShell, type RPCMethod, type RenderLink, type RenderOptions, type RouteDefinition, type SSEHandler, Semver, type ServerOptions, Shell, Slug, type StreamHandler, type StyleMarker, Token, TruncateContent, type WebSocketHandler, type WebSocketRouteDefinition, Wildcard, abortAfter, abortAfterAny, buildCodeSpanIndex, chunkMarkdownIR, chunkText, chunkTextByBreakResolver, convertMarkdownTables, createInlineCodeState, createPkgShell, createRESTServer, createRPCServer, createServer, createStreamingServer, createWebSocketServer, defer, detectPlatform, escapeCommandArg, escapeCommandArgSafe, extractFrontmatter, findFenceSpanAt, findLast, fn, formatDuration, formatLocalISO, formatLocalISOCompact, formatLogTime, formatMarkdown, getDirectory, getFileExtension, getFilename, getFilenameTruncated, getTimezoneOffset, git, iife, initLog, isSafeFenceBreak, joinCommandArgs, lazy, lazyAsync, loadEnv, loadTextFile, loadTextFileAsync, markdownToIR, markdownToIRWithMeta, needsShellExecution, now, nowLocalISO, parseCommand, parseCommandWithOptions, parseFenceSpans, parseFrontmatterBlock, parseLocalISO, parseModelId, proxied, readableStreamToText, renderMarkdown, renderMarkdownWithMarkers, retry, scanParenAwareBreakpoints, serializeFrontmatter, shell, signal, startServer, truncateMiddle, updateSchema, whichSync, withTimeout, work };