@http-forge/core 0.2.13 → 0.2.15

package/dist/infrastructure/collection/collection-service.d.ts

@@ -59,6 +59,7 @@ export declare class CollectionService implements ICollectionService {
     private collectRequestsRecursive;
     createCollection(name: string): Promise<Collection>;
     renameCollection(id: string, newName: string): Promise<boolean>;
+    duplicateCollection(sourceId: string, newName: string): Promise<Collection>;
     createFolder(options: {
         name: string;
         collectionId: string;
@@ -66,11 +67,13 @@ export declare class CollectionService implements ICollectionService {
     }): Promise<CollectionItem>;
     deleteFolder(collectionId: string, folderId: string): Promise<boolean>;
     renameFolder(collectionId: string, folderId: string, newName: string): Promise<boolean>;
+    duplicateFolder(collectionId: string, folderId: string, newName: string): Promise<CollectionItem>;
     createRequest(options: CreateRequestOptions): Promise<CollectionRequestItem>;
     renameRequest(collectionId: string, requestId: string, newName: string): Promise<boolean>;
     moveItem(collectionId: string, itemId: string, newParentId?: string): Promise<boolean>;
     reorderItems(collectionId: string, parentId: string | undefined, orderedItemIds: string[]): Promise<boolean>;
     private findItemById;
+    private copyDirRecursive;
     private deleteItemById;
     importCollection(filePath: string): Promise<Collection>;
     private importPostmanCollection;

package/dist/infrastructure/collection/collection-store.d.ts

@@ -6,8 +6,8 @@
  * - JsonCollectionLoader: Loads from single JSON files
  * - FolderCollectionStore: Loads from directory structure
  */
-import type { CollectionRequest } from '../../types/types';
 import type { Collection, CollectionItem, RequestScripts } from '../../types/collection';
+import type { CollectionRequest } from '../../types/types';
 /**
  * Rich interface for loading, saving, and managing collections
  */
@@ -78,6 +78,10 @@ export interface ICollectionStore {
      * Load scripts for a specific item
      */
     loadScripts(collectionId: string, itemId: string): RequestScripts | undefined;
+    /**
+     * Get the disk path of an item (folder or request) within a collection
+     */
+    getItemPath(collectionId: string, itemId: string): string | undefined;
 }
 /**
  * Metadata stored in collection.json for folder format

package/dist/infrastructure/collection/folder-collection-store.d.ts

@@ -129,6 +129,10 @@ export declare class FolderCollectionStore implements ICollectionStore {
      * Get the path for a collection
      */
     getCollectionPath(id: string): string;
+    /**
+     * Get the disk path of an item (folder or request) within a collection
+     */
+    getItemPath(collectionId: string, itemId: string): string | undefined;
     /**
      * Create a new collection
      */

package/dist/infrastructure/collection/folder-io.d.ts

@@ -49,6 +49,7 @@ export interface ScriptsData {
 export declare function readScriptsFromDir(scriptsPath: string): ScriptsData | undefined;
 /**
  * Write scripts to a scripts/ directory.
+ * If a script is empty/undefined, the corresponding file is deleted.
  */
 export declare function writeScriptsToDir(scriptsPath: string, scripts: ScriptsData): Promise<void>;
 /**

package/dist/infrastructure/collection/json-collection-loader.d.ts

@@ -45,6 +45,11 @@ export declare class JsonCollectionLoader implements ICollectionStore {
      * Get the file path for a collection
      */
     getCollectionPath(id: string): string;
+    /**
+     * Get the disk path of an item within a collection
+     * JSON format stores everything in one file, so items don't have individual paths
+     */
+    getItemPath(_collectionId: string, _itemId: string): string | undefined;
     /**
      * Create a new collection
      */

package/dist/infrastructure/test-suite/interfaces.d.ts

@@ -23,6 +23,8 @@ export interface SuiteRequest {
     folderPath: string;
     /** Whether this request is enabled for execution */
     enabled?: boolean;
+    /** Optional description of what this request does in the suite */
+    description?: string;
 }
 /**
  * Test Suite run configuration

package/dist/types/collection.d.ts

@@ -73,6 +73,7 @@ export interface ICollectionReader {
  */
 export interface ICollectionWriter {
     createCollection(name: string): Promise<Collection>;
+    duplicateCollection(sourceId: string, newName: string): Promise<Collection>;
     saveCollection(collection: Collection): Promise<void>;
     deleteCollection(id: string): Promise<boolean>;
     renameCollection(id: string, newName: string): Promise<boolean>;
@@ -91,6 +92,7 @@ export interface IRequestManager {
  */
 export interface IFolderManager {
     createFolder(options: CreateFolderOptions): Promise<CollectionItem>;
+    duplicateFolder(collectionId: string, folderId: string, newName: string): Promise<CollectionItem>;
     deleteFolder(collectionId: string, folderId: string): Promise<boolean>;
     renameFolder(collectionId: string, folderId: string, newName: string): Promise<boolean>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@http-forge/core",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "Headless HTTP testing engine with Postman collection support, dynamic variables, and script-based automation.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/dist/application/dto/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Application DTOs
- *
- * Data Transfer Objects decouple use-case inputs/outputs
- * from domain internals and infrastructure types.
- */
-export type { CreateRequestInput, UpdateRequestInput, DeleteRequestInput, ListRequestsInput, GetCollectionInput, ExecuteRequestInput, LoadCollectionInput, SaveCollectionInput, ExportCollectionInput, GetRequestSchemaInput, ExportFormat, } from './request-dtos';
-export type { RequestSummaryDto, RequestDetailDto, CollectionSummaryDto, CollectionDetailDto, CollectionItemDto, ScriptResultDto, AssertionResultDto, ExecuteRequestOutput, RequestSchemaOutput, CreateRequestOutput, UpdateRequestOutput, DeleteRequestOutput, SaveCollectionOutput, ExportCollectionOutput, LoadCollectionOutput, ListRequestsOutput, GetCollectionOutput, } from './response-dtos';

package/dist/application/dto/request-dtos.d.ts

@@ -1,105 +0,0 @@
-/**
- * Application DTOs — Request Input Types
- *
- * Standardized input objects for all use-cases.
- * These decouple the public API from internal domain types.
- */
-import { BodySchemaDefinition, KeyValueEntry, PathParamEntry, RequestBody, RequestScripts, RequestSettings, ResponseSchemaDefinition } from '../../types/types';
-export interface CreateRequestInput {
-    collectionId: string;
-    name: string;
-    method: string;
-    url: string;
-    description?: string;
-    /** Headers with enabled/disabled flag */
-    headers?: KeyValueEntry[];
-    /** Query parameters with enabled/disabled flag */
-    query?: KeyValueEntry[];
-    /** Path parameters */
-    params?: Record<string, string | PathParamEntry>;
-    /** Request body - supports raw, form-data, url-encoded, graphql, binary, or none */
-    body?: RequestBody;
-    /** Content-Type override */
-    bodyContentType?: string;
-    /** Request-level settings */
-    settings?: RequestSettings;
-    /** Request scripts (pre/post) */
-    scripts?: RequestScripts;
-    /** Authentication config (basic, bearer, apikey - no oauth2 at collection level) */
-    auth?: any;
-    /** Mark as disabled */
-    disabled?: boolean;
-    /** Mark as deprecated */
-    deprecated?: boolean;
-    /** Response schema */
-    responseSchema?: ResponseSchemaDefinition;
-    /** Body schema */
-    bodySchema?: BodySchemaDefinition;
-}
-export interface UpdateRequestInput {
-    collectionId: string;
-    requestId: string;
-    name?: string;
-    method?: string;
-    url?: string;
-    description?: string;
-    /** Headers with enabled/disabled flag */
-    headers?: KeyValueEntry[];
-    /** Query parameters with enabled/disabled flag */
-    query?: KeyValueEntry[];
-    /** Path parameters */
-    params?: Record<string, string | PathParamEntry>;
-    /** Request body - supports raw, form-data, url-encoded, graphql, binary, or none */
-    body?: RequestBody;
-    /** Content-Type override */
-    bodyContentType?: string;
-    /** Request-level settings */
-    settings?: RequestSettings;
-    /** Request scripts (pre/post) */
-    scripts?: RequestScripts;
-    /** Authentication config (basic, bearer, apikey - no oauth2 at collection level) */
-    auth?: any;
-    /** Mark as disabled */
-    disabled?: boolean;
-    /** Mark as deprecated */
-    deprecated?: boolean;
-    /** Response schema */
-    responseSchema?: ResponseSchemaDefinition;
-    /** Body schema */
-    bodySchema?: BodySchemaDefinition;
-}
-export interface DeleteRequestInput {
-    collectionId: string;
-    requestId: string;
-}
-export interface ListRequestsInput {
-    collectionId: string;
-}
-export interface GetCollectionInput {
-    collectionId: string;
-}
-export interface ExecuteRequestInput {
-    collectionId: string;
-    requestId: string;
-    overrides?: {
-        variables?: Record<string, any>;
-        environment?: Record<string, any>;
-    };
-}
-export interface LoadCollectionInput {
-    filePath: string;
-}
-export interface SaveCollectionInput {
-    filePath: string;
-    collectionId: string;
-}
-export type ExportFormat = 'postman' | 'openapi';
-export interface ExportCollectionInput {
-    collectionId: string;
-    format: ExportFormat;
-    outputPath: string;
-}
-export interface GetRequestSchemaInput {
-    collectionId: string;
-    requestId: string;
-}

package/dist/application/dto/response-dtos.d.ts

@@ -1,185 +0,0 @@
-/**
- * Application DTOs — Response Output Types
- *
- * Standardized output objects for all use-cases.
- * These shield consumers from internal domain model changes.
- */
-import { BodySchemaDefinition, KeyValueEntry, RequestBody, RequestScripts, RequestSettings, ResponseSchemaDefinition } from '../../types/types';
-export interface RequestSummaryDto {
-    id: string;
-    name: string;
-    method: string;
-    url: string;
-    description?: string;
-    disabled?: boolean;
-    deprecated?: boolean;
-}
-export interface RequestDetailDto {
-    id: string;
-    name: string;
-    method: string;
-    url: string;
-    description?: string;
-    /** Headers with per-header enabled/disabled flag */
-    headers: KeyValueEntry[];
-    /** Query parameters with per-item enabled/disabled flag */
-    query: KeyValueEntry[];
-    body?: RequestBody;
-    bodyContentType?: string;
-    auth?: any;
-    settings?: RequestSettings;
-    scripts?: RequestScripts;
-    disabled?: boolean;
-    deprecated?: boolean;
-    responseSchema?: ResponseSchemaDefinition;
-    bodySchema?: BodySchemaDefinition;
-    hasPreScript: boolean;
-    hasPostScript: boolean;
-}
-export interface CollectionSummaryDto {
-    id: string;
-    name: string;
-    description?: string;
-    requestCount: number;
-    folderCount: number;
-}
-export interface CollectionItemDto {
-    id: string;
-    name: string;
-    type: 'request' | 'folder';
-    method?: string;
-    url?: string;
-    childCount?: number;
-}
-export interface CollectionDetailDto {
-    id: string;
-    name: string;
-    description?: string;
-    items: CollectionItemDto[];
-    requestCount: number;
-    folderCount: number;
-    meta?: Record<string, any>;
-}
-/**
- * Full Collection Detail with all nested request/folder metadata
- * Used by LoadCollectionUseCase to return COMPLETE data (not filtered)
- */
-export interface CollectionFullDetailDto {
-    id: string;
-    name: string;
-    description?: string;
-    /** Full nested structure with all request/folder metadata preserved */
-    items: (CollectionFullItemDto)[];
-    variables?: Record<string, string>;
-    auth?: any;
-    scripts?: RequestScripts;
-    meta?: Record<string, any>;
-}
-/**
- * Full collection item (request or folder) with ALL metadata
- */
-export type CollectionFullItemDto = CollectionFullRequestDto | CollectionFullFolderDto;
-/**
- * Full request DTO with all fields preserved (headers, query, body, scripts, etc.)
- */
-export interface CollectionFullRequestDto {
-    type: 'request';
-    id: string;
-    name: string;
-    method: string;
-    url: string;
-    description?: string;
-    headers: KeyValueEntry[];
-    query: KeyValueEntry[];
-    body?: RequestBody;
-    bodyContentType?: string;
-    auth?: any;
-    settings?: RequestSettings;
-    scripts?: RequestScripts;
-    disabled?: boolean;
-    deprecated?: boolean;
-    responseSchema?: ResponseSchemaDefinition;
-    bodySchema?: BodySchemaDefinition;
-}
-/**
- * Full folder DTO with nested items preserved
- */
-export interface CollectionFullFolderDto {
-    type: 'folder';
-    id: string;
-    name: string;
-    description?: string;
-    auth?: any;
-    scripts?: RequestScripts;
-    items: (CollectionFullItemDto)[];
-}
-export interface ScriptResultDto {
-    success: boolean;
-    output?: any;
-    errors: string[];
-}
-export interface AssertionResultDto {
-    name: string;
-    passed: boolean;
-    expected?: any;
-    actual?: any;
-    message?: string;
-}
-export interface ExecuteRequestOutput {
-    requestId: string;
-    status: 'success' | 'failed' | 'partial';
-    duration: number;
-    response: {
-        status: number;
-        statusText: string;
-        headers: Record<string, string | string[]>;
-        bodySize?: number;
-    };
-    preScriptResult?: ScriptResultDto;
-    postScriptResult?: ScriptResultDto & {
-        assertions?: AssertionResultDto[];
-    };
-    variableChanges?: Record<string, any>;
-    error?: string;
-}
-export interface RequestSchemaOutput {
-    requestId: string;
-    schema: any;
-    sources: ('user' | 'history' | 'script')[];
-    confidence: 'high' | 'medium' | 'low';
-}
-export interface CreateRequestOutput {
-    request: RequestDetailDto;
-}
-export interface UpdateRequestOutput {
-    request: RequestDetailDto;
-}
-export interface DeleteRequestOutput {
-    requestId: string;
-    collectionId: string;
-    deletedAt: string;
-}
-export interface SaveCollectionOutput {
-    filePath: string;
-    collectionName: string;
-    savedAt: string;
-}
-export interface ExportCollectionOutput {
-    collectionId: string;
-    format: string;
-    outputPath: string;
-    exportedAt: string;
-}
-export interface LoadCollectionOutput {
-    /** Full collection with ALL nested metadata preserved */
-    collection: CollectionFullDetailDto;
-    loadedFrom: string;
-}
-export interface ListRequestsOutput {
-    collectionId: string;
-    requests: RequestSummaryDto[];
-    total: number;
-}
-export interface GetCollectionOutput {
-    collection: CollectionDetailDto;
-}

package/dist/application/events/application-events.d.ts

@@ -1,53 +0,0 @@
-/**
- * Application Events
- *
- * Higher-level events published by use-cases to notify the outer system
- * (e.g. VS Code extension, CLI) about completed operations.
- *
- * These are distinct from domain events:
- * - Domain events: model business invariants (RequestExecutedEvent, VariableUpdatedEvent)
- * - Application events: notify about user actions (RequestCreatedEvent, CollectionExportedEvent)
- */
-import { DomainEvent } from '../../domain/services/domain-events';
-export declare class RequestCreatedEvent extends DomainEvent {
-    readonly collectionId: string;
-    readonly name: string;
-    readonly method: string;
-    readonly url: string;
-    constructor(requestId: string, collectionId: string, name: string, method: string, url: string);
-}
-export declare class RequestUpdatedEvent extends DomainEvent {
-    readonly collectionId: string;
-    readonly changes: string[];
-    constructor(requestId: string, collectionId: string, changes: string[]);
-}
-export declare class RequestDeletedEvent extends DomainEvent {
-    readonly collectionId: string;
-    constructor(requestId: string, collectionId: string);
-}
-export declare class CollectionLoadedEvent extends DomainEvent {
-    readonly name: string;
-    readonly source: string;
-    readonly requestCount: number;
-    constructor(collectionId: string, name: string, source: string, // file path or identifier
-    requestCount: number);
-}
-export declare class CollectionSavedEvent extends DomainEvent {
-    readonly name: string;
-    readonly filePath: string;
-    constructor(collectionId: string, name: string, filePath: string);
-}
-export declare class CollectionExportedEvent extends DomainEvent {
-    readonly format: string;
-    readonly outputPath: string;
-    constructor(collectionId: string, format: string, outputPath: string);
-}
-export declare const ApplicationEventTypes: {
-    readonly REQUEST_CREATED: "REQUEST_CREATED";
-    readonly REQUEST_UPDATED: "REQUEST_UPDATED";
-    readonly REQUEST_DELETED: "REQUEST_DELETED";
-    readonly COLLECTION_LOADED: "COLLECTION_LOADED";
-    readonly COLLECTION_SAVED: "COLLECTION_SAVED";
-    readonly COLLECTION_EXPORTED: "COLLECTION_EXPORTED";
-};
-export type ApplicationEventType = typeof ApplicationEventTypes[keyof typeof ApplicationEventTypes];

package/dist/application/events/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Application Events
- *
- * Events published by use-cases to notify about completed user actions.
- */
-export { RequestCreatedEvent, RequestUpdatedEvent, RequestDeletedEvent, CollectionLoadedEvent, CollectionSavedEvent, CollectionExportedEvent, ApplicationEventTypes, type ApplicationEventType, } from './application-events';

package/dist/application/index.d.ts

@@ -1,25 +0,0 @@
-/**
- * Application Layer - Use Cases and Queries
- *
- * Contains:
- * - Use Cases (commands that modify state)
- * - Queries (read-only operations)
- * - Data Transfer Objects (DTOs)
- * - Application Events
- * - Mappers (domain ↔ DTO conversion)
- *
- * Constraints:
- * - Depends on Domain and Ports layers
- * - Orchestrates between Domain and Infrastructure
- * - Never directly depends on Infrastructure implementations
- *
- * Usage:
- * - Called by controllers/handlers
- * - Uses repositories and executors from ports
- * - Publishes domain events
- */
-export * from './use-cases';
-export * from './queries';
-export * from './dto';
-export * from './events';
-export * from './mappers';

package/dist/application/mappers/collection-mapper.d.ts

@@ -1,39 +0,0 @@
-/**
- * CollectionMapper
- *
- * Maps between UnifiedCollection (domain/infrastructure type) and
- * application-layer DTOs (CollectionDetailDto, CollectionSummaryDto, CollectionFullDetailDto).
- *
- * Provides two mapping strategies:
- * - toDetail() / toSummary() - Filtered summaries for list/UI views
- * - toFullDetail() - Complete metadata for full collection operations (load, edit)
- */
-import { UnifiedCollection } from '../../types/types';
-import { CollectionDetailDto, CollectionFullDetailDto, CollectionSummaryDto } from '../dto/response-dtos';
-export declare class CollectionMapper {
-    /**
-     * Map domain collection to a summary DTO
-     */
-    static toSummary(collection: UnifiedCollection): CollectionSummaryDto;
-    /**
-     * Map domain collection to a full detail DTO
-     */
-    static toDetail(collection: UnifiedCollection): CollectionDetailDto;
-    /**
-     * Map domain collection to a full detail DTO (preserves ALL metadata)
-     * Used by LoadCollectionUseCase to return complete collection with all fields
-     */
-    static toFullDetail(collection: UnifiedCollection): CollectionFullDetailDto;
-    /**
-     * Map top-level items to full detail items (preserves ALL metadata per request/folder)
-     */
-    private static toFullItems;
-    /**
-     * Map top-level items to flat CollectionItemDto list
-     */
-    private static mapItems;
-    /**
-     * Recursively count requests and folders
-     */
-    private static countItems;
-}

package/dist/application/mappers/execution-result-mapper.d.ts

@@ -1,16 +0,0 @@
-/**
- * ExecutionResultMapper
- *
- * Maps between IExecutionResult (domain model) and
- * ExecuteRequestOutput (application DTO).
- */
-import { IExecutionResult } from '../../domain/models/execution';
-import { ExecuteRequestOutput } from '../dto/response-dtos';
-export declare class ExecutionResultMapper {
-    /**
-     * Map domain execution result to application-layer output DTO
-     */
-    static toOutput(result: IExecutionResult): ExecuteRequestOutput;
-    private static mapScriptResult;
-    private static mapAssertion;
-}

package/dist/application/mappers/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * Application Mappers
- *
- * Convert between domain types and application DTOs.
- * Mappers formalize the boundary between layers.
- */
-export { RequestMapper } from './request-mapper';
-export { CollectionMapper } from './collection-mapper';
-export { ExecutionResultMapper } from './execution-result-mapper';

package/dist/application/mappers/request-mapper.d.ts

@@ -1,29 +0,0 @@
-/**
- * RequestMapper
- *
- * Maps between UnifiedRequest (domain/infrastructure type) and
- * application-layer DTOs (RequestDetailDto, RequestSummaryDto).
- *
- * Preserves all metadata including enabled/disabled flags and schemas.
- */
-import { UnifiedRequest } from '../../types/types';
-import { RequestDetailDto, RequestSummaryDto } from '../dto/response-dtos';
-export declare class RequestMapper {
-    /**
-     * Map domain request to a lightweight summary DTO
-     */
-    static toSummary(request: UnifiedRequest): RequestSummaryDto;
-    /**
-     * Map domain request to a full detail DTO
-     * PRESERVES all metadata including enabled/disabled headers and schemas
-     */
-    static toDetail(request: UnifiedRequest): RequestDetailDto;
-    /**
-     * Map multiple requests to summaries
-     */
-    static toSummaryList(requests: UnifiedRequest[]): RequestSummaryDto[];
-    /**
-     * Map multiple requests to details
-     */
-    static toDetailList(requests: UnifiedRequest[]): RequestDetailDto[];
-}

package/dist/application/queries/get-request-schema.query.d.ts

@@ -1,32 +0,0 @@
-/**
- * Get Request Schema Query
- *
- * Retrieves inferred response schema for a request
- * Merges information from: user definition, history, script hints
- */
-import { IRequestRepository } from '../../ports/repositories/request-repository.interface';
-import { IHistoryLoader } from '../../ports/storage/history-loader.interface';
-import { ResponseSchema } from '../../domain/services/schema-inference.domain-service';
-import { ILogger } from '../../ports/external/logger.interface';
-/**
- * Query: Get request response schema
- */
-export declare class GetRequestSchemaQuery {
-    private requestRepository;
-    private historyLoader;
-    private logger;
-    private schemaInference;
-    constructor(requestRepository: IRequestRepository, historyLoader: IHistoryLoader, logger: ILogger);
-    /**
-     * Get combined response schema for a request
-     */
-    execute(collectionId: string, requestId: string): Promise<ResponseSchema>;
-    /**
-     * Infer schema from historical responses
-     */
-    private inferFromHistory;
-    /**
-     * Extract property hints from post-response script
-     */
-    private extractScriptHints;
-}

package/dist/application/queries/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Application Queries
- *
- * Read-only operations
- */
-export * from './get-request-schema.query';

package/dist/application/use-cases/create-request.use-case.d.ts

@@ -1,23 +0,0 @@
-/**
- * Create Request Use Case
- *
- * Creates a new HTTP request in a collection
- * Supports full request metadata including enabled/disabled headers, schemas, etc.
- */
-import { IDomainEventPublisher } from '../../domain/services/domain-events';
-import { ILogger } from '../../ports/external/logger.interface';
-import { ICollectionRepository } from '../../ports/repositories/collection-repository.interface';
-import { CreateRequestInput } from '../dto/request-dtos';
-import { CreateRequestOutput } from '../dto/response-dtos';
-export type { CreateRequestInput } from '../dto/request-dtos';
-/**
- * Use Case: Create a new request in collection
- */
-export declare class CreateRequestUseCase {
-    private collectionRepository;
-    private eventPublisher;
-    private logger;
-    constructor(collectionRepository: ICollectionRepository, eventPublisher: IDomainEventPublisher, logger: ILogger);
-    execute(input: CreateRequestInput): Promise<CreateRequestOutput>;
-    private generateId;
-}