promptspeak-mcp-server 0.1.0

package/dist/core/result/builders.js

@@ -0,0 +1,454 @@
+/**
+ * ===============================================================================
+ * RESULT BUILDERS AND UTILITIES
+ * ===============================================================================
+ *
+ * Fluent builders for creating Result types, type guards, and utility functions
+ * for working with Result values.
+ *
+ * ===============================================================================
+ */
+// -----------------------------------------------------------------------------
+// RESULT BUILDERS
+// -----------------------------------------------------------------------------
+/**
+ * Creates a Success result with the given data.
+ *
+ * @param data - The successful result data
+ * @param metadata - Optional metadata about the operation
+ * @returns A Success result
+ *
+ * @example
+ * ```typescript
+ * const result = success({ id: 1, name: 'Alice' });
+ * // result.success === true
+ * // result.data === { id: 1, name: 'Alice' }
+ * ```
+ */
+export function success(data, metadata) {
+    return {
+        success: true,
+        data,
+        metadata: metadata ? { ...metadata, timestamp: metadata.timestamp ?? Date.now() } : undefined,
+    };
+}
+/**
+ * Creates a Failure result with the given error information.
+ *
+ * @param code - Machine-readable error code
+ * @param message - Human-readable error message
+ * @param options - Additional error options
+ * @returns A Failure result
+ *
+ * @example
+ * ```typescript
+ * const result = failure('NOT_FOUND', 'User not found', { details: { userId: 123 } });
+ * // result.success === false
+ * // result.error.code === 'NOT_FOUND'
+ * ```
+ */
+export function failure(code, message, options) {
+    return {
+        success: false,
+        error: {
+            code,
+            message,
+            details: options?.details,
+            retryable: options?.retryable,
+            retryAfterMs: options?.retryAfterMs,
+            cause: options?.cause,
+        },
+        metadata: options?.metadata
+            ? { ...options.metadata, timestamp: options.metadata.timestamp ?? Date.now() }
+            : { timestamp: Date.now() },
+    };
+}
+/**
+ * Creates a Failure result from an Error object.
+ * Extracts code and details if available (e.g., from PromptSpeakError).
+ *
+ * @param error - The error to convert
+ * @param defaultCode - Default error code if none is present on the error
+ * @returns A Failure result
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await riskyOperation();
+ * } catch (err) {
+ *   return fromError(err);
+ * }
+ * ```
+ */
+export function fromError(error, defaultCode = 'UNKNOWN_ERROR') {
+    if (error instanceof Error) {
+        const codedError = error;
+        return failure(codedError.code ?? defaultCode, error.message, {
+            details: codedError.details,
+            retryable: codedError.retryable,
+        });
+    }
+    // Handle non-Error values
+    return failure(defaultCode, String(error));
+}
+/**
+ * Wraps a Promise to return a Result instead of throwing.
+ *
+ * @param promise - The promise to wrap
+ * @param errorCode - Error code to use if the promise rejects
+ * @returns A Promise that resolves to a Result
+ *
+ * @example
+ * ```typescript
+ * const result = await fromPromise(fetchUser(id), 'FETCH_USER_FAILED');
+ * if (isSuccess(result)) {
+ *   console.log(result.data);
+ * }
+ * ```
+ */
+export async function fromPromise(promise, errorCode = 'PROMISE_REJECTED') {
+    const startTime = Date.now();
+    try {
+        const data = await promise;
+        return success(data, { executionTimeMs: Date.now() - startTime });
+    }
+    catch (error) {
+        const result = fromError(error, errorCode);
+        result.metadata = {
+            ...result.metadata,
+            executionTimeMs: Date.now() - startTime,
+        };
+        return result;
+    }
+}
+/**
+ * Wraps a synchronous function to return a Result instead of throwing.
+ *
+ * @param fn - The function to wrap
+ * @param errorCode - Error code to use if the function throws
+ * @returns A Result
+ *
+ * @example
+ * ```typescript
+ * const result = fromThrowable(() => JSON.parse(jsonString), 'PARSE_FAILED');
+ * ```
+ */
+export function fromThrowable(fn, errorCode = 'EXECUTION_FAILED') {
+    const startTime = Date.now();
+    try {
+        const data = fn();
+        return success(data, { executionTimeMs: Date.now() - startTime });
+    }
+    catch (error) {
+        const result = fromError(error, errorCode);
+        result.metadata = {
+            ...result.metadata,
+            executionTimeMs: Date.now() - startTime,
+        };
+        return result;
+    }
+}
+// -----------------------------------------------------------------------------
+// TYPE GUARDS
+// -----------------------------------------------------------------------------
+/**
+ * Type guard to check if a Result is a Success.
+ *
+ * @param result - The result to check
+ * @returns True if the result is a Success
+ *
+ * @example
+ * ```typescript
+ * if (isSuccess(result)) {
+ *   // TypeScript knows result.data exists
+ *   console.log(result.data);
+ * }
+ * ```
+ */
+export function isSuccess(result) {
+    return result.success === true;
+}
+/**
+ * Type guard to check if a Result is a Failure.
+ *
+ * @param result - The result to check
+ * @returns True if the result is a Failure
+ *
+ * @example
+ * ```typescript
+ * if (isFailure(result)) {
+ *   // TypeScript knows result.error exists
+ *   console.error(result.error.message);
+ * }
+ * ```
+ */
+export function isFailure(result) {
+    return result.success === false;
+}
+/**
+ * Type guard to check if an error is retryable.
+ *
+ * @param result - The failure result to check
+ * @returns True if the operation can be retried
+ */
+export function isRetryable(result) {
+    return result.error.retryable === true;
+}
+// -----------------------------------------------------------------------------
+// UNWRAP UTILITIES
+// -----------------------------------------------------------------------------
+/**
+ * Error thrown when unwrapping a Failure result.
+ */
+export class UnwrapError extends Error {
+    error;
+    constructor(error) {
+        super(`Unwrap failed: ${error.code} - ${error.message}`);
+        this.name = 'UnwrapError';
+        this.error = error;
+    }
+}
+/**
+ * Extracts the data from a Success result.
+ * Throws UnwrapError if the result is a Failure.
+ *
+ * @param result - The result to unwrap
+ * @returns The success data
+ * @throws UnwrapError if the result is a Failure
+ *
+ * @example
+ * ```typescript
+ * const user = unwrap(result);  // Throws if result is Failure
+ * ```
+ */
+export function unwrap(result) {
+    if (isSuccess(result)) {
+        return result.data;
+    }
+    throw new UnwrapError(result.error);
+}
+/**
+ * Extracts the data from a Success result, or returns a default value.
+ *
+ * @param result - The result to unwrap
+ * @param defaultValue - Value to return if result is Failure
+ * @returns The success data or the default value
+ *
+ * @example
+ * ```typescript
+ * const user = unwrapOr(result, defaultUser);
+ * ```
+ */
+export function unwrapOr(result, defaultValue) {
+    if (isSuccess(result)) {
+        return result.data;
+    }
+    return defaultValue;
+}
+/**
+ * Extracts the data from a Success result, or computes a default lazily.
+ *
+ * @param result - The result to unwrap
+ * @param defaultFn - Function that returns the default value
+ * @returns The success data or the computed default value
+ *
+ * @example
+ * ```typescript
+ * const user = unwrapOrElse(result, () => createDefaultUser());
+ * ```
+ */
+export function unwrapOrElse(result, defaultFn) {
+    if (isSuccess(result)) {
+        return result.data;
+    }
+    return defaultFn();
+}
+/**
+ * Extracts the error from a Failure result.
+ * Throws if the result is a Success.
+ *
+ * @param result - The result to unwrap
+ * @returns The error
+ * @throws Error if the result is a Success
+ */
+export function unwrapError(result) {
+    if (isFailure(result)) {
+        return result.error;
+    }
+    throw new Error('Cannot unwrapError on a Success result');
+}
+// -----------------------------------------------------------------------------
+// TRANSFORMATION UTILITIES
+// -----------------------------------------------------------------------------
+/**
+ * Maps a Success value to a new value using the provided function.
+ * If the result is a Failure, returns the Failure unchanged.
+ *
+ * @param result - The result to map
+ * @param fn - Function to transform the success data
+ * @returns A new Result with the transformed data
+ *
+ * @example
+ * ```typescript
+ * const nameResult = map(userResult, user => user.name);
+ * ```
+ */
+export function map(result, fn) {
+    if (isSuccess(result)) {
+        return success(fn(result.data), result.metadata);
+    }
+    return result;
+}
+/**
+ * Maps a Failure error to a new error using the provided function.
+ * If the result is a Success, returns the Success unchanged.
+ *
+ * @param result - The result to map
+ * @param fn - Function to transform the error
+ * @returns A new Result with the transformed error
+ */
+export function mapError(result, fn) {
+    if (isFailure(result)) {
+        return { ...result, error: fn(result.error) };
+    }
+    return result;
+}
+/**
+ * Chains a Result with a function that returns another Result.
+ * Also known as flatMap or bind.
+ *
+ * @param result - The result to chain
+ * @param fn - Function that takes the success data and returns a new Result
+ * @returns The chained Result
+ *
+ * @example
+ * ```typescript
+ * const result = flatMap(userResult, user => fetchPosts(user.id));
+ * ```
+ */
+export function flatMap(result, fn) {
+    if (isSuccess(result)) {
+        return fn(result.data);
+    }
+    return result;
+}
+/**
+ * Async version of flatMap for chaining async operations.
+ *
+ * @param result - The result to chain
+ * @param fn - Async function that takes the success data and returns a new Result
+ * @returns A Promise that resolves to the chained Result
+ */
+export async function flatMapAsync(result, fn) {
+    if (isSuccess(result)) {
+        return fn(result.data);
+    }
+    return result;
+}
+/**
+ * Applies one of two functions depending on success/failure.
+ *
+ * @param result - The result to match
+ * @param onSuccess - Function to call with success data
+ * @param onFailure - Function to call with error
+ * @returns The return value of the matched function
+ *
+ * @example
+ * ```typescript
+ * const message = match(
+ *   result,
+ *   user => `Hello, ${user.name}!`,
+ *   error => `Error: ${error.message}`
+ * );
+ * ```
+ */
+export function match(result, onSuccess, onFailure) {
+    if (isSuccess(result)) {
+        return onSuccess(result.data);
+    }
+    return onFailure(result.error);
+}
+// -----------------------------------------------------------------------------
+// COMBINATION UTILITIES
+// -----------------------------------------------------------------------------
+/**
+ * Combines multiple Results into a single Result containing an array.
+ * If any Result is a Failure, returns the first Failure.
+ *
+ * @param results - Array of Results to combine
+ * @returns A Result containing an array of all success values
+ *
+ * @example
+ * ```typescript
+ * const combined = all([result1, result2, result3]);
+ * if (isSuccess(combined)) {
+ *   const [a, b, c] = combined.data;
+ * }
+ * ```
+ */
+export function all(results) {
+    const data = [];
+    for (const result of results) {
+        if (isFailure(result)) {
+            return result;
+        }
+        data.push(result.data);
+    }
+    return success(data);
+}
+/**
+ * Combines multiple Results, collecting all successes and failures.
+ * Unlike `all`, this processes all results even if some fail.
+ *
+ * @param results - Array of Results to partition
+ * @returns Object containing arrays of successes and failures
+ */
+export function partition(results) {
+    const successes = [];
+    const failures = [];
+    for (const result of results) {
+        if (isSuccess(result)) {
+            successes.push(result.data);
+        }
+        else {
+            failures.push(result);
+        }
+    }
+    return { successes, failures };
+}
+// -----------------------------------------------------------------------------
+// LEGACY COMPATIBILITY
+// -----------------------------------------------------------------------------
+/**
+ * Converts a legacy result format to the new Result type.
+ *
+ * @param legacy - Legacy result object
+ * @param dataKey - Key to extract data from (default: 'data')
+ * @returns A proper Result type
+ *
+ * @example
+ * ```typescript
+ * const legacyResult = { success: true, user: { id: 1 } };
+ * const result = fromLegacy(legacyResult, 'user');
+ * ```
+ */
+export function fromLegacy(legacy, dataKey = 'data') {
+    if (legacy.success) {
+        const data = (legacy[dataKey] ?? legacy.data);
+        return success(data);
+    }
+    return failure('LEGACY_ERROR', legacy.error ?? 'Unknown error', { details: { originalResult: legacy } });
+}
+/**
+ * Converts a Result to the legacy format for backward compatibility.
+ *
+ * @param result - The Result to convert
+ * @returns A legacy result object
+ */
+export function toLegacy(result) {
+    if (isSuccess(result)) {
+        return { success: true, data: result.data };
+    }
+    return { success: false, error: result.error.message };
+}
+//# sourceMappingURL=builders.js.map

package/dist/core/result/builders.js.map

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

package/dist/core/result/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * ===============================================================================
+ * RESULT MODULE - UNIFIED RESULT PATTERN
+ * ===============================================================================
+ *
+ * This module provides a type-safe Result<T> pattern for operations that can fail.
+ * It replaces inconsistent { success, error?, data? } patterns throughout the
+ * codebase with a properly typed discriminated union.
+ *
+ * Key Features:
+ * - Type-safe success/failure discrimination via `success` discriminant
+ * - Fluent builders for creating results
+ * - Type guards for narrowing (isSuccess, isFailure)
+ * - Utility functions for unwrapping, mapping, and chaining
+ * - Batch operation support with timing and summary statistics
+ * - Legacy compatibility for gradual migration
+ *
+ * Usage:
+ * ```typescript
+ * import { success, failure, isSuccess, Result } from './core/result/index.js';
+ *
+ * async function fetchUser(id: string): Promise<Result<User>> {
+ *   try {
+ *     const user = await db.findUser(id);
+ *     if (!user) {
+ *       return failure('NOT_FOUND', `User ${id} not found`);
+ *     }
+ *     return success(user);
+ *   } catch (err) {
+ *     return fromError(err, 'FETCH_FAILED');
+ *   }
+ * }
+ *
+ * // Usage
+ * const result = await fetchUser('123');
+ * if (isSuccess(result)) {
+ *   console.log(result.data.name);  // TypeScript knows data exists
+ * } else {
+ *   console.error(result.error.message);  // TypeScript knows error exists
+ * }
+ * ```
+ *
+ * ===============================================================================
+ */
+export type { Result, Success, Failure, ResultMetadata, ResultError, BatchResult, BatchResultEntry, BatchSummary, AsyncResult, AsyncBatchResult, LegacyResult, } from './types.js';
+export { success, failure, fromError, fromPromise, fromThrowable, isSuccess, isFailure, isRetryable, unwrap, unwrapOr, unwrapOrElse, unwrapError, UnwrapError, map, mapError, flatMap, flatMapAsync, match, all, partition, fromLegacy, toLegacy, } from './builders.js';
+export { createBatchResult, runBatch, runBatchSync, extractSuccesses, extractFailures, getResultByKey, toResultMap, filterByKeys, mergeBatchResults, retryFailed, batchBuilder, BatchBuilder, } from './batch.js';
+export type { BatchExecutionOptions } from './batch.js';
+export { toMcpResult, mcpSuccess, mcpFailure, mcpLegacyFailure, mcpFromError, mcpBatchResult, fromLegacyResponse, wrapToolHandler, wrapToolHandlerSync, } from './mcp-adapter.js';
+export type { McpResponseOptions, McpSuccessPayload, McpErrorPayload, LegacyToolResponse, } from './mcp-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/result/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/result/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAMH,YAAY,EAEV,MAAM,EACN,OAAO,EACP,OAAO,EACP,cAAc,EACd,WAAW,EAGX,WAAW,EACX,gBAAgB,EAChB,YAAY,EAGZ,WAAW,EACX,gBAAgB,EAGhB,YAAY,GACb,MAAM,YAAY,CAAC;AAMpB,OAAO,EAEL,OAAO,EACP,OAAO,EACP,SAAS,EACT,WAAW,EACX,aAAa,EAGb,SAAS,EACT,SAAS,EACT,WAAW,EAGX,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,WAAW,EAGX,GAAG,EACH,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,KAAK,EAGL,GAAG,EACH,SAAS,EAGT,UAAU,EACV,QAAQ,GACT,MAAM,eAAe,CAAC;AAMvB,OAAO,EAEL,iBAAiB,EAGjB,QAAQ,EACR,YAAY,EAGZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,WAAW,EAGX,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAMxD,OAAO,EAEL,WAAW,EACX,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EAGd,kBAAkB,EAGlB,eAAe,EACf,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/core/result/index.js

@@ -0,0 +1,83 @@
+/**
+ * ===============================================================================
+ * RESULT MODULE - UNIFIED RESULT PATTERN
+ * ===============================================================================
+ *
+ * This module provides a type-safe Result<T> pattern for operations that can fail.
+ * It replaces inconsistent { success, error?, data? } patterns throughout the
+ * codebase with a properly typed discriminated union.
+ *
+ * Key Features:
+ * - Type-safe success/failure discrimination via `success` discriminant
+ * - Fluent builders for creating results
+ * - Type guards for narrowing (isSuccess, isFailure)
+ * - Utility functions for unwrapping, mapping, and chaining
+ * - Batch operation support with timing and summary statistics
+ * - Legacy compatibility for gradual migration
+ *
+ * Usage:
+ * ```typescript
+ * import { success, failure, isSuccess, Result } from './core/result/index.js';
+ *
+ * async function fetchUser(id: string): Promise<Result<User>> {
+ *   try {
+ *     const user = await db.findUser(id);
+ *     if (!user) {
+ *       return failure('NOT_FOUND', `User ${id} not found`);
+ *     }
+ *     return success(user);
+ *   } catch (err) {
+ *     return fromError(err, 'FETCH_FAILED');
+ *   }
+ * }
+ *
+ * // Usage
+ * const result = await fetchUser('123');
+ * if (isSuccess(result)) {
+ *   console.log(result.data.name);  // TypeScript knows data exists
+ * } else {
+ *   console.error(result.error.message);  // TypeScript knows error exists
+ * }
+ * ```
+ *
+ * ===============================================================================
+ */
+// -----------------------------------------------------------------------------
+// BUILDER EXPORTS
+// -----------------------------------------------------------------------------
+export { 
+// Result constructors
+success, failure, fromError, fromPromise, fromThrowable, 
+// Type guards
+isSuccess, isFailure, isRetryable, 
+// Unwrap utilities
+unwrap, unwrapOr, unwrapOrElse, unwrapError, UnwrapError, 
+// Transformation utilities
+map, mapError, flatMap, flatMapAsync, match, 
+// Combination utilities
+all, partition, 
+// Legacy compatibility
+fromLegacy, toLegacy, } from './builders.js';
+// -----------------------------------------------------------------------------
+// BATCH EXPORTS
+// -----------------------------------------------------------------------------
+export { 
+// Batch creation
+createBatchResult, 
+// Batch execution
+runBatch, runBatchSync, 
+// Batch utilities
+extractSuccesses, extractFailures, getResultByKey, toResultMap, filterByKeys, mergeBatchResults, retryFailed, 
+// Fluent builder
+batchBuilder, BatchBuilder, } from './batch.js';
+// -----------------------------------------------------------------------------
+// MCP ADAPTER EXPORTS
+// -----------------------------------------------------------------------------
+export { 
+// MCP result converters
+toMcpResult, mcpSuccess, mcpFailure, mcpLegacyFailure, mcpFromError, mcpBatchResult, 
+// Legacy support
+fromLegacyResponse, 
+// Handler wrappers
+wrapToolHandler, wrapToolHandlerSync, } from './mcp-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/core/result/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/result/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AA2BH,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,OAAO;AACL,sBAAsB;AACtB,OAAO,EACP,OAAO,EACP,SAAS,EACT,WAAW,EACX,aAAa;AAEb,cAAc;AACd,SAAS,EACT,SAAS,EACT,WAAW;AAEX,mBAAmB;AACnB,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,WAAW;AAEX,2BAA2B;AAC3B,GAAG,EACH,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,KAAK;AAEL,wBAAwB;AACxB,GAAG,EACH,SAAS;AAET,uBAAuB;AACvB,UAAU,EACV,QAAQ,GACT,MAAM,eAAe,CAAC;AAEvB,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO;AACL,iBAAiB;AACjB,iBAAiB;AAEjB,kBAAkB;AAClB,QAAQ,EACR,YAAY;AAEZ,kBAAkB;AAClB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,WAAW;AAEX,iBAAiB;AACjB,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAIpB,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,OAAO;AACL,wBAAwB;AACxB,WAAW,EACX,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc;AAEd,iBAAiB;AACjB,kBAAkB;AAElB,mBAAmB;AACnB,eAAe,EACf,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}