recker 1.0.4 → 1.0.6

package/dist/types/ai.d.ts

@@ -0,0 +1,268 @@
+export type AIProvider = 'openai' | 'anthropic' | 'google' | 'replicate' | 'huggingface' | 'ollama' | 'custom';
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+export interface ChatMessage {
+    role: MessageRole;
+    content: string | ContentPart[];
+    name?: string;
+    tool_call_id?: string;
+    tool_calls?: ToolCall[];
+}
+export type ContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+} | {
+    type: 'image';
+    data: Buffer | Uint8Array;
+    mediaType: string;
+};
+export interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters?: Record<string, unknown>;
+    };
+}
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cachedTokens?: number;
+}
+export interface CostInfo {
+    inputCost: number;
+    outputCost: number;
+    totalCost: number;
+    currency: string;
+}
+export interface AILatency {
+    ttft: number;
+    tps: number;
+    total: number;
+    queued?: number;
+}
+export interface AITimeoutOptions {
+    firstToken?: number;
+    betweenTokens?: number;
+    total?: number;
+    adaptive?: boolean;
+}
+export interface AIRetryOptions {
+    on?: Array<'rate_limit' | 'overloaded' | 'timeout' | 'context_length_exceeded' | 'server_error'>;
+    backoff?: 'linear' | 'exponential' | 'decorrelated';
+    maxAttempts?: number;
+    fallback?: Record<string, string>;
+    reduceContext?: boolean;
+    onRetry?: (attempt: number, error: Error) => void;
+}
+export type ResponseFormat = {
+    type: 'text';
+} | {
+    type: 'json_object';
+} | {
+    type: 'json_schema';
+    schema: Record<string, unknown>;
+};
+export interface ChatOptions {
+    provider?: AIProvider;
+    model?: string;
+    messages: ChatMessage[];
+    systemPrompt?: string;
+    temperature?: number;
+    topP?: number;
+    maxTokens?: number;
+    stop?: string[];
+    tools?: ToolDefinition[];
+    toolChoice?: 'auto' | 'none' | 'required' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    responseFormat?: ResponseFormat;
+    timeout?: AITimeoutOptions;
+    retry?: AIRetryOptions;
+    metadata?: Record<string, unknown>;
+    signal?: AbortSignal;
+    stream?: boolean;
+}
+export interface EmbedOptions {
+    provider?: AIProvider;
+    model?: string;
+    input: string | string[];
+    dimensions?: number;
+    timeout?: number;
+    signal?: AbortSignal;
+}
+export interface AIResponse<T = string> {
+    content: T;
+    usage: TokenUsage;
+    latency: AILatency;
+    model: string;
+    provider: AIProvider;
+    cached: boolean;
+    finishReason?: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    toolCalls?: ToolCall[];
+    cost?: CostInfo;
+    raw?: unknown;
+}
+export interface EmbedResponse {
+    embeddings: number[][];
+    usage: TokenUsage;
+    model: string;
+    provider: AIProvider;
+    latency: AILatency;
+}
+export type StreamEventType = 'text' | 'tool_call' | 'tool_call_delta' | 'usage' | 'done' | 'error';
+export interface BaseStreamEvent {
+    type: StreamEventType;
+}
+export interface TextStreamEvent extends BaseStreamEvent {
+    type: 'text';
+    content: string;
+}
+export interface ToolCallStreamEvent extends BaseStreamEvent {
+    type: 'tool_call';
+    toolCall: ToolCall;
+}
+export interface ToolCallDeltaStreamEvent extends BaseStreamEvent {
+    type: 'tool_call_delta';
+    index: number;
+    delta: {
+        arguments?: string;
+    };
+}
+export interface UsageStreamEvent extends BaseStreamEvent {
+    type: 'usage';
+    usage: TokenUsage;
+}
+export interface DoneStreamEvent extends BaseStreamEvent {
+    type: 'done';
+    finishReason: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    usage?: TokenUsage;
+}
+export interface ErrorStreamEvent extends BaseStreamEvent {
+    type: 'error';
+    error: Error;
+}
+export type StreamEvent = TextStreamEvent | ToolCallStreamEvent | ToolCallDeltaStreamEvent | UsageStreamEvent | DoneStreamEvent | ErrorStreamEvent;
+export type AIStream = AsyncIterable<StreamEvent>;
+export interface ProviderConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    defaultModel?: string;
+    organization?: string;
+    projectId?: string;
+    headers?: Record<string, string>;
+}
+export interface AIClientConfig {
+    defaultProvider?: AIProvider;
+    defaultModel?: string;
+    providers?: Partial<Record<AIProvider, ProviderConfig>>;
+    timeout?: AITimeoutOptions;
+    retry?: AIRetryOptions;
+    observability?: boolean;
+    debug?: boolean;
+}
+export interface TokenRateLimitConfig {
+    tokensPerMinute?: number;
+    requestsPerMinute?: number;
+    strategy?: 'queue' | 'throw' | 'retry-after';
+    priority?: (req: ChatOptions) => 'high' | 'normal' | 'low';
+}
+export interface SemanticCacheConfig {
+    enabled?: boolean;
+    embedder?: string;
+    similarity?: number;
+    ttl?: number | string;
+    storage?: CacheStorage;
+}
+export interface CacheStorage {
+    get(key: string): Promise<unknown | undefined>;
+    set(key: string, value: unknown, ttl?: number): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+export interface AIClient {
+    chat(options: ChatOptions): Promise<AIResponse>;
+    chat(prompt: string): Promise<AIResponse>;
+    stream(options: ChatOptions): Promise<AIStream>;
+    embed(options: EmbedOptions): Promise<EmbedResponse>;
+    extend(defaults: Partial<ChatOptions>): AIClient;
+    readonly metrics: AIMetrics;
+}
+export interface AIMetrics {
+    totalRequests: number;
+    totalTokens: number;
+    totalCost: number;
+    avgLatency: {
+        ttft: number;
+        total: number;
+    };
+    errorRate: number;
+    cacheHitRate: number;
+    summary(): AIMetricsSummary;
+    reset(): void;
+}
+export interface AIMetricsSummary {
+    totalRequests: number;
+    totalTokens: number;
+    totalCost: number;
+    avgLatency: {
+        ttft: number;
+        total: number;
+    };
+    errorRate: number;
+    cacheHitRate: number;
+    byModel: Record<string, {
+        requests: number;
+        tokens: number;
+        cost: number;
+    }>;
+    byProvider: Record<string, {
+        requests: number;
+        tokens: number;
+        cost: number;
+    }>;
+}
+export interface AgentTool {
+    name: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+    handler: (args: Record<string, unknown>) => Promise<unknown> | unknown;
+}
+export interface AgentConfig {
+    provider?: AIProvider;
+    model?: string;
+    systemPrompt?: string;
+    tools?: AgentTool[];
+    maxIterations?: number;
+    iterationTimeout?: number;
+}
+export type AgentEventType = 'thinking' | 'tool_call' | 'tool_result' | 'text' | 'done' | 'error';
+export interface AgentStreamEvent {
+    type: AgentEventType;
+    content?: string;
+    tool?: string;
+    args?: Record<string, unknown>;
+    result?: unknown;
+    error?: Error;
+}
+export interface Agent {
+    run(prompt: string): Promise<AIResponse>;
+    stream(prompt: string): AsyncIterable<AgentStreamEvent>;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/types/ai.d.ts.map

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

package/dist/types/ai.js

@@ -0,0 +1 @@
+export {};

package/dist/types/udp.d.ts

@@ -0,0 +1,138 @@
+import type { ReckerRequest, ReckerResponse, Transport } from './index.js';
+export interface UDPTimings {
+    queued: number;
+    send: number;
+    receive: number;
+    retransmissions: number;
+    total: number;
+}
+export interface DTLSTimings extends UDPTimings {
+    handshake: number;
+}
+export interface QUICTimings extends UDPTimings {
+    quicHandshake: number;
+    streamOpen: number;
+    firstByte: number;
+    zeroRTT: boolean;
+}
+export interface UDPConnection {
+    protocol: 'udp' | 'dtls' | 'quic';
+    localAddress: string;
+    localPort: number;
+    remoteAddress: string;
+    remotePort: number;
+}
+export interface DTLSConnection extends UDPConnection {
+    protocol: 'dtls';
+    cipher: string;
+    version: string;
+}
+export interface QUICConnection extends UDPConnection {
+    protocol: 'quic';
+    alpn: string;
+    congestion: 'bbr' | 'cubic' | 'reno';
+    quicVersion: string;
+    migrated: boolean;
+}
+export interface BaseUDPTransportOptions {
+    timeout?: number;
+    retransmissions?: number;
+    maxPacketSize?: number;
+    observability?: boolean;
+    localAddress?: string;
+    localPort?: number;
+}
+export interface UDPTransportOptions extends BaseUDPTransportOptions {
+    broadcast?: boolean;
+    multicastTTL?: number;
+    multicastGroups?: string[];
+    multicastLoopback?: boolean;
+    type?: 'udp4' | 'udp6';
+    recvBufferSize?: number;
+    sendBufferSize?: number;
+}
+export interface DTLSTransportOptions extends BaseUDPTransportOptions {
+    cert?: string | Buffer;
+    key?: string | Buffer;
+    ca?: string | Buffer | Array<string | Buffer>;
+    passphrase?: string;
+    ciphers?: string;
+    minVersion?: 'DTLSv1.0' | 'DTLSv1.2';
+    rejectUnauthorized?: boolean;
+    servername?: string;
+    handshakeTimeout?: number;
+    mtu?: number;
+}
+export interface QUICTransportOptions extends BaseUDPTransportOptions {
+    maxStreams?: number;
+    idleTimeout?: number;
+    congestionControl?: 'bbr' | 'cubic' | 'reno';
+    earlyData?: boolean;
+    sessionCache?: Map<string, Buffer>;
+    cert?: string | Buffer;
+    key?: string | Buffer;
+    ca?: string | Buffer | Array<string | Buffer>;
+    alpnProtocols?: string[];
+    initialRtt?: number;
+    connectionMigration?: boolean;
+}
+export interface UDPRequestOptions {
+    broadcast?: boolean;
+    multicast?: string;
+    ttl?: number;
+    port?: number;
+}
+export interface UDPRequest extends ReckerRequest {
+    udp?: UDPRequestOptions;
+}
+export interface UDPResponse<T = unknown> extends ReckerResponse<T> {
+    timings: UDPTimings;
+    connection: UDPConnection;
+    buffer(): Promise<Buffer>;
+    packets(): AsyncGenerator<Buffer>;
+}
+export interface UDPTransport extends Transport {
+    dispatch(req: UDPRequest): Promise<UDPResponse>;
+    send(host: string, port: number, data: Buffer): Promise<void>;
+    broadcast(port: number, data: Buffer): Promise<void>;
+    joinMulticast(group: string): void;
+    leaveMulticast(group: string): void;
+    close(): Promise<void>;
+}
+export interface DTLSTransportInterface extends Transport {
+    dispatch(req: UDPRequest): Promise<UDPResponse>;
+    handshake(): Promise<void>;
+    getSession(): Buffer | null;
+    close(): Promise<void>;
+}
+export interface QUICTransportInterface extends Transport {
+    dispatch(req: ReckerRequest): Promise<ReckerResponse>;
+    getSessionTicket(): Buffer | null;
+    migrate(newLocalAddress: string): Promise<void>;
+    close(): Promise<void>;
+}
+export interface UDPBatchResult<T> {
+    results: Array<T | Error>;
+    stats: {
+        total: number;
+        successful: number;
+        failed: number;
+        duration: number;
+    };
+}
+export interface UDPDiscoveryResult {
+    address: string;
+    port: number;
+    data: Buffer;
+    latency: number;
+}
+export interface SimpleUDPAPI {
+    send(address: string, data: Buffer, options?: UDPTransportOptions): Promise<UDPResponse>;
+    broadcast(port: number, data: Buffer, options?: UDPTransportOptions & {
+        timeout?: number;
+    }): Promise<UDPDiscoveryResult[]>;
+    discover(group: string, port: number, data: Buffer, options?: UDPTransportOptions & {
+        timeout?: number;
+    }): Promise<UDPDiscoveryResult[]>;
+}
+//# sourceMappingURL=udp.d.ts.map

package/dist/types/udp.d.ts.map

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

package/dist/types/udp.js

@@ -0,0 +1 @@
+export {};

package/dist/udp/index.d.ts

@@ -0,0 +1,6 @@
+export { UDPTransport, UDPTransportImpl, createUDPClient, udp } from '../transport/udp.js';
+export { UDPResponseImpl, StreamingUDPResponse } from '../transport/udp-response.js';
+export { BaseUDPTransport, udpRequestStorage } from '../transport/base-udp.js';
+export type { UDPRequestContext } from '../transport/base-udp.js';
+export type { UDPTimings, DTLSTimings, QUICTimings, UDPConnection, DTLSConnection, QUICConnection, BaseUDPTransportOptions, UDPTransportOptions, DTLSTransportOptions, QUICTransportOptions, UDPRequestOptions, UDPRequest, UDPResponse, UDPTransport as UDPTransportInterface, DTLSTransportInterface, QUICTransportInterface, UDPBatchResult, UDPDiscoveryResult, SimpleUDPAPI, } from '../types/udp.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/udp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/udp/index.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAG3F,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGrF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,YAAY,EAEV,UAAU,EACV,WAAW,EACX,WAAW,EAEX,aAAa,EACb,cAAc,EACd,cAAc,EAEd,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EAEpB,iBAAiB,EACjB,UAAU,EACV,WAAW,EAEX,YAAY,IAAI,qBAAqB,EACrC,sBAAsB,EACtB,sBAAsB,EAEtB,cAAc,EACd,kBAAkB,EAClB,YAAY,GACb,MAAM,iBAAiB,CAAC"}

package/dist/udp/index.js

@@ -0,0 +1,3 @@
+export { UDPTransport, UDPTransportImpl, createUDPClient, udp } from '../transport/udp.js';
+export { UDPResponseImpl, StreamingUDPResponse } from '../transport/udp-response.js';
+export { BaseUDPTransport, udpRequestStorage } from '../transport/base-udp.js';

package/dist/utils/chart.d.ts

@@ -0,0 +1,15 @@
+export interface ChartOptions {
+    height?: number;
+    padding?: string;
+    min?: number;
+    max?: number;
+    format?: (value: number) => string;
+}
+export declare function plot(series: number[], options?: ChartOptions): string;
+export declare function plotMultiple(seriesList: number[][], options?: ChartOptions): string;
+declare const _default: {
+    plot: typeof plot;
+    plotMultiple: typeof plotMultiple;
+};
+export default _default;
+//# sourceMappingURL=chart.d.ts.map

package/dist/utils/chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../src/utils/chart.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAE3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACpC;AA4BD,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,MAAM,CAyFzE;AAKD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAAE,EAAE,EACtB,OAAO,GAAE,YAAiB,GACzB,MAAM,CAqBR;;;;;AAED,wBAGE"}

package/dist/utils/chart.js

@@ -0,0 +1,94 @@
+const CHARS = {
+    empty: ' ',
+    axis: '┤',
+    horizontal: '─',
+    vertical: '│',
+    point: '●',
+    lineHorizontal: '─',
+    lineUp: '╯',
+    lineDown: '╮',
+    lineUpDown: '│',
+    lineStart: '┼',
+};
+export function plot(series, options = {}) {
+    if (!series || series.length === 0) {
+        return '';
+    }
+    const height = options.height ?? 10;
+    const padding = options.padding ?? '        ';
+    const format = options.format ?? ((v) => v.toFixed(2).padStart(8));
+    const validSeries = series.filter((v) => !isNaN(v) && isFinite(v));
+    if (validSeries.length === 0) {
+        return '';
+    }
+    let min = options.min ?? Math.min(...validSeries);
+    let max = options.max ?? Math.max(...validSeries);
+    if (min === max) {
+        max = min + 1;
+        min = min - 1;
+    }
+    const range = max - min;
+    const scale = height / range;
+    const rows = height + 1;
+    const cols = series.length;
+    const grid = Array.from({ length: rows }, () => Array(cols).fill(CHARS.empty));
+    for (let x = 0; x < series.length; x++) {
+        const value = series[x];
+        if (isNaN(value) || !isFinite(value))
+            continue;
+        const y = Math.round((max - value) * scale);
+        const clampedY = Math.max(0, Math.min(rows - 1, y));
+        grid[clampedY][x] = '─';
+        if (x > 0) {
+            const prevValue = series[x - 1];
+            if (!isNaN(prevValue) && isFinite(prevValue)) {
+                const prevY = Math.round((max - prevValue) * scale);
+                const clampedPrevY = Math.max(0, Math.min(rows - 1, prevY));
+                if (clampedPrevY < clampedY) {
+                    grid[clampedPrevY][x] = '╮';
+                    grid[clampedY][x] = '╰';
+                    for (let i = clampedPrevY + 1; i < clampedY; i++) {
+                        grid[i][x] = '│';
+                    }
+                }
+                else if (clampedPrevY > clampedY) {
+                    grid[clampedPrevY][x] = '╯';
+                    grid[clampedY][x] = '╭';
+                    for (let i = clampedY + 1; i < clampedPrevY; i++) {
+                        grid[i][x] = '│';
+                    }
+                }
+            }
+        }
+    }
+    const lines = [];
+    for (let row = 0; row < rows; row++) {
+        const value = max - (row / height) * range;
+        const label = format(value);
+        const axis = row === 0 || row === rows - 1 || row === Math.floor(rows / 2)
+            ? CHARS.axis
+            : CHARS.axis;
+        lines.push(`${label} ${axis}${grid[row].join('')}`);
+    }
+    return lines.join('\n');
+}
+export function plotMultiple(seriesList, options = {}) {
+    if (!seriesList || seriesList.length === 0) {
+        return '';
+    }
+    const allValues = seriesList.flat().filter((v) => !isNaN(v) && isFinite(v));
+    if (allValues.length === 0) {
+        return '';
+    }
+    const globalMin = Math.min(...allValues);
+    const globalMax = Math.max(...allValues);
+    return plot(seriesList[0], {
+        ...options,
+        min: globalMin,
+        max: globalMax,
+    });
+}
+export default {
+    plot,
+    plotMultiple,
+};

package/dist/utils/colors.d.ts

@@ -0,0 +1,27 @@
+export declare const reset: (s: string) => string;
+export declare const bold: (s: string | number) => string;
+export declare const black: (s: string | number) => string;
+export declare const red: (s: string | number) => string;
+export declare const green: (s: string | number) => string;
+export declare const yellow: (s: string | number) => string;
+export declare const blue: (s: string | number) => string;
+export declare const magenta: (s: string | number) => string;
+export declare const cyan: (s: string | number) => string;
+export declare const white: (s: string | number) => string;
+export declare const gray: (s: string | number) => string;
+declare const colors: {
+    reset: (s: string) => string;
+    bold: (s: string | number) => string;
+    black: (s: string | number) => string;
+    red: (s: string | number) => string;
+    green: (s: string | number) => string;
+    yellow: (s: string | number) => string;
+    blue: (s: string | number) => string;
+    magenta: (s: string | number) => string;
+    cyan: (s: string | number) => string;
+    white: (s: string | number) => string;
+    gray: (s: string | number) => string;
+    grey: (s: string | number) => string;
+};
+export default colors;
+//# sourceMappingURL=colors.d.ts.map

package/dist/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"AA6CA,eAAO,MAAM,KAAK,MAAmB,MAAM,WAA4C,CAAC;AACxF,eAAO,MAAM,IAAI,MAfY,MAAM,GAAG,MAAM,WAeb,CAAC;AAGhC,eAAO,MAAM,KAAK,MAlBW,MAAM,GAAG,MAAM,WAkBX,CAAC;AAClC,eAAO,MAAM,GAAG,MAnBa,MAAM,GAAG,MAAM,WAmBb,CAAC;AAChC,eAAO,MAAM,KAAK,MApBW,MAAM,GAAG,MAAM,WAoBX,CAAC;AAClC,eAAO,MAAM,MAAM,MArBU,MAAM,GAAG,MAAM,WAqBV,CAAC;AACnC,eAAO,MAAM,IAAI,MAtBY,MAAM,GAAG,MAAM,WAsBZ,CAAC;AACjC,eAAO,MAAM,OAAO,MAvBS,MAAM,GAAG,MAAM,WAuBT,CAAC;AACpC,eAAO,MAAM,IAAI,MAxBY,MAAM,GAAG,MAAM,WAwBZ,CAAC;AACjC,eAAO,MAAM,KAAK,MAzBW,MAAM,GAAG,MAAM,WAyBX,CAAC;AAClC,eAAO,MAAM,IAAI,MA1BY,MAAM,GAAG,MAAM,WA0BZ,CAAC;AAGjC,QAAA,MAAM,MAAM;eAfyB,MAAM;cAdd,MAAM,GAAG,MAAM;eAAf,MAAM,GAAG,MAAM;aAAf,MAAM,GAAG,MAAM;eAAf,MAAM,GAAG,MAAM;gBAAf,MAAM,GAAG,MAAM;cAAf,MAAM,GAAG,MAAM;iBAAf,MAAM,GAAG,MAAM;cAAf,MAAM,GAAG,MAAM;eAAf,MAAM,GAAG,MAAM;cAAf,MAAM,GAAG,MAAM;cAAf,MAAM,GAAG,MAAM;CA2C3C,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/utils/colors.js

@@ -0,0 +1,50 @@
+const hasColors = (() => {
+    if ('NO_COLOR' in process.env)
+        return false;
+    if ('FORCE_COLOR' in process.env)
+        return true;
+    if (process.env.TERM === 'dumb')
+        return false;
+    if (process.stdout?.isTTY)
+        return true;
+    if (process.env.CI)
+        return true;
+    return false;
+})();
+const code = (open, close) => {
+    if (!hasColors)
+        return (s) => String(s);
+    const openCode = `\x1b[${open}m`;
+    const closeCode = `\x1b[${close}m`;
+    return (s) => {
+        const str = String(s);
+        const closeRe = new RegExp(`\\x1b\\[${close}m`, 'g');
+        return openCode + str.replace(closeRe, openCode) + closeCode;
+    };
+};
+export const reset = hasColors ? (s) => `\x1b[0m${s}\x1b[0m` : (s) => s;
+export const bold = code(1, 22);
+export const black = code(30, 39);
+export const red = code(31, 39);
+export const green = code(32, 39);
+export const yellow = code(33, 39);
+export const blue = code(34, 39);
+export const magenta = code(35, 39);
+export const cyan = code(36, 39);
+export const white = code(37, 39);
+export const gray = code(90, 39);
+const colors = {
+    reset,
+    bold,
+    black,
+    red,
+    green,
+    yellow,
+    blue,
+    magenta,
+    cyan,
+    white,
+    gray,
+    grey: gray,
+};
+export default colors;

package/dist/utils/optional-require.d.ts

@@ -0,0 +1,20 @@
+interface DependencyInfo {
+    package: string;
+    submodule: string;
+    version?: string;
+    feature?: string;
+}
+export declare const OPTIONAL_DEPENDENCIES: Record<string, DependencyInfo>;
+export declare class MissingDependencyError extends Error {
+    readonly packageName: string;
+    readonly submodule: string;
+    readonly installCommand: string;
+    constructor(packageName: string, submodule: string, installCommand: string);
+}
+export declare function clearModuleCache(): void;
+export declare function requireOptional<T = unknown>(packageName: string, submodule?: string): Promise<T>;
+export declare function isPackageAvailable(packageName: string): boolean;
+export declare function getInstallCommand(packages: string[]): string;
+export declare function requireOptionalMany<T extends Record<string, unknown>>(packages: string[], submodule: string): Promise<T>;
+export {};
+//# sourceMappingURL=optional-require.d.ts.map

package/dist/utils/optional-require.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-require.d.ts","sourceRoot":"","sources":["../../src/utils/optional-require.ts"],"names":[],"mappings":"AAgBA,UAAU,cAAc;IAEtB,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAgChE,CAAC;AAKF,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,WAAW,EAAE,MAAM;aACnB,SAAS,EAAE,MAAM;aACjB,cAAc,EAAE,MAAM;gBAFtB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM;CASzC;AAWD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAiBD,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAgCZ;AAQD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAO/D;AAQD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAM5D;AAiBD,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzE,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAyBZ"}