@http-forge/core 0.1.0

package/dist/services/forge-env.d.ts

@@ -0,0 +1,166 @@
+/**
+ * ForgeEnv - Unified Environment Service
+ *
+ * Combines environment variable storage with template resolution.
+ * This is the main interface for generated API clients to use.
+ *
+ * Features:
+ * - Variable storage (get/set)
+ * - Template resolution: {{variable}}
+ * - Path parameter resolution: :param, :param(regex), :param?
+ * - Object deep resolution
+ *
+ * @example
+ * ```typescript
+ * import { ForgeEnv } from '@http-forge/core';
+ *
+ * const env = ForgeEnv.create({
+ *     baseUrl: 'https://api.example.com',
+ *     apiKey: 'secret123',
+ * });
+ *
+ * // Template resolution
+ * env.resolve('{{baseUrl}}/users');  // 'https://api.example.com/users'
+ *
+ * // Path parameter resolution
+ * env.resolvePath('{{baseUrl}}/users/:id', { id: '123' });  // 'https://api.example.com/users/123'
+ *
+ * // Set/get variables
+ * env.set('token', 'abc');
+ * env.get('token');  // 'abc'
+ * ```
+ */
+import { IEnvironmentStore, IVariableInterpolator } from '../interfaces';
+import { EnvironmentResolver } from './environment-resolver';
+/**
+ * ForgeEnv interface - the public API for environment management
+ */
+export interface IForgeEnv {
+    /**
+     * Get a variable value
+     */
+    get(key: string): string | undefined;
+    /**
+     * Set a variable value
+     */
+    set(key: string, value: string): void;
+    /**
+     * Check if a variable exists
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a variable
+     */
+    delete(key: string): void;
+    /**
+     * Get all variables
+     */
+    getAll(): Record<string, string>;
+    /**
+     * Get the active environment name (e.g., 'dev', 'sit', 'prod')
+     */
+    getActiveEnvironment(): string | undefined;
+    /**
+     * Set the active environment by name
+     * @param name - Environment name (e.g., 'dev', 'sit', 'prod')
+     */
+    setActiveEnvironment(name: string): void;
+    /**
+     * Get list of available environment names
+     */
+    getEnvironments(): string[];
+    /**
+     * Resolve {{variable}} placeholders in a string
+     */
+    resolve(template: string): string;
+    /**
+     * Resolve {{variable}} and :pathParam placeholders in a URL
+     */
+    resolvePath(urlPattern: string, params?: Record<string, string>): string;
+    /**
+     * Build a complete URL with variables, path params, and query params
+     */
+    buildUrl(urlPattern: string, options?: {
+        params?: Record<string, string>;
+        query?: Record<string, string>;
+    }): string;
+    /**
+     * Resolve variables in an object recursively (deep)
+     */
+    resolveObject<T>(obj: T): T;
+    /**
+     * Extract variable names from a template string
+     */
+    extractVariables(template: string): string[];
+    /**
+     * Extract path parameter names from a URL pattern
+     */
+    extractPathParams(urlPattern: string): string[];
+}
+/**
+ * ForgeEnv implementation
+ */
+export declare class ForgeEnv implements IForgeEnv {
+    private readonly envStore;
+    private readonly interpolator;
+    private readonly urlBuilder;
+    constructor(envStore: IEnvironmentStore, interpolator?: IVariableInterpolator);
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    has(key: string): boolean;
+    delete(key: string): void;
+    getAll(): Record<string, string>;
+    /**
+     * Get the active environment name (e.g., 'dev', 'sit', 'prod')
+     */
+    getActiveEnvironment(): string | undefined;
+    /**
+     * Set the active environment by name
+     * @example
+     * ```typescript
+     * env.setActiveEnvironment('sit');  // Switch to SIT environment
+     * env.get('baseUrl');  // Now returns SIT's baseUrl
+     * ```
+     */
+    setActiveEnvironment(name: string): void;
+    /**
+     * Get list of available environment names
+     */
+    getEnvironments(): string[];
+    /**
+     * Resolve {{variable}} placeholders
+     */
+    resolve(template: string): string;
+    /**
+     * Resolve {{variable}} and :pathParam placeholders in a URL
+     */
+    resolvePath(urlPattern: string, params?: Record<string, string>): string;
+    /**
+     * Build a complete URL with all substitutions
+     */
+    buildUrl(urlPattern: string, options?: {
+        params?: Record<string, string>;
+        query?: Record<string, string>;
+    }): string;
+    /**
+     * Resolve variables in an object recursively
+     */
+    resolveObject<T>(obj: T): T;
+    /**
+     * Extract variable names from a template
+     */
+    extractVariables(template: string): string[];
+    /**
+     * Extract path parameter names from a URL pattern
+     */
+    extractPathParams(urlPattern: string): string[];
+    /**
+     * Create ForgeEnv from a simple variables object
+     */
+    static create(variables?: Record<string, string>): ForgeEnv;
+    /**
+     * Create ForgeEnv from an existing EnvironmentResolver
+     */
+    static fromResolver(resolver: EnvironmentResolver): ForgeEnv;
+}
+//# sourceMappingURL=forge-env.d.ts.map

package/dist/services/forge-env.d.ts.map

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

package/dist/services/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Core Services
+ *
+ * Export all service classes
+ */
+export { CollectionLoader } from './collection-loader';
+export type { LoadOptions } from './collection-loader';
+export { EnvironmentResolver } from './environment-resolver';
+export type { Environment, EnvironmentConfig } from './environment-resolver';
+export { FolderCollectionLoader } from './folder-collection-loader';
+export { ForgeEnv } from './forge-env';
+export type { IForgeEnv } from './forge-env';
+export { ParserRegistry } from './parser-registry';
+export { RequestExecutor } from './request-executor';
+export type { ExecuteOptions, ExecuteResult } from './request-executor';
+export { ScriptPipeline } from './script-pipeline';
+export { ScriptSession } from './script-session';
+export { UrlBuilder } from './url-builder';
+export type { IUrlBuilder } from './url-builder';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/services/parser-registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Parser Registry Service
+ *
+ * Open/Closed Principle: New parsers can be added without modifying existing code
+ * Single Responsibility: Manage collection parser registration and lookup
+ */
+import { ICollectionParser } from '../interfaces';
+/**
+ * Registry for collection parsers
+ * Allows registering parsers for different collection formats
+ */
+export declare class ParserRegistry {
+    private parsers;
+    /**
+     * Register a parser for a format
+     * @param format Format identifier (e.g., 'http-forge', 'postman', 'insomnia')
+     * @param parser Parser implementation
+     */
+    register(format: string, parser: ICollectionParser): void;
+    /**
+     * Get a parser by format
+     * @param format Format identifier
+     * @returns Parser or undefined if not found
+     */
+    get(format: string): ICollectionParser | undefined;
+    /**
+     * Check if a parser is registered for a format
+     * @param format Format identifier
+     */
+    has(format: string): boolean;
+    /**
+     * Get all registered format names
+     */
+    getFormats(): string[];
+    /**
+     * Try to detect format and find appropriate parser
+     * @param content Raw file content
+     * @returns Parser and detected format, or null if not recognized
+     */
+    detect(content: string): {
+        parser: ICollectionParser;
+        format: string;
+    } | null;
+    /**
+     * Clear all registered parsers
+     */
+    clear(): void;
+}
+//# sourceMappingURL=parser-registry.d.ts.map

package/dist/services/parser-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-registry.d.ts","sourceRoot":"","sources":["../../src/services/parser-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,OAAO,CAA6C;IAE5D;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAIzD;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIlD;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAS7E;;OAEG;IACH,KAAK,IAAI,IAAI;CAGhB"}

package/dist/services/request-executor.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Request Executor Service (Facade Pattern)
+ *
+ * Single Responsibility: Orchestrate the complete request execution flow
+ * Facade Pattern: Provides simplified interface to complex subsystem
+ */
+import { IHttpClient, IRequestPreprocessor } from '../interfaces';
+import { HttpRequest, HttpResponse, RequestOverrides, ScriptResult, UnifiedCollection, UnifiedRequest } from '../interfaces/types';
+import { IForgeEnv } from './forge-env';
+import { ScriptPipeline } from './script-pipeline';
+/**
+ * Options for request execution
+ */
+export interface ExecuteOptions {
+    /** Environment to use (defaults to active) */
+    environment?: string;
+    /** Override request properties */
+    overrides?: RequestOverrides;
+    /** Skip pre-request scripts */
+    skipPreRequest?: boolean;
+    /** Skip post-response scripts */
+    skipPostResponse?: boolean;
+    /** Additional variables to merge */
+    additionalVariables?: Record<string, string>;
+    /** Timeout override */
+    timeout?: number;
+}
+/**
+ * Complete execution result
+ */
+export interface ExecuteResult {
+    /** The HTTP response */
+    response: HttpResponse;
+    /** Pre-request script result */
+    preRequestResult?: ScriptResult;
+    /** Post-response script result (tests) */
+    postResponseResult?: ScriptResult;
+    /** Total execution time (ms) */
+    totalTime: number;
+    /** The final request after interpolation and script modifications */
+    finalRequest: HttpRequest;
+    /** Variables after execution */
+    variables: {
+        environment: Record<string, string>;
+        local: Record<string, string>;
+    };
+}
+/**
+ * Request Executor - Main execution engine
+ */
+export declare class RequestExecutor {
+    private readonly httpClient;
+    private readonly forgeEnv;
+    private readonly scriptPipeline;
+    private readonly preprocessor?;
+    private moduleLoader?;
+    constructor(httpClient: IHttpClient, forgeEnv: IForgeEnv, scriptPipeline: ScriptPipeline, preprocessor?: IRequestPreprocessor | undefined, options?: {
+        forgeRoot?: string;
+    });
+    /**
+     * Execute a request with full pipeline
+     * Uses ScriptSession for shared VM context between pre-request and post-response scripts
+     */
+    execute(request: UnifiedRequest, collection: UnifiedCollection, options?: ExecuteOptions): Promise<ExecuteResult>;
+    /**
+     * Execute a simple request without collection context
+     */
+    executeSimple(request: HttpRequest, options?: {
+        variables?: Record<string, string>;
+        timeout?: number;
+    }): Promise<HttpResponse>;
+    /**
+     * Build HttpRequest from UnifiedRequest
+     */
+    private buildHttpRequest;
+    /**
+     * Interpolate variables in request using ForgeEnv
+     * Handles both {{variable}} and :pathParam patterns in URL
+     */
+    private interpolateRequest;
+    /**
+     * Create script context
+     */
+    private createScriptContext;
+}
+//# sourceMappingURL=request-executor.d.ts.map

package/dist/services/request-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-executor.d.ts","sourceRoot":"","sources":["../../src/services/request-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACH,WAAW,EACX,YAAY,EACZ,gBAAgB,EAEhB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAY,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,+BAA+B;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oCAAoC;IACpC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,wBAAwB;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,YAAY,CAAC;IAClC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,EAAE,WAAW,CAAC;IAC1B,gCAAgC;IAChC,SAAS,EAAE;QACP,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;CACL;AAED;;GAEG;AACH,qBAAa,eAAe;IAIpB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IANlC,OAAO,CAAC,YAAY,CAAC,CAAe;gBAGf,UAAU,EAAE,WAAW,EACvB,QAAQ,EAAE,SAAS,EACnB,cAAc,EAAE,cAAc,EAC9B,YAAY,CAAC,EAAE,oBAAoB,YAAA,EACpD,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAQpC;;;OAGG;IACG,OAAO,CACT,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,aAAa,CAAC;IAyGzB;;OAEG;IACG,aAAa,CACf,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,OAAO,CAAC,EAAE,MAAM,CAAC;KACf,GACP,OAAO,CAAC,YAAY,CAAC;IAYxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoDxB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAoB9B"}

package/dist/services/script-pipeline.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Script Pipeline Service
+ *
+ * Single Responsibility: Manage script execution chain
+ */
+import { IScriptPipeline, IScriptRunner } from '../interfaces';
+import { ScriptContext, ScriptResult, UnifiedCollection, UnifiedFolder, UnifiedRequest } from '../interfaces/types';
+/**
+ * Script pipeline that executes scripts in proper order
+ */
+export declare class ScriptPipeline implements IScriptPipeline {
+    private readonly scriptRunner;
+    constructor(scriptRunner: IScriptRunner);
+    /**
+     * Build script chain for a request
+     * Returns scripts in execution order: collection → folders → request
+     */
+    buildChain(request: UnifiedRequest, collection: UnifiedCollection, folderPath?: UnifiedFolder[]): {
+        preRequest: string[];
+        postResponse: string[];
+    };
+    /**
+     * Execute pre-request scripts
+     * Returns combined result with all modifications
+     */
+    executePreRequest(scripts: string[], context: ScriptContext): Promise<ScriptResult>;
+    /**
+     * Execute post-response scripts (tests)
+     * Returns combined result with all assertions
+     */
+    executePostResponse(scripts: string[], context: ScriptContext): Promise<ScriptResult>;
+    /**
+     * Find the folder path from collection root to a request
+     * Returns array of folders in order from root to parent
+     */
+    findFolderPath(collection: UnifiedCollection, requestId: string): UnifiedFolder[];
+    /**
+     * Execute full script pipeline for a request
+     * Convenience method that builds chain and executes scripts
+     */
+    execute(request: UnifiedRequest, collection: UnifiedCollection, context: ScriptContext, phase: 'preRequest' | 'postResponse'): Promise<ScriptResult>;
+}
+//# sourceMappingURL=script-pipeline.d.ts.map

package/dist/services/script-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-pipeline.d.ts","sourceRoot":"","sources":["../../src/services/script-pipeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EACH,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,cAAc,EACjB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,qBAAa,cAAe,YAAW,eAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,aAAa;IAExD;;;OAGG;IACH,UAAU,CACN,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,iBAAiB,EAC7B,UAAU,GAAE,aAAa,EAAO,GACjC;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE;IAiCnD;;;OAGG;IACG,iBAAiB,CACnB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,aAAa,GACvB,OAAO,CAAC,YAAY,CAAC;IAWxB;;;OAGG;IACG,mBAAmB,CACrB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,aAAa,GACvB,OAAO,CAAC,YAAY,CAAC;IAWxB;;;OAGG;IACH,cAAc,CACV,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,MAAM,GAClB,aAAa,EAAE;IAwBlB;;;OAGG;IACG,OAAO,CACT,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,YAAY,GAAG,cAAc,GACrC,OAAO,CAAC,YAAY,CAAC;CAU3B"}

package/dist/services/script-session.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Script Session
+ *
+ * Single Responsibility: Manage shared VM context between pre-request and post-response scripts
+ *
+ * This class creates a single VM sandbox that persists across both script phases,
+ * allowing JavaScript variables declared in pre-request to be accessible in post-response.
+ * This matches Postman's behavior for per-request script execution.
+ */
+import { ModuleLoader } from '../implementations/module-loader';
+import { IHttpClient } from '../interfaces';
+import { HttpResponse, ScriptContext, ScriptResult } from '../interfaces/types';
+/**
+ * Script Session - manages shared VM context for request execution
+ */
+export declare class ScriptSession {
+    private readonly context;
+    private readonly options;
+    private vm;
+    private consoleMessages;
+    private assertions;
+    private modifiedRequest;
+    private modifiedGlobals;
+    private modifiedCollectionVariables;
+    private modifiedEnvironment;
+    private modifiedVariables;
+    private ctx;
+    constructor(context: ScriptContext, options?: {
+        timeout?: number;
+        httpClient?: IHttpClient;
+        moduleLoader?: ModuleLoader;
+    });
+    /**
+     * Initialize the shared VM context
+     */
+    private initializeVM;
+    /**
+     * Execute pre-request scripts
+     */
+    executePreRequest(scripts: string[]): Promise<ScriptResult>;
+    /**
+     * Execute post-response scripts
+     */
+    executePostResponse(scripts: string[], response: HttpResponse): Promise<ScriptResult>;
+    /**
+     * Get the modified request after pre-request scripts
+     */
+    getModifiedRequest(): {
+        url: string;
+        method: string;
+        headers: Record<string, string>;
+        body: any;
+    };
+    /**
+     * Dispose the session
+     */
+    dispose(): void;
+    private createRequestObject;
+    private createResponseObject;
+    private createVariableScope;
+    private createEnvironmentScope;
+    private createMergedVariableScope;
+    private createSendRequest;
+    private createBuiltinOnlyRequire;
+}
+//# sourceMappingURL=script-session.d.ts.map

package/dist/services/script-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-session.d.ts","sourceRoot":"","sources":["../../src/services/script-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAiB,MAAM,qBAAqB,CAAC;AA4D/F;;GAEG;AACH,qBAAa,aAAa;IAqBlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IArB5B,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,UAAU,CAAuB;IAGzC,OAAO,CAAC,eAAe,CAKrB;IACF,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,2BAA2B,CAAyB;IAC5D,OAAO,CAAC,mBAAmB,CAAyB;IACpD,OAAO,CAAC,iBAAiB,CAAyB;IAGlD,OAAO,CAAC,GAAG,CAAM;gBAGI,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,WAAW,CAAC;QACzB,YAAY,CAAC,EAAE,YAAY,CAAC;KAC1B;IAoBV;;OAEG;IACH,OAAO,CAAC,YAAY;IAyHpB;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAqCjE;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IA4C3F;;OAEG;IACH,kBAAkB;aA7PT,MAAM;gBACH,MAAM;iBACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cACzB,GAAG;;IA8Pb;;OAEG;IACH,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,mBAAmB;IAiD3B,OAAO,CAAC,oBAAoB;IAoH5B,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,yBAAyB;IAiCjC,OAAO,CAAC,iBAAiB;IAqCzB,OAAO,CAAC,wBAAwB;CAqBnC"}

package/dist/services/url-builder.d.ts

@@ -0,0 +1,60 @@
+/**
+ * URL Builder Service
+ *
+ * Single Responsibility: Build URLs with variable and path parameter substitution
+ *
+ * Handles:
+ * - Template variable replacement: {{variable}}
+ * - Path parameter replacement: :param, :param(regex), :param?
+ * - Query string building and merging
+ */
+import { IVariableInterpolator } from '../interfaces';
+/**
+ * URL Builder interface
+ */
+export interface IUrlBuilder {
+    /**
+     * Build a complete URL with variable and path parameter substitution
+     * @param urlPattern - URL pattern with {{vars}} and :params
+     * @param variables - Variables for {{var}} replacement
+     * @param params - Path parameters for :param replacement
+     * @param query - Query parameters to append
+     */
+    buildUrl(urlPattern: string, variables: Record<string, string>, params?: Record<string, string>, query?: Record<string, string>): string;
+    /**
+     * Replace only path parameters (:param) in a URL
+     */
+    replacePathParams(url: string, params: Record<string, string>): string;
+    /**
+     * Extract path parameter names from a URL pattern
+     */
+    extractPathParams(urlPattern: string): string[];
+}
+/**
+ * URL Builder implementation
+ */
+export declare class UrlBuilder implements IUrlBuilder {
+    private readonly interpolator;
+    constructor(interpolator: IVariableInterpolator);
+    /**
+     * Build a complete URL with all substitutions
+     */
+    buildUrl(urlPattern: string, variables: Record<string, string>, params?: Record<string, string>, query?: Record<string, string>): string;
+    /**
+     * Replace path parameters in URL
+     * Supports:
+     * - :param - required parameter
+     * - :param? - optional parameter
+     * - :param(regex) - parameter with validation regex (regex is ignored, just for documentation)
+     */
+    replacePathParams(url: string, params: Record<string, string>): string;
+    /**
+     * Extract path parameter names from a URL pattern
+     */
+    extractPathParams(urlPattern: string): string[];
+    /**
+     * Append query parameters to URL
+     */
+    private appendQueryParams;
+}
+//# sourceMappingURL=url-builder.d.ts.map

package/dist/services/url-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.d.ts","sourceRoot":"","sources":["../../src/services/url-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB;;;;;;OAMG;IACH,QAAQ,CACJ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAAC;IAEV;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IAEvE;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACnD;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,WAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,qBAAqB;IAEhE;;OAEG;IACH,QAAQ,CACJ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACnC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,MAAM;IAaT;;;;;;OAMG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAwDtE;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAY/C;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA0C5B"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@http-forge/core",
+  "version": "0.1.0",
+  "description": "HTTP Forge Core - API Test Execution Engine",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npm run clean && node esbuild.config.js",
+    "build:prod": "npm run clean && node esbuild.config.js --production",
+    "prepublishOnly": "npm run build:prod",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src",
+    "clean": "rimraf dist"
+  },
+  "keywords": [
+    "http",
+    "api",
+    "testing",
+    "postman",
+    "collection",
+    "http-forge"
+  ],
+  "author": "Henry Huang",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hsl1230/http-forge",
+    "directory": "packages/core"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "ajv": "^8.12.0",
+    "lodash": "^4.17.21",
+    "moment": "^2.30.1",
+    "tv4": "^1.3.0",
+    "uuid": "^9.0.1",
+    "vm2": "^3.9.19"
+  },
+  "devDependencies": {
+    "@types/lodash": "^4.14.202",
+    "@types/node": "^20.10.0",
+    "@types/tv4": "^1.2.33",
+    "@types/uuid": "^9.0.7",
+    "rimraf": "^5.0.5",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.0",
+    "vitest": "^1.1.0"
+  }
+}