promptspeak-mcp-server 0.1.0

package/dist/core/patterns/singleton.js

@@ -0,0 +1,115 @@
+/**
+ * ===============================================================================
+ * SINGLETON PATTERN UTILITIES
+ * ===============================================================================
+ *
+ * Reusable singleton pattern implementation to reduce boilerplate.
+ * Used across: SwarmEventBus, HookRegistry, SwarmController, BootCampController, etc.
+ *
+ * Usage:
+ *   const [getInstance, resetInstance] = createSingleton(() => new MyClass());
+ *   export { getInstance as getMyClass, resetInstance as resetMyClass };
+ *
+ * ===============================================================================
+ */
+/**
+ * Creates a singleton factory with lazy initialization.
+ *
+ * @param factory - Function that creates the singleton instance
+ * @returns Tuple of [getInstance, resetInstance] functions
+ *
+ * @example
+ * ```typescript
+ * class DatabaseConnection {
+ *   constructor(private config: Config) {}
+ * }
+ *
+ * const [getDb, resetDb] = createSingleton(() => new DatabaseConnection(loadConfig()));
+ * export { getDb as getDatabaseConnection };
+ * ```
+ */
+export function createSingleton(factory) {
+    let instance = null;
+    const getInstance = () => {
+        if (instance === null) {
+            instance = factory();
+        }
+        return instance;
+    };
+    const resetInstance = () => {
+        instance = null;
+    };
+    return [getInstance, resetInstance];
+}
+/**
+ * Creates a singleton factory with async initialization.
+ *
+ * @param factory - Async function that creates the singleton instance
+ * @returns Tuple of [getInstance, resetInstance] functions
+ *
+ * @example
+ * ```typescript
+ * const [getDb, resetDb] = createAsyncSingleton(async () => {
+ *   const db = new Database();
+ *   await db.connect();
+ *   return db;
+ * });
+ * ```
+ */
+export function createAsyncSingleton(factory) {
+    let instance = null;
+    let initPromise = null;
+    const getInstance = async () => {
+        if (instance !== null) {
+            return instance;
+        }
+        if (initPromise !== null) {
+            return initPromise;
+        }
+        initPromise = factory().then((result) => {
+            instance = result;
+            initPromise = null;
+            return result;
+        });
+        return initPromise;
+    };
+    const resetInstance = () => {
+        instance = null;
+        initPromise = null;
+    };
+    return [getInstance, resetInstance];
+}
+/**
+ * Creates a singleton with configurable initialization.
+ * Allows passing configuration on first call.
+ *
+ * @param factory - Function that creates the instance with config
+ * @returns Tuple of [getInstance, resetInstance] functions
+ *
+ * @example
+ * ```typescript
+ * const [getServer, resetServer] = createConfigurableSingleton(
+ *   (config: ServerConfig) => new Server(config)
+ * );
+ *
+ * // First call initializes with config
+ * const server = getServer({ port: 3000 });
+ *
+ * // Subsequent calls return same instance (config ignored)
+ * const sameServer = getServer({ port: 4000 }); // Returns 3000 server
+ * ```
+ */
+export function createConfigurableSingleton(factory) {
+    let instance = null;
+    const getInstance = (config) => {
+        if (instance === null) {
+            instance = factory(config);
+        }
+        return instance;
+    };
+    const resetInstance = () => {
+        instance = null;
+    };
+    return [getInstance, resetInstance];
+}
+//# sourceMappingURL=singleton.js.map

package/dist/core/patterns/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../../../src/core/patterns/singleton.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAI,OAAgB;IACjD,IAAI,QAAQ,GAAa,IAAI,CAAC;IAE9B,MAAM,WAAW,GAAG,GAAM,EAAE;QAC1B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,QAAQ,GAAG,OAAO,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAS,EAAE;QAC/B,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAyB;IAEzB,IAAI,QAAQ,GAAa,IAAI,CAAC;IAC9B,IAAI,WAAW,GAAsB,IAAI,CAAC;IAE1C,MAAM,WAAW,GAAG,KAAK,IAAgB,EAAE;QACzC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,WAAW,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACtC,QAAQ,GAAG,MAAM,CAAC;YAClB,WAAW,GAAG,IAAI,CAAC;YACnB,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAS,EAAE;QAC/B,QAAQ,GAAG,IAAI,CAAC;QAChB,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC,CAAC;IAEF,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAyB;IAEzB,IAAI,QAAQ,GAAa,IAAI,CAAC;IAE9B,MAAM,WAAW,GAAG,CAAC,MAAS,EAAK,EAAE;QACnC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAS,EAAE;QAC/B,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,190 @@
+/**
+ * ===============================================================================
+ * BATCH OPERATION UTILITIES
+ * ===============================================================================
+ *
+ * Utilities for running batch operations that return Results.
+ * Provides consistent handling of multiple operations with timing
+ * metadata and summary statistics.
+ *
+ * ===============================================================================
+ */
+import type { Result, BatchResult, BatchResultEntry } from './types.js';
+/**
+ * Creates a BatchResult from an array of keyed results.
+ *
+ * @param results - Array of keyed results
+ * @param startTime - Start timestamp for calculating execution time
+ * @returns A complete BatchResult with summary statistics
+ *
+ * @example
+ * ```typescript
+ * const startTime = Date.now();
+ * const results = items.map(item => ({
+ *   key: item.id,
+ *   result: processItem(item)
+ * }));
+ * const batchResult = createBatchResult(results, startTime);
+ * ```
+ */
+export declare function createBatchResult<T>(results: Array<BatchResultEntry<T>>, startTime: number): BatchResult<T>;
+/**
+ * Options for batch execution.
+ */
+export interface BatchExecutionOptions {
+    /** Stop processing on first failure */
+    stopOnFirstError?: boolean;
+    /** Maximum number of concurrent operations (default: no limit) */
+    concurrency?: number;
+    /** Timeout for each individual operation in ms */
+    operationTimeoutMs?: number;
+    /** Continue processing even if some operations fail */
+    continueOnError?: boolean;
+}
+/**
+ * Runs a batch operation over an array of items.
+ *
+ * @param items - Array of items to process
+ * @param keyFn - Function to extract a unique key from each item
+ * @param operation - Async function that processes each item and returns a Result
+ * @param options - Batch execution options
+ * @returns A BatchResult containing all individual results and summary
+ *
+ * @example
+ * ```typescript
+ * const batchResult = await runBatch(
+ *   users,
+ *   user => user.id,
+ *   async user => validateUser(user)
+ * );
+ *
+ * if (batchResult.allSucceeded) {
+ *   console.log('All users validated');
+ * } else {
+ *   console.log(`Failed: ${batchResult.failedKeys.join(', ')}`);
+ * }
+ * ```
+ */
+export declare function runBatch<T, R>(items: T[], keyFn: (item: T) => string, operation: (item: T) => Promise<Result<R>>, options?: BatchExecutionOptions): Promise<BatchResult<R>>;
+/**
+ * Runs a synchronous batch operation over an array of items.
+ *
+ * @param items - Array of items to process
+ * @param keyFn - Function to extract a unique key from each item
+ * @param operation - Sync function that processes each item and returns a Result
+ * @param options - Batch execution options
+ * @returns A BatchResult containing all individual results and summary
+ */
+export declare function runBatchSync<T, R>(items: T[], keyFn: (item: T) => string, operation: (item: T) => Result<R>, options?: Pick<BatchExecutionOptions, 'stopOnFirstError'>): BatchResult<R>;
+/**
+ * Extracts all successful results from a BatchResult.
+ *
+ * @param batchResult - The batch result to extract from
+ * @returns Array of successful data values with their keys
+ */
+export declare function extractSuccesses<T>(batchResult: BatchResult<T>): Array<{
+    key: string;
+    data: T;
+}>;
+/**
+ * Extracts all failures from a BatchResult.
+ *
+ * @param batchResult - The batch result to extract from
+ * @returns Array of failure errors with their keys
+ */
+export declare function extractFailures<T>(batchResult: BatchResult<T>): Array<{
+    key: string;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+/**
+ * Gets a specific result by key from a BatchResult.
+ *
+ * @param batchResult - The batch result to search
+ * @param key - The key to find
+ * @returns The result for the given key, or undefined if not found
+ */
+export declare function getResultByKey<T>(batchResult: BatchResult<T>, key: string): Result<T> | undefined;
+/**
+ * Converts a BatchResult to a Map for easy lookup.
+ *
+ * @param batchResult - The batch result to convert
+ * @returns A Map from key to Result
+ */
+export declare function toResultMap<T>(batchResult: BatchResult<T>): Map<string, Result<T>>;
+/**
+ * Filters a BatchResult to only include certain keys.
+ *
+ * @param batchResult - The batch result to filter
+ * @param keys - Keys to include
+ * @returns A new BatchResult with only the specified keys
+ */
+export declare function filterByKeys<T>(batchResult: BatchResult<T>, keys: string[]): BatchResult<T>;
+/**
+ * Merges multiple BatchResults into a single BatchResult.
+ *
+ * @param batchResults - Array of batch results to merge
+ * @returns A combined BatchResult
+ */
+export declare function mergeBatchResults<T>(batchResults: Array<BatchResult<T>>): BatchResult<T>;
+/**
+ * Retries failed operations in a BatchResult.
+ *
+ * @param batchResult - The original batch result
+ * @param items - Original items array (needed to re-run failed operations)
+ * @param keyFn - Function to extract key from item
+ * @param operation - The operation to retry
+ * @param maxRetries - Maximum number of retry attempts per item
+ * @returns A new BatchResult with retried operations
+ */
+export declare function retryFailed<T, R>(batchResult: BatchResult<R>, items: T[], keyFn: (item: T) => string, operation: (item: T) => Promise<Result<R>>, maxRetries?: number): Promise<BatchResult<R>>;
+/**
+ * Fluent builder for batch operations.
+ * Provides a more readable way to configure and run batch operations.
+ *
+ * @example
+ * ```typescript
+ * const result = await batchBuilder(users)
+ *   .keyBy(user => user.id)
+ *   .withConcurrency(5)
+ *   .stopOnFirstError()
+ *   .run(async user => validateUser(user));
+ * ```
+ */
+export declare function batchBuilder<T>(items: T[]): BatchBuilder<T>;
+/**
+ * Fluent builder class for batch operations.
+ */
+export declare class BatchBuilder<T> {
+    private items;
+    private options;
+    private keyFunction?;
+    constructor(items: T[]);
+    /**
+     * Sets the function to extract keys from items.
+     */
+    keyBy(fn: (item: T) => string): this;
+    /**
+     * Sets the maximum concurrency for parallel execution.
+     */
+    withConcurrency(limit: number): this;
+    /**
+     * Enables stopping on the first error.
+     */
+    stopOnFirstError(enabled?: boolean): this;
+    /**
+     * Sets a timeout for each individual operation.
+     */
+    withTimeout(ms: number): this;
+    /**
+     * Runs the batch operation.
+     */
+    run<R>(operation: (item: T) => Promise<Result<R>>): Promise<BatchResult<R>>;
+    /**
+     * Runs a synchronous batch operation.
+     */
+    runSync<R>(operation: (item: T) => Result<R>): BatchResult<R>;
+}
+//# sourceMappingURL=batch.d.ts.map

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

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