@http-forge/core 0.2.3 → 0.2.5

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

@@ -8,9 +8,9 @@
  * - ConfigService for configuration
  * - CollectionLoader for storage abstraction (supports folder and json formats)
  */
-import { IConfigService } from '../config';
-import { IFileWatcherFactory } from '../../types/platform';
 import type { Collection, CollectionItem, CollectionRequestItem, CreateRequestOptions, ICollectionService } from '../../types/collection';
+import { IFileWatcherFactory } from '../../types/platform';
+import { IConfigService } from '../config';
 /**
  * Service for managing HTTP Forge collections
  */
@@ -26,6 +26,11 @@ export declare class CollectionService implements ICollectionService {
      * In-memory Local Values for collection variables (not persisted)
      */
     private localCollectionValues;
+    /**
+     * Callback invoked when collections are reloaded due to file system changes.
+     * Set by the extension host to refresh tree views and panels.
+     */
+    onCollectionsChanged?: () => void;
     constructor(workspaceRoot: string, configService: IConfigService, fileWatcherFactory?: IFileWatcherFactory | undefined);
     private ensureCollectionsDir;
     private loadCollections;

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

@@ -9,9 +9,9 @@
  * All disk I/O is delegated to FolderCollectionStore — this class only
  * performs type conversion on the way in and out.
  */
+import type { ICollectionLoader } from '../../types/collection';
 import type { CollectionScripts, UnifiedCollection, UnifiedFolder, UnifiedRequest } from '../../types/types';
 import type { CollectionMetadata } from './collection-store';
-import type { ICollectionLoader } from '../../types/collection';
 export { generateSlug } from './folder-io';
 type UnifiedItem = UnifiedFolder | UnifiedRequest;
 /**

package/dist/infrastructure/environment/environment-config-service.d.ts

@@ -4,13 +4,14 @@
  * Platform-agnostic — uses IKeyValueStore for persistence instead of
  * VS Code's workspaceState/globalState.
  */
-import { IConfigService } from '../config';
-import { IKeyValueStore } from '../../types/platform';
 import type { IEnvironmentConfigService, ImportedEnvironment, LocalConfig, ResolvedEnvironment, SharedConfig } from '../../types/environment-config';
+import { IFileWatcherFactory, IKeyValueStore } from '../../types/platform';
+import { IConfigService } from '../config';
 export declare class EnvironmentConfigService implements IEnvironmentConfigService {
     private workspaceFolder;
     private workspaceStore;
     private configService;
+    private fileWatcherFactory?;
     private environmentsPath;
     private sharedConfigPath;
     private localConfigPath;
@@ -18,6 +19,7 @@ export declare class EnvironmentConfigService implements IEnvironmentConfigServi
     private sharedConfig;
     private localConfig;
     private selectedEnvironment;
+    private fileWatcher?;
     /**
      * In-memory Local Values for variables (not persisted)
      * These are set via forge.*.set() in scripts and override file values
@@ -25,7 +27,14 @@ export declare class EnvironmentConfigService implements IEnvironmentConfigServi
      */
     private localGlobalValues;
     private localEnvironmentValues;
-    constructor(workspaceFolder: string, workspaceStore: IKeyValueStore, configService: IConfigService);
+    /**
+     * Callback invoked when environment files change on disk.
+     * Set by the extension host to refresh tree views and panels.
+     */
+    onEnvironmentsChanged?: () => void;
+    constructor(workspaceFolder: string, workspaceStore: IKeyValueStore, configService: IConfigService, fileWatcherFactory?: IFileWatcherFactory | undefined);
+    private setupFileWatcher;
+    dispose(): void;
     getWorkspaceFolder(): string;
     getRootPath(): string;
     loadConfigs(): void;

package/dist/infrastructure/openapi/openapi-exporter.d.ts

@@ -34,6 +34,37 @@ export declare class OpenApiExporter {
     private buildServers;
     private processItems;
     private processRequest;
+    /**
+     * Merge a new operation into an existing one at the same path+method.
+     * - Parameters: union enum values for same-name params; append new params
+     * - Description: append the variant name
+     * - Tags: union
+     * - Responses: merge (new status codes added, existing kept)
+     */
+    private mergeOperation;
+    /**
+     * Merge parameter schemas when the same parameter appears in colliding operations.
+     *
+     * Strategy: if both variants use the SAME constraint kind (both enum, both pattern,
+     * both numeric range, etc.) they are merged in-place (union enum, widen range, etc.).
+     * If they use DIFFERENT constraint kinds the schemas are incompatible,
+     * so we wrap them in `oneOf` — each variant keeps its own self-consistent schema.
+     *
+     * Description and examples are always accumulated.
+     */
+    private mergeParameterSchema;
+    /** Identify the primary constraint kind of a schema. */
+    private getConstraintKind;
+    /** Merge constraints when both schemas use the same kind. */
+    private mergeSameKindConstraints;
+    /** Build a self-contained variant schema from constraint properties. */
+    private buildVariantSchema;
+    /** Remove constraint properties from a schema (keeps type, oneOf, etc.). */
+    private stripConstraints;
+    /** Extract constraint properties from a schema into a new object. */
+    private extractConstraints;
+    /** Widen the type field if the incoming type differs. */
+    private widenType;
     private normalizeUrl;
     private generateOperationId;
     private collectOperationIds;

package/dist/infrastructure/openapi/openapi-importer.d.ts

@@ -31,6 +31,16 @@ export declare class OpenApiImporter {
      */
     private convertPathParams;
     private processParameters;
+    /**
+     * Apply all schema constraints to a KeyValueEntry (query/header params).
+     */
+    private applySchemaConstraints;
+    /**
+     * When a parameter schema uses oneOf (from merged exports), derive
+     * combined enum and type hints for UI display.
+     * e.g. oneOf: [{enum: ["1.5"]}, {pattern: "^T\\d+"}] → enum: ["1.5"] as a hint
+     */
+    private applyOneOfHints;
     /**
      * Generate an example value string for a parameter from its schema.
      */

package/dist/types/types.d.ts

@@ -48,6 +48,7 @@ export interface UnifiedRequest {
     id: string;
     name: string;
     description?: string;
+    doc?: string;
     method: string;
     url: string;
     /** Headers with per-header enabled/disabled flag and OpenAPI metadata */
@@ -397,6 +398,15 @@ export interface KeyValueEntry {
     format?: string;
     enum?: string[];
     deprecated?: boolean;
+    pattern?: string;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    /** When multiple incompatible constraint sets exist (e.g. from merged endpoints) */
+    oneOf?: Array<Record<string, any>>;
 }
 /**
  * Path parameter entry with OpenAPI metadata
@@ -408,6 +418,15 @@ export interface PathParamEntry {
     format?: string;
     enum?: string[];
     deprecated?: boolean;
+    pattern?: string;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    /** When multiple incompatible constraint sets exist (e.g. from merged endpoints) */
+    oneOf?: Array<Record<string, any>>;
 }
 /**
  * Per-property encoding metadata for multipart/form-data request bodies.
@@ -542,6 +561,7 @@ export interface CollectionRequest {
     scripts?: RequestScripts;
     auth?: RequestAuth;
     description?: string;
+    doc?: string;
     disabled?: boolean;
     deprecated?: boolean;
     responseSchema?: ResponseSchemaDefinition;

package/package.json

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