@apiquest/fracture 1.0.2 → 1.0.5

package/src/CollectionRunner.types.ts

@@ -1,9 +0,0 @@
-import type { TestResult } from '@apiquest/types';
-
-export interface PluginEventTest extends TestResult {
-  eventName?: string;
-}
-
-export interface ErrorWithPhase extends Error {
-  phase?: string;
-}

package/src/CollectionValidator.ts

@@ -1,289 +0,0 @@
-import type {
-  Collection,
-  CollectionItem,
-  Request,
-  Folder,
-  RuntimeOptions,
-  ValidationResult,
-  ValidationError,
-} from '@apiquest/types';
-import { ScriptType } from '@apiquest/types';
-import { ScriptValidator } from './ScriptValidator.js';
-import type { PluginManager } from './PluginManager.js';
-import { Logger } from './Logger.js';
-import { isNullOrWhitespace } from './utils.js';
-
-/**
- * Validates collections and their items (folders/requests) for pre-run validation
- */
-export class CollectionValidator {
-  private logger: Logger;
-
-  constructor(
-    private readonly pluginManager: PluginManager,
-    baseLogger?: Logger
-  ) {
-    this.logger = baseLogger?.createLogger('CollectionValidator') ?? new Logger('CollectionValidator');
-  }
-
-  /**
-   * Validate entire collection structure, scripts, and configurations
-   */
-  async validateCollection(
-    collection: Collection,
-    options: RuntimeOptions,
-    strictMode: boolean = true
-  ): Promise<ValidationResult> {
-    const errors: ValidationError[] = [];
-
-    this.logger.debug(`Validating collection: ${collection.info.name} (strict=${strictMode})`);
-
-    // Get protocol plugin for validation
-    const protocolPlugin = this.pluginManager.getPlugin(collection.protocol);
-    if (protocolPlugin === undefined) {
-      this.logger.warn(`Protocol plugin not loaded for validation: ${collection.protocol}`);
-    }
-
-    // Helper to recursively validate all items
-    const validateItem = (item: CollectionItem, path: string): void => {
-      if (item.type === 'folder') {
-        const folder = item;
-        
-        // Validate folder scripts
-        if (!isNullOrWhitespace(folder.folderPreScript)) {
-          errors.push(
-            ...ScriptValidator.validateScript(
-              folder.folderPreScript!,
-              ScriptType.FolderPre,
-              path,
-              undefined,
-              protocolPlugin,
-              strictMode
-            )
-          );
-        }
-        if (!isNullOrWhitespace(folder.folderPostScript)) {
-          errors.push(
-            ...ScriptValidator.validateScript(
-              folder.folderPostScript!,
-              ScriptType.FolderPost,
-              path,
-              undefined,
-              protocolPlugin,
-              strictMode
-            )
-          );
-        }
-        if (!isNullOrWhitespace(folder.preRequestScript)) {
-          errors.push(
-            ...ScriptValidator.validateScript(
-              folder.preRequestScript!,
-              ScriptType.PreRequest,
-              path,
-              undefined,
-              protocolPlugin,
-              strictMode
-            )
-          );
-        }
-        if (!isNullOrWhitespace(folder.postRequestScript)) {
-          errors.push(
-            ...ScriptValidator.validateScript(
-              folder.postRequestScript!,
-              ScriptType.PostRequest,
-              path,
-              undefined,
-              protocolPlugin,
-              strictMode
-            )
-          );
-        }
-
-        // Validate auth config if present
-        if (folder.auth !== null && folder.auth !== undefined && folder.auth.type !== 'inherit' && folder.auth.type !== 'none') {
-          const authPlugin = this.pluginManager.getAuthPlugin(folder.auth.type);
-          if (authPlugin?.validate !== null && authPlugin?.validate !== undefined) {
-            const authResult = authPlugin.validate(folder.auth, options);
-            if (authResult.valid === false && authResult.errors !== null && authResult.errors !== undefined) {
-              errors.push(...authResult.errors);
-            }
-          }
-        }
-
-        // Recursively validate folder items
-        for (const child of folder.items) {
-          const childPath = `${path}/${child.name}`;
-          validateItem(child, childPath);
-        }
-      } else {
-        // Request validation
-        const request = item;
-        
-        // Validate request scripts
-        if (!isNullOrWhitespace(request.preRequestScript)) {
-          errors.push(
-            ...ScriptValidator.validateScript(
-              request.preRequestScript!,
-              ScriptType.PreRequest,
-              path,
-              undefined,
-              protocolPlugin,
-              strictMode
-            )
-          );
-        }
-        if (!isNullOrWhitespace(request.postRequestScript)) {
-          errors.push(
-            ...ScriptValidator.validateScript(
-              request.postRequestScript!,
-              ScriptType.PostRequest,
-              path,
-              undefined,
-              protocolPlugin,
-              strictMode
-            )
-          );
-        }
-
-        // Validate plugin event scripts
-        if (request.data.scripts !== null && request.data.scripts !== undefined && Array.isArray(request.data.scripts)) {
-          // Check for duplicate event scripts (only one script per event type allowed)
-          const eventCounts = new Map<string, number>();
-          for (const script of request.data.scripts) {
-            const count = eventCounts.get(script.event) ?? 0;
-            eventCounts.set(script.event, count + 1);
-            
-            if (count >= 1) {
-              errors.push({
-                message: `Request has multiple scripts for event "${script.event}". Only one script per event type is allowed.`,
-                location: path,
-                source: 'script'
-              });
-            }
-          }
-          
-          // Validate each script
-          if (protocolPlugin?.events !== null && protocolPlugin?.events !== undefined) {
-            for (const script of request.data.scripts) {
-              const eventDef = protocolPlugin.events.find(e => e.name === script.event);
-              if (eventDef !== null && eventDef !== undefined) {
-                errors.push(
-                  ...ScriptValidator.validateScript(
-                    script.script,
-                    ScriptType.PluginEvent,
-                    path,
-                    eventDef,
-                    protocolPlugin,
-                    strictMode
-                  )
-                );
-              }
-            }
-          }
-        }
-
-        // Validate protocol request via plugin
-        if (protocolPlugin?.validate !== null && protocolPlugin?.validate !== undefined) {
-          const protocolResult = protocolPlugin.validate(request, options);
-          if (protocolResult.valid === false && protocolResult.errors !== null && protocolResult.errors !== undefined) {
-            errors.push(
-              ...protocolResult.errors.map(err => ({
-                ...err,
-                location: path
-              }))
-            );
-          }
-        }
-
-        // Validate auth config if present
-        if (request.auth !== null && request.auth !== undefined && request.auth.type !== 'inherit' && request.auth.type !== 'none') {
-          const authPlugin = this.pluginManager.getAuthPlugin(request.auth.type);
-          if (authPlugin?.validate !== null && authPlugin?.validate !== undefined) {
-            const authResult = authPlugin.validate(request.auth, options);
-            if (authResult.valid === false && authResult.errors !== null && authResult.errors !== undefined) {
-              errors.push(
-                ...authResult.errors.map(err => ({
-                  ...err,
-                  location: path
-                }))
-              );
-            }
-          }
-        }
-      }
-    };
-
-    // Validate collection-level scripts
-    if (!isNullOrWhitespace(collection.collectionPreScript)) {
-      errors.push(
-        ...ScriptValidator.validateScript(
-          collection.collectionPreScript!,
-          ScriptType.CollectionPre,
-          '/',
-          undefined,
-          protocolPlugin,
-          strictMode
-        )
-      );
-    }
-    if (!isNullOrWhitespace(collection.collectionPostScript)) {
-      errors.push(
-        ...ScriptValidator.validateScript(
-          collection.collectionPostScript!,
-          ScriptType.CollectionPost,
-          '/',
-          undefined,
-          protocolPlugin,
-          strictMode
-        )
-      );
-    }
-    if (!isNullOrWhitespace(collection.preRequestScript)) {
-      errors.push(
-        ...ScriptValidator.validateScript(
-          collection.preRequestScript!,
-          ScriptType.PreRequest,
-          '/',
-          undefined,
-          protocolPlugin,
-          strictMode
-        )
-      );
-    }
-    if (!isNullOrWhitespace(collection.postRequestScript)) {
-      errors.push(
-        ...ScriptValidator.validateScript(
-          collection.postRequestScript!,
-          ScriptType.PostRequest,
-          '/',
-          undefined,
-          protocolPlugin,
-          strictMode
-        )
-      );
-    }
-
-    // Validate collection-level auth
-    if (collection.auth !== null && collection.auth !== undefined && collection.auth.type !== 'inherit' && collection.auth.type !== 'none') {
-      const authPlugin = this.pluginManager.getAuthPlugin(collection.auth.type);
-      if (authPlugin?.validate !== null && authPlugin?.validate !== undefined) {
-        const authResult = authPlugin.validate(collection.auth, options);
-        if (authResult.valid === false && authResult.errors !== null && authResult.errors !== undefined) {
-          errors.push(...authResult.errors);
-        }
-      }
-    }
-
-    // Validate all items recursively
-    for (const item of collection.items) {
-      validateItem(item, `/${item.name}`);
-    }
-
-    this.logger.debug(`Validation completed with ${errors.length} error(s)`);
-
-    return {
-      valid: errors.length === 0,
-      errors
-    };
-  }
-}

package/src/ConsoleReporter.ts

@@ -1,143 +0,0 @@
-import type {
-  IReporter,
-  Collection,
-  RunOptions,
-  Request,
-  RequestResult,
-  TestResult,
-  RunResult,
-  LogLevel,
-  EventPayloads
-} from '@apiquest/types';
-import { LogLevel as LogLevelEnum } from '@apiquest/types';
-import type { EventEmitter } from 'events';
-
-export class ConsoleReporter implements IReporter {
-  name = 'console';
-  version: string = '1.0.0';
-  description: string = 'Pretty CLI output for quest runs';
-  reportTypes: string[] = ['console'];
-
-  private logLevel: LogLevel;
-  private color: boolean;
-  private runner?: EventEmitter;
-
-  constructor(options?: { logLevel?: LogLevel; color?: boolean; runner?: EventEmitter }) {
-    this.logLevel = options?.logLevel ?? LogLevelEnum.INFO;
-    this.color = options?.color ?? true;  // Color enabled by default
-    this.runner = options?.runner;
-    
-    // Subscribe to console events for logger output
-    if (this.runner !== null && this.runner !== undefined) {
-      this.setupConsoleLogging();
-    }
-  }
-  
-  private setupConsoleLogging(): void {
-    if (this.runner === null || this.runner === undefined) return;
-    
-    // Log levels are hierarchical using LogLevel enum values
-    this.runner.on('console', ({ level, levelName, message }: EventPayloads['console']) => {
-      // Only show if message level is <= configured level (lower number = higher priority)
-      if (level <= this.logLevel) {
-        const tag = `[${(levelName !== null && levelName !== undefined && levelName.length > 0) ? levelName.toUpperCase() : 'LOG'}]`;
-        if (level === LogLevelEnum.ERROR) {
-          console.error(`${tag} ${message}`);
-        } else if (level === LogLevelEnum.WARN) {
-          console.warn(`${tag} ${message}`);
-        } else {
-          console.log(`${tag} ${message}`);
-        }
-      }
-    });
-  }
-  
-  private colorize(text: string, colorCode: string): string {
-    if (!this.color) return text;
-    return `${colorCode}${text}\x1b[0m`;
-  }
-
-  onRunStarted(collection: Collection, options: RunOptions): void {
-    console.log('============================================================');
-    console.log(`  Quest v1.0.0`);
-    console.log(`  Collection: ${collection.info.name}`);
-    console.log('============================================================');
-    console.log('');
-  }
-
-  onBeforeRequest(payload: EventPayloads['beforeRequest']): void {
-    console.log('');
-    console.log(`${this.colorize('>', '\x1b[36m')} ${payload.request.name}`);
-    
-    const requestData = payload.request.data as Record<string, unknown> | null | undefined;
-    if (requestData !== null && requestData !== undefined) {
-      const method = (typeof requestData.method === 'string' && requestData.method.length > 0) ? requestData.method : 'GET';
-      const url = (typeof requestData.url === 'string' && requestData.url.length > 0) ? requestData.url : '';
-      console.log(`  ${method} ${url}`);
-    }
-  }
-
-  onAfterRequest(payload: EventPayloads['afterRequest']): void {
-    if (payload.response.error !== null && payload.response.error !== undefined && payload.response.error.length > 0) {
-      console.log(`  ${this.colorize('[FAIL]', '\x1b[31m')} ERROR: ${payload.response.error}`);
-    } else {
-      const statusColor = payload.response.status >= 400 ? '\x1b[31m' : '\x1b[32m';
-      console.log(`  ${this.colorize('<', statusColor)} ${payload.response.status} ${payload.response.statusText} (${payload.duration}ms)`);
-    }
-  }
-
-  onAssertion(payload: EventPayloads['assertion']): void {
-    const test = payload.test;
-    if (test.skipped) {
-      console.log(`  ${this.colorize('[SKIP]', '\x1b[90m')} ${test.name}`);
-    } else if (test.passed) {
-      console.log(`  ${this.colorize('[PASS]', '\x1b[32m')} ${test.name}`);
-    } else {
-      console.log(`  ${this.colorize('[FAIL]', '\x1b[31m')} ${test.name}`);
-      if (test.error !== null && test.error !== undefined && test.error.length > 0) {
-        console.log(`    Error: ${test.error}`);
-      }
-    }
-  }
-
-  onRunCompleted(result: RunResult): void {
-    console.log('');
-    console.log('------------------------------------------------------------');
-    console.log('');
-    console.log('RESULTS:');
-    console.log(`  Collection: ${result.collectionName}`);
-    console.log(`  Duration: ${(result.duration / 1000).toFixed(2)}s`);
-    console.log(`  Requests: ${result.requestResults.length}`);
-    
-    const successful = result.requestResults.filter(r => r.success).length;
-    const failed = result.requestResults.filter(r => !r.success).length;
-    
-    if (successful > 0) {
-      console.log(`    - Successful: ${successful}`);
-    }
-    if (failed > 0) {
-      console.log(`    - Failed: ${failed}`);
-    }
-    
-    if (result.totalTests > 0) {
-      console.log(`  Tests: ${result.totalTests}`);
-      console.log(`    - Passed: ${result.passedTests}`);
-      if (result.failedTests > 0) {
-        console.log(`    - Failed: ${result.failedTests}`);
-      }
-      if (result.skippedTests > 0) {
-        console.log(`    - Skipped: ${result.skippedTests}`);
-      }
-    }
-    
-    console.log('');
-    
-    // if any TEST results failed end with error exit code 1
-    // Request failures are OK if tests expect and handle them
-    if (result.failedTests > 0) {
-      console.log(`${this.colorize('[FAIL]', '\x1b[31m')} Collection run completed with errors`);  // Red
-    } else {
-      console.log(`${this.colorize('[PASS]', '\x1b[32m')} Collection run completed successfully`);  // Green
-    }
-  }
-}

package/src/CookieJar.ts

@@ -1,258 +0,0 @@
-import { CookieJar as ToughCookieJar, Cookie } from 'tough-cookie';
-import type { ICookieJar, CookieJarOptions, Cookie as ICookie, CookieSetOptions } from '@apiquest/types';
-
-/**
- * CookieJar implementation using tough-cookie for production-quality cookie management.
- * Wraps tough-cookie's CookieJar to provide ICookieJar interface.
- */
-export class CookieJar implements ICookieJar {
-  private jar: ToughCookieJar;
-  private options: CookieJarOptions;
-
-  constructor(options?: CookieJarOptions) {
-    this.options = options ?? { persist: false };
-    this.jar = new ToughCookieJar();
-  }
-
-  /**
-   * Store cookies from Set-Cookie headers
-   * @param setCookieHeaders - Single header string or array of header strings
-   * @param requestUrl - URL the cookies came from (REQUIRED for domain/path matching)
-   */
-  store(setCookieHeaders: string | string[] | null | undefined, requestUrl: string): void {
-    if (setCookieHeaders === null || setCookieHeaders === undefined) {
-      return;
-    }
-
-    const headers = Array.isArray(setCookieHeaders) ? setCookieHeaders : [setCookieHeaders];
-
-    for (const header of headers) {
-      try {
-        this.jar.setCookieSync(header, requestUrl);
-      } catch (error) {
-        // Ignore invalid cookies (tough-cookie throws on malformed cookies)
-        // Silent failure is fine here
-      }
-    }
-  }
-
-  /**
-   * Get cookie value by name
-   * When called without domain, searches ALL cookies (across all domains)
-   * 
-   * @param name - Cookie name
-   * @param domain - Optional domain to filter (not commonly used)
-   * @param path - Optional path to filter (not commonly used)
-   * @returns Cookie value or null if not found
-   */
-  get(name: string, domain?: string, path?: string): string | null {
-    // Use toJSON to get ALL cookies, then manually filter for expiration only
-    const allCookiesJson = this.jar.toJSON();
-    if (allCookiesJson?.cookies === undefined) {
-      return null;
-    }
-
-    // Search for cookie by name
-    for (const cookieData of allCookiesJson.cookies) {
-      // Use Cookie.fromJSON for proper typing
-      const cookie = Cookie.fromJSON(cookieData);
-      if (cookie === null || cookie === undefined) {
-        continue;
-      }
-
-      if (cookie.key !== name) {
-        continue;
-      }
-
-      // Check expiration
-      const expiryTime = cookie.expiryTime();
-      if (expiryTime !== null && expiryTime !== undefined && expiryTime < Date.now()) {
-        continue; // Skip expired cookies
-      }
-
-      // If domain filter specified, check it
-      if (domain !== null && domain !== undefined && domain !== '') {
-        if (cookie.domain === null) {
-          continue;
-        }
-        if (cookie.domain !== domain && !cookie.domain.endsWith(domain)) {
-          continue;
-        }
-      }
-
-      // If path filter specified, check it
-      if (path !== null && path !== undefined && path !== '') {
-        if (cookie.path === null || cookie.path !== path) {
-          continue;
-        }
-      }
-
-      return cookie.value;
-    }
-
-    return null;
-  }
-
-  /**
-   * Check if cookie exists
-   * @param name - Cookie name
-   * @param domain - Optional domain filter
-   * @param path - Optional path filter
-   * @returns true if cookie exists
-   */
-  has(name: string, domain?: string, path?: string): boolean {
-    return this.get(name, domain, path) !== null;
-  }
-
-  /**
-   * Remove a cookie by name
-   * @param name - Cookie name
-   * @param domain - Optional domain
-   * @param path - Optional path
-   */
-  remove(name: string, domain?: string, path?: string): void {
-    const allCookiesJson = this.jar.toJSON();
-    if (allCookiesJson?.cookies === undefined) {
-      return;
-    }
-
-    // Find matching cookies using Cookie.fromJSON for proper typing
-    const cookiesToRemove: Cookie[] = [];
-    for (const cookieData of allCookiesJson.cookies) {
-      const cookie = Cookie.fromJSON(cookieData);
-      if (cookie === null || cookie === undefined) {
-        continue;
-      }
-      
-      if (cookie.key !== name) {
-        continue;
-      }
-
-      // Check domain filter
-      if (domain !== null && domain !== undefined && domain !== '') {
-        if (cookie.domain === null) {
-          continue;
-        }
-        if (cookie.domain !== domain && !cookie.domain.endsWith(domain)) {
-          continue;
-        }
-      }
-
-      // Check path filter
-      if (path !== null && path !== undefined && path !== '') {
-        if (cookie.path === null || cookie.path !== path) {
-          continue;
-        }
-      }
-      
-      cookiesToRemove.push(cookie);
-    }
-
-    // Remove each matching cookie
-    for (const cookie of cookiesToRemove) {
-      // Domain should always be present in cookies from tough-cookie
-      const cookieDomain = cookie.domain;
-      if (cookieDomain === null || cookieDomain === undefined) {
-        continue; // Skip cookies without domain
-      }
-      const cookiePath = cookie.path ?? '/';
-      try {
-        this.jar.store.removeCookie(cookieDomain, cookiePath, cookie.key, () => {
-          // Callback required by tough-cookie API
-        });
-      } catch {
-        // Ignore errors
-      }
-    }
-  }
-
-  /**
-   * Set a cookie manually
-   * Constructs URL from cookie's domain for RFC 6265 validation
-   * @param name - Cookie name
-   * @param value - Cookie value
-   * @param options - Cookie options
-   */
-  set(name: string, value: string, options: CookieSetOptions): void {
-    let cookieStr = `${name}=${value}; Domain=${options.domain}; Path=${options.path ?? '/'}`;
-    
-    if (options.expires !== null && options.expires !== undefined) {
-      cookieStr += `; Expires=${options.expires}`;
-    }
-    if (options.httpOnly === true) {
-      cookieStr += '; HttpOnly';
-    }
-    if (options.secure === true) {
-      cookieStr += '; Secure';
-    }
-    if (options.sameSite !== null && options.sameSite !== undefined) {
-      cookieStr += `; SameSite=${options.sameSite}`;
-    }
-    
-    const protocol = options.secure === true ? 'https' : 'http';
-    const url = `${protocol}://${options.domain}${options.path ?? '/'}`;
-    
-    this.jar.setCookieSync(cookieStr, url);
-  }
-
-  /**
-   * Clear all cookies
-   */
-  clear(): void {
-    this.jar.removeAllCookiesSync();
-  }
-
-  /**
-   * Get all cookies as an object
-   * Returns non-expired cookies from ALL domains
-   * @returns Object with cookie names as keys and values
-   */
-  toObject(): Record<string, string> {
-    const result: Record<string, string> = {};
-    
-    // Use toJSON to get all cookies, filter expired manually
-    const allCookiesJson = this.jar.toJSON();
-    if (allCookiesJson?.cookies === undefined) {
-      return result;
-    }
-
-    // Add all non-expired cookies
-    for (const cookieData of allCookiesJson.cookies) {
-      try {
-        const cookie = Cookie.fromJSON(cookieData);
-        if (cookie === null || cookie === undefined) {
-          continue;
-        }
-
-        const expiryTime = cookie.expiryTime();
-        // Not expired if: no expiry time OR expiry time is in the future
-        const isExpired = expiryTime !== null && expiryTime !== undefined && expiryTime < Date.now();
-        if (!isExpired) {
-          result[cookie.key] = cookie.value;
-        }
-      } catch {
-        // Skip cookies that can't be parsed
-      }
-    }
-    
-    return result;
-  }
-
-  /**
-   * Get Cookie header string for a URL
-   * This is the main method used by HTTP plugin to send cookies with requests
-   * @param url - URL to get cookies for
-   * @returns Cookie header string in "name1=value1; name2=value2" format, or null if no cookies
-   */
-  getCookieHeader(url: string): string | null {
-    try {
-      const cookieString = this.jar.getCookieStringSync(url);
-      if (cookieString === null || cookieString === undefined || cookieString === '') {
-        return null;
-      }
-      return cookieString;
-    } catch {
-      return null;
-    }
-  }
-}