@http-forge/core 0.2.0 → 0.2.2

package/dist/domain/services/domain-events.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Domain Events - Events published by domain to application layer
+ *
+ * Domain events decouple domain logic from side effects
+ */
+import { IExecutionResult } from '../models/execution';
+/**
+ * Base domain event
+ */
+export declare abstract class DomainEvent {
+    readonly aggregateId: string;
+    readonly eventType: string;
+    readonly occurredAt: Date;
+    constructor(aggregateId: string, eventType: string);
+}
+/**
+ * RequestExecuted - Published when a request is successfully executed
+ */
+export declare class RequestExecutedEvent extends DomainEvent {
+    readonly collectionId: string;
+    readonly result: IExecutionResult;
+    constructor(requestId: string, collectionId: string, result: IExecutionResult);
+}
+/**
+ * RequestExecutionFailed - Published when request execution fails
+ */
+export declare class RequestExecutionFailedEvent extends DomainEvent {
+    readonly collectionId: string;
+    readonly error: Error;
+    readonly stage: 'preparation' | 'execution' | 'script';
+    constructor(requestId: string, collectionId: string, error: Error, stage: 'preparation' | 'execution' | 'script');
+}
+/**
+ * VariableUpdated - Published when execution changes variables
+ */
+export declare class VariableUpdatedEvent extends DomainEvent {
+    readonly variables: Record<string, any>;
+    readonly changes: Record<string, any>;
+    constructor(variables: Record<string, any>, changes: Record<string, any>);
+}
+/**
+ * CookieUpdated - Published when HTTP response sets cookies
+ */
+export declare class CookieUpdatedEvent extends DomainEvent {
+    readonly cookies: Record<string, string>;
+    constructor(cookies: Record<string, string>);
+}
+/**
+ * Domain event publisher abstraction
+ */
+export interface IDomainEventPublisher {
+    /**
+     * Publish domain event
+     */
+    publish(event: DomainEvent): Promise<void>;
+    /**
+     * Subscribe to events
+     */
+    subscribe(eventType: string, handler: (event: DomainEvent) => Promise<void>): void;
+}

package/dist/domain/services/execution-planner.domain-service.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Execution Planner Domain Service - Pure business logic for execution planning
+ *
+ * No external dependencies - only domain models and exceptions
+ * All logic is deterministic and testable without mocks
+ */
+import { UnifiedRequest } from '../../types/types';
+import { IExecutionContext, IExecutionPlan } from '../models/execution';
+/**
+ * Domain service for planning HTTP request execution
+ * Encapsulates rules for:
+ * - Request validation
+ * - Script preparation
+ * - Variable interpolation
+ */
+export declare class ExecutionPlannerDomainService {
+    /**
+     * Validate request before execution
+     */
+    validateRequest(request: UnifiedRequest): void;
+    /**
+     * Create execution plan from request and context
+     *
+     * Pure logic - no side effects
+     */
+    createExecutionPlan(request: UnifiedRequest, context: IExecutionContext): IExecutionPlan;
+    /**
+     * Check if request requires script execution
+     */
+    hasScripts(request: UnifiedRequest): boolean;
+    /**
+     * Check if request requires variable interpolation
+     */
+    needsVariableInterpolation(request: UnifiedRequest): boolean;
+    /**
+     * Build execution context from request and environment
+     */
+    buildExecutionContext(requestId: string, collectionId: string, variables: Record<string, any>, environment: Record<string, any>, cookies?: Record<string, string>): IExecutionContext;
+    private kvArrayToRecord;
+}

package/dist/domain/services/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Domain Services - Pure business logic
+ *
+ * Services contain only domain rules, no infrastructure concerns
+ * Zero external dependencies - fully testable without mocks
+ */
+export * from './execution-planner.domain-service';
+export * from './schema-inference.domain-service';
+export * from './domain-events';

package/dist/domain/services/schema-inference.domain-service.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Schema Inference Domain Service - Pure business logic for schema analysis
+ *
+ * Merges information from multiple sources to infer response schema
+ */
+/**
+ * Response schema representation
+ */
+export interface ResponseSchema {
+    type?: string;
+    properties?: Record<string, unknown>;
+    required?: string[];
+    description?: string;
+    example?: unknown;
+}
+/**
+ * Script hints extracted from post-response script
+ */
+export interface ScriptHints {
+    propertyAccess: string[];
+    assertions: string[];
+    dataExtracted: string[];
+}
+/**
+ * Schema validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Domain service for schema inference
+ * Pure logic for merging and validating schemas
+ */
+export declare class SchemaInferenceDomainService {
+    /**
+     * Merge multiple schemas into a final schema
+     * Priority: user-edited > inferred from history > script hints
+     */
+    mergeResponseSchemas(userEdited: ResponseSchema | null, inferredFromHistory: ResponseSchema | null, scriptHints: ScriptHints | null): ResponseSchema;
+    /**
+     * Validate schema is well-formed
+     */
+    validateSchema(schema: ResponseSchema): ValidationResult;
+    /**
+     * Extract property hints from script accesses
+     */
+    private buildPropertiesFromHints;
+    /**
+     * Merge two schemas using set union logic
+     */
+    private mergeSchemas;
+}

package/dist/domain/value-objects/entity-id.d.ts

@@ -0,0 +1,26 @@
+/**
+ * EntityId Value Object
+ *
+ * Base class for typed entity identifiers (RequestId, CollectionId).
+ * Prevents accidentally passing a collection ID where a request ID is expected.
+ */
+export declare abstract class EntityId {
+    readonly value: string;
+    constructor(value: string);
+    equals(other: EntityId): boolean;
+    toString(): string;
+}
+/**
+ * RequestId — uniquely identifies a request within a collection
+ */
+export declare class RequestId extends EntityId {
+    static create(id: string): RequestId;
+    static generate(): RequestId;
+}
+/**
+ * CollectionId — uniquely identifies a collection
+ */
+export declare class CollectionId extends EntityId {
+    static create(id: string): CollectionId;
+    static generate(): CollectionId;
+}

package/dist/domain/value-objects/http-method.d.ts

@@ -0,0 +1,30 @@
+/**
+ * HttpMethod Value Object
+ *
+ * Ensures only valid HTTP methods are used throughout the domain.
+ * Immutable — validated at construction time.
+ */
+declare const VALID_METHODS: readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "TRACE", "CONNECT"];
+export type HttpMethodValue = typeof VALID_METHODS[number];
+export declare class HttpMethod {
+    readonly value: HttpMethodValue;
+    private constructor();
+    /**
+     * Create an HttpMethod from a string.
+     * Normalizes to uppercase and validates.
+     */
+    static create(method: string): HttpMethod;
+    /**
+     * Create without validation (for trusted internal data).
+     */
+    static fromTrusted(method: HttpMethodValue): HttpMethod;
+    equals(other: HttpMethod): boolean;
+    toString(): string;
+    /** Whether this method typically has a request body */
+    get hasBody(): boolean;
+    /** Whether this method is considered safe (no side effects) */
+    get isSafe(): boolean;
+    /** Whether this method is idempotent */
+    get isIdempotent(): boolean;
+}
+export {};

package/dist/domain/value-objects/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Domain Value Objects
+ *
+ * Immutable, validated building blocks for the domain model.
+ * These enforce business invariants at construction time.
+ */
+export { HttpMethod, type HttpMethodValue } from './http-method';
+export { RequestUrl } from './request-url';
+export { EntityId, RequestId, CollectionId } from './entity-id';

package/dist/domain/value-objects/request-url.d.ts

@@ -0,0 +1,28 @@
+/**
+ * RequestUrl Value Object
+ *
+ * Validates and normalizes request URLs.
+ * Supports both absolute URLs and URL templates with variables (e.g. {{baseUrl}}/users).
+ */
+export declare class RequestUrl {
+    readonly value: string;
+    private constructor();
+    /**
+     * Create a RequestUrl from a string.
+     * Allows variable templates like {{baseUrl}}/path.
+     */
+    static create(url: string): RequestUrl;
+    /**
+     * Create without validation (for trusted internal data).
+     */
+    static fromTrusted(url: string): RequestUrl;
+    /** Whether the URL contains template variables */
+    get hasVariables(): boolean;
+    /** Extract variable names from the URL template */
+    get variableNames(): string[];
+    /** Get the protocol if present */
+    get protocol(): string | undefined;
+    equals(other: RequestUrl): boolean;
+    toString(): string;
+    private static isValidUrl;
+}

package/dist/index.d.ts

@@ -18,91 +18,97 @@
  */
 export { ForgeContainer } from './container';
 export type { ForgeContainerOptions, StorageFormat } from './container';
-export * from './types/types';
-export * from './types/platform';
+export { ServiceContainer, ServiceIdentifiers, getServiceContainer, registerCoreServices } from './di';
+export type { PlatformAdapters, ServiceIdentifier } from './di';
 export * from './types/console-service';
-export * from './cookie/interfaces';
-export { CookieJar } from './cookie/cookie-jar';
-export { CookieUtils } from './cookie/cookie-utils';
-export { InMemoryCookieJar } from './cookie/in-memory-cookie-jar';
-export { PersistentCookieJar } from './cookie/persistent-cookie-jar';
-export { CookieService } from './cookie/cookie-service';
-export type { IHttpRequestService } from './http/interfaces';
-export { FetchHttpClient } from './http/fetch-http-client';
-export { DEFAULT_REQUEST_SETTINGS, NodeHttpClient } from './http/native-http-client';
-export { InterceptorChain, LoggingRequestInterceptor, RetryErrorInterceptor, TimingResponseInterceptor } from './http/interceptor-chain';
-export type { IErrorInterceptor, IInterceptorChain, InterceptorContext, IRequestInterceptor, IResponseInterceptor } from './http/interceptor-chain';
-export { mergeRequestSettings } from './http/merge-request-settings';
-export { RequestPreprocessor } from './http/request-preprocessor';
-export type { IRequestPreprocessor } from './http/request-preprocessor';
-export { HttpRequestService } from './http/http-request-service';
-export { UrlBuilder } from './http/url-builder';
-export type { IUrlBuilder } from './http/url-builder';
-export * from './script/interfaces';
-export { ScriptExecutor } from './script/script-executor';
-export { RequestScriptSession } from './script/request-script-session';
-export type { SessionDependencies } from './script/request-script-session';
-export { createExpectChain, createResponseObject } from './script/script-factories';
-export type { ExpectChain, ResponseAssertions, ScriptResponse } from './script/script-factories';
-export { concatenateScripts, createScriptConsole, createTestFunction, formatConsoleOutput, hasChanged, normalizeHeaders } from './script/script-utils';
-export type { ConsoleMessage } from './script/script-utils';
-export { ModuleLoader, createLodashShim, createModuleLoader, createMomentShim } from './script/module-loader';
-export type { ModuleLoaderOptions } from './script/module-loader';
-export * from './collection/interfaces';
-export { CollectionLoader } from './collection/collection-loader';
-export type { LoadOptions } from './collection/collection-loader';
-export { CollectionLoaderFactory } from './collection/collection-loader-factory';
-export { CollectionService } from './collection/collection-service';
-export { FolderCollectionLoader, generateSlug } from './collection/folder-collection-loader';
-export { FolderCollectionStore } from './collection/folder-collection-store';
-export { JsonCollectionLoader } from './collection/json-collection-loader';
-export { ParserRegistry } from './collection/parser-registry';
-export * from './environment/interfaces';
-export { EnvironmentConfigService } from './environment/environment-config-service';
-export { EnvironmentResolver } from './environment/environment-resolver';
-export type { Environment, EnvironmentStoreConfig } from './environment/environment-resolver';
-export { ForgeEnv } from './environment/forge-env';
-export type { IForgeEnv } from './environment/forge-env';
-export { VariableInterpolator, VariableResolver, createVariableResolver } from './environment/variable-interpolator';
-export type { VariableResolverConfig } from './environment/variable-interpolator';
-export * from './execution/collection-request-executor-interfaces';
-export * from './execution/request-preparer-interfaces';
-export { CollectionRequestExecutor } from './execution/collection-request-executor';
-export { RequestExecutor } from './execution/request-executor';
-export type { ExecuteOptions, ExecuteResult } from './execution/request-executor';
-export { RequestPreparer } from './execution/request-preparer';
-export * from './history/history-interfaces';
-export type { IRequestHistoryService, IResponseStorage } from './history/request-history-service-interfaces';
-export { RequestHistoryStore } from './history/request-history';
-export { RequestHistoryService } from './history/request-history-service';
-export * from './auth/interfaces';
-export { OAuth2TokenManager } from './auth/oauth2-token-manager';
-export { getCompletions, parseQueryContext } from './graphql/graphql-completion-provider';
-export type { CompletionItem, ContextType, QueryContext } from './graphql/graphql-completion-provider';
-export { GraphQLSchemaService } from './graphql/graphql-schema-service';
-export type { GraphQLDirective, GraphQLField, GraphQLOperation, GraphQLSchema, GraphQLType, IGraphQLSchemaService } from './graphql/graphql-schema-service';
-export * from './openapi/interfaces';
-export { ExampleGenerator, HistoryAnalyzer, OpenApiExporter, OpenApiImporter, RefResolver, SchemaInferenceService, SchemaInferrer, ScriptAnalyzer } from './openapi';
-export type { OpenApiExportOptions, OpenApiImportOptions, ScriptAnalysisResult } from './openapi';
-export { CONFIG_FILES, ConfigService, DEFAULT_CONFIG, ROOT_DIRECTORIES } from './config';
-export type { EnvironmentsConfig, HttpForgeConfig, IConfigService, ProxyConfig, RequestConfig, RestClientExportConfig, RunnerConfig, ScriptsConfig, StorageConfig } from './config';
-export { DEFAULT_SUITE_CONFIG } from './test-suite/interfaces';
-export type { ErrorSummary, IStatisticsService, ITestSuiteService, RequestStatistics, RunStatistics, RunSummary, SuiteConfig, SuiteRequest, TestSuite } from './test-suite/interfaces';
-export { HTTP_METHOD_MAP, HTTP_METHOD_REVERSE, buildResultFileName, expandSummary } from './test-suite/result-storage';
-export type { FullResultDetails, IResultStorageService, IndexPage, RecentError, RequestStats, ResultSummary, RunConfig, RunManifest, RunStats } from './test-suite/result-storage';
-export { ResultStorageService } from './test-suite/result-storage-service';
-export { StatisticsService } from './test-suite/statistics-service';
-export { TestSuiteService } from './test-suite/test-suite-service';
-export type { SuitesChangedCallback } from './test-suite/test-suite-service';
-export { TestSuiteStore } from './test-suite/test-suite-store';
-export type { ITestSuiteStore, SuiteRequestEntry } from './test-suite/test-suite-store';
-export { HttpForgeParser } from './parsers';
-export { parsePostmanEnvironment, parsePostmanEnvironmentFile } from './import-export/import-postman-environment';
-export type { ImportedEnvironment } from './import-export/import-postman-environment';
-export { exportCollectionToRestClient, getRestClientExportFolder, writeEnvFile, writeFolderItems, writeScriptFile } from './import-export/rest-client-export';
-export { NodeFileSystem } from './platform/node-file-system';
-export { DataFileParser } from './platform/data-file-parser';
-export type { IDataFileParser } from './platform/data-file-parser';
+export * from './types/platform';
+export * from './types/types';
+export { CookieJar } from './infrastructure/cookie/cookie-jar';
+export { CookieService } from './infrastructure/cookie/cookie-service';
+export { CookieUtils } from './infrastructure/cookie/cookie-utils';
+export { InMemoryCookieJar } from './infrastructure/cookie/in-memory-cookie-jar';
+export * from './infrastructure/cookie/interfaces';
+export { PersistentCookieJar } from './infrastructure/cookie/persistent-cookie-jar';
+export { FetchHttpClient } from './infrastructure/http/fetch-http-client';
+export { HttpRequestService } from './infrastructure/http/http-request-service';
+export { InterceptorChain, LoggingRequestInterceptor, RetryErrorInterceptor, TimingResponseInterceptor } from './infrastructure/http/interceptor-chain';
+export type { IErrorInterceptor, IInterceptorChain, IRequestInterceptor, IResponseInterceptor, InterceptorContext } from './infrastructure/http/interceptor-chain';
+export type { IHttpRequestService } from './infrastructure/http/interfaces';
+export { mergeRequestSettings } from './infrastructure/http/merge-request-settings';
+export { DEFAULT_REQUEST_SETTINGS, NodeHttpClient } from './infrastructure/http/native-http-client';
+export { RequestPreprocessor } from './infrastructure/http/request-preprocessor';
+export type { IRequestPreprocessor } from './infrastructure/http/request-preprocessor';
+export { UrlBuilder } from './infrastructure/http/url-builder';
+export type { IUrlBuilder } from './infrastructure/http/url-builder';
+export * from './infrastructure/script/interfaces';
+export { ModuleLoader, createLodashShim, createModuleLoader, createMomentShim } from './infrastructure/script/module-loader';
+export type { ModuleLoaderOptions } from './infrastructure/script/module-loader';
+export { RequestScriptSession } from './infrastructure/script/request-script-session';
+export type { SessionDependencies } from './infrastructure/script/request-script-session';
+export { ScriptExecutor } from './infrastructure/script/script-executor';
+export { createExpectChain, createResponseObject } from './infrastructure/script/script-factories';
+export type { ExpectChain, ResponseAssertions, ScriptResponse } from './infrastructure/script/script-factories';
+export { concatenateScripts, createScriptConsole, createTestFunction, formatConsoleOutput, hasChanged, normalizeHeaders } from './infrastructure/script/script-utils';
+export type { ConsoleMessage } from './infrastructure/script/script-utils';
+export { CollectionLoader } from './infrastructure/collection/collection-loader';
+export type { LoadOptions } from './infrastructure/collection/collection-loader';
+export { CollectionLoaderFactory } from './infrastructure/collection/collection-loader-factory';
+export { CollectionService } from './infrastructure/collection/collection-service';
+export { FolderCollectionLoader } from './infrastructure/collection/folder-collection-loader';
+export { FolderCollectionStore } from './infrastructure/collection/folder-collection-store';
+export * from './infrastructure/collection/folder-io';
+export { generateSlug } from './infrastructure/collection/folder-io';
+export { ParserRegistry } from './infrastructure/collection/parser-registry';
+export type { Collection, ICollectionService } from './types/collection';
+export { JsonCollectionLoader } from './infrastructure/collection/json-collection-loader';
+export { EnvironmentConfigService } from './infrastructure/environment/environment-config-service';
+export { isSystemEnvironmentFile, loadEnvironmentsFromFolder } from './infrastructure/environment/environment-file-loader';
+export type { EnvironmentEntry, EnvironmentFolderData } from './infrastructure/environment/environment-file-loader';
+export { EnvironmentResolver } from './infrastructure/environment/environment-resolver';
+export type { Environment, EnvironmentStoreConfig } from './infrastructure/environment/environment-resolver';
+export { ForgeEnv } from './infrastructure/environment/forge-env';
+export type { IForgeEnv } from './infrastructure/environment/forge-env';
+export type { IEnvironmentConfigService } from './types/environment-config';
+export { VariableInterpolator, VariableResolver, createVariableResolver } from './infrastructure/environment/variable-interpolator';
+export type { VariableResolverConfig } from './infrastructure/environment/variable-interpolator';
+export { CollectionRequestExecutor } from './infrastructure/execution/collection-request-executor';
+export * from './infrastructure/execution/collection-request-executor-interfaces';
+export { RequestExecutor } from './infrastructure/execution/request-executor';
+export type { ExecuteOptions, ExecuteResult } from './infrastructure/execution/request-executor';
+export { RequestPreparer } from './infrastructure/execution/request-preparer';
+export * from './infrastructure/execution/request-preparer-interfaces';
+export * from './infrastructure/history/history-interfaces';
+export { RequestHistoryStore } from './infrastructure/history/request-history';
+export { RequestHistoryService } from './infrastructure/history/request-history-service';
+export type { IRequestHistoryService, IResponseStorage } from './infrastructure/history/request-history-service-interfaces';
+export * from './infrastructure/auth/interfaces';
+export { OAuth2TokenManager } from './infrastructure/auth/oauth2-token-manager';
+export { getCompletions, parseQueryContext } from './infrastructure/graphql/graphql-completion-provider';
+export type { CompletionItem, ContextType, QueryContext } from './infrastructure/graphql/graphql-completion-provider';
+export { GraphQLSchemaService } from './infrastructure/graphql/graphql-schema-service';
+export type { GraphQLDirective, GraphQLField, GraphQLOperation, GraphQLSchema, GraphQLType, IGraphQLSchemaService } from './infrastructure/graphql/graphql-schema-service';
+export { ExampleGenerator, HistoryAnalyzer, OpenApiExporter, OpenApiImporter, RefResolver, SchemaInferenceService, SchemaInferrer, ScriptAnalyzer } from './infrastructure/openapi';
+export type { OpenApiExportOptions, OpenApiImportOptions, ScriptAnalysisResult } from './infrastructure/openapi';
+export * from './infrastructure/openapi/interfaces';
+export { CONFIG_FILES, ConfigService, DEFAULT_CONFIG, ROOT_DIRECTORIES } from './infrastructure/config';
+export type { EnvironmentsConfig, HttpForgeConfig, IConfigService, ProxyConfig, RequestConfig, RestClientExportConfig, RunnerConfig, ScriptsConfig, StorageConfig } from './infrastructure/config';
+export { DEFAULT_SUITE_CONFIG } from './infrastructure/test-suite/interfaces';
+export type { ErrorSummary, IStatisticsService, ITestSuiteService, RequestStatistics, RunStatistics, RunSummary, SuiteConfig, SuiteRequest, TestSuite } from './infrastructure/test-suite/interfaces';
+export { HTTP_METHOD_MAP, HTTP_METHOD_REVERSE, buildResultFileName, expandSummary } from './infrastructure/test-suite/result-storage';
+export type { FullResultDetails, IResultStorageService, IndexPage, RecentError, RequestStats, ResultSummary, RunConfig, RunManifest, RunStats } from './infrastructure/test-suite/result-storage';
+export { ResultStorageService } from './infrastructure/test-suite/result-storage-service';
+export { StatisticsService } from './infrastructure/test-suite/statistics-service';
+export { TestSuiteService } from './infrastructure/test-suite/test-suite-service';
+export type { SuitesChangedCallback } from './infrastructure/test-suite/test-suite-service';
+export { TestSuiteStore } from './infrastructure/test-suite/test-suite-store';
+export type { ITestSuiteStore, SuiteRequestEntry } from './infrastructure/test-suite/test-suite-store';
+export { HttpForgeParser } from './infrastructure/parsers';
+export { parsePostmanEnvironment, parsePostmanEnvironmentFile } from './infrastructure/import-export/import-postman-environment';
+export type { ImportedEnvironment } from './infrastructure/import-export/import-postman-environment';
+export { exportCollectionToRestClient, getRestClientExportFolder, writeEnvFile, writeFolderItems, writeScriptFile } from './infrastructure/import-export/rest-client-export';
+export { DataFileParser } from './infrastructure/platform/data-file-parser';
+export type { IDataFileParser } from './infrastructure/platform/data-file-parser';
+export { NodeFileSystem } from './infrastructure/platform/node-file-system';
 export { DYNAMIC_VARIABLES, augmentWithDynamicVars, resolveDynamicVariable, resolveDynamicVariablesInString } from './utils/dynamic-variables';
 export { evaluateExpression, isExpression } from './utils/expression-evaluator';
 export { applyFilterChain, parseFilterChain } from './utils/filter-engine';