@http-forge/core 0.2.9 → 0.2.10

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

@@ -5,9 +5,12 @@
  */
 /**
  * Request reference within a Test Suite
- * References a request from a Collection (not a copy)
+ * References a request from a Collection with an optional embedded snapshot.
+ * When a slug is present, request data lives in the suite's folder structure.
  */
 export interface SuiteRequest {
+    /** Folder slug (directory name) within the suite — required for folder-based suites */
+    slug?: string;
     /** Collection ID where the request lives */
     collectionId: string;
     /** Collection name for display purposes */

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

@@ -2,9 +2,10 @@
  * Test Suite Store
  *
  * Manages suite requests that can come from different collections.
- * Resolves requests fresh from ICollectionService to ensure latest data.
+ * Supports folder-based suite storage where each request has its own directory.
+ * Falls back to resolving from collection service for legacy suites.
  *
- * Single Responsibility: Maintain suite state and resolve requests from collections
+ * Single Responsibility: Maintain suite state and resolve requests
  * Dependency Inversion: Depends on ICollectionService abstraction
  */
 import { CollectionRequest, ICollectionService, RequestScripts } from '../../types/collection';
@@ -30,6 +31,10 @@ export interface ITestSuiteStore {
      * Set the test suite
      */
     setSuite(suite: TestSuite): void;
+    /**
+     * Set the suite directory path (for folder-based suites)
+     */
+    setSuiteDir(dir: string | undefined): void;
     /**
      * Get the current suite
      */
@@ -38,6 +43,10 @@ export interface ITestSuiteStore {
      * Get a request by ID with full context (collection scripts + folder scripts)
      */
     getRequestWithContext(collectionId: string, requestId: string): SuiteRequestEntry | undefined;
+    /**
+     * Get a request by slug with full context
+     */
+    getRequestBySlug(slug: string): SuiteRequestEntry | undefined;
     /**
      * Get all suite requests with their resolved data
      */
@@ -55,6 +64,8 @@ export interface ITestSuiteStore {
         collectionName: string;
         folderPath: string;
         enabled: boolean;
+        hasEmbeddedRequest: boolean;
+        slug?: string;
     }>;
     /**
      * Get suite requests by selection state
@@ -62,9 +73,9 @@ export interface ITestSuiteStore {
      */
     getSelectedRequests(selectedIds: string[]): SuiteRequestEntry[];
     /**
-     * Add a request to the suite
+     * Add a request to the suite (creates folder if suiteDir is set)
      */
-    addRequest(request: SuiteRequest): void;
+    addRequest(request: SuiteRequest, fullRequest?: CollectionRequest): void;
     /**
      * Remove a request from the suite
      */
@@ -73,6 +84,14 @@ export interface ITestSuiteStore {
      * Reorder requests
      */
     reorderRequests(requestIds: string[]): void;
+    /**
+     * Update a suite request's data in its folder
+     */
+    updateSuiteRequest(slug: string, updatedRequest: CollectionRequest): void;
+    /**
+     * Re-sync a suite request from its source collection
+     */
+    resyncFromCollection(slug: string): CollectionRequest | undefined;
 }
 /**
  * Implementation of TestSuiteStore
@@ -80,17 +99,37 @@ export interface ITestSuiteStore {
 export declare class TestSuiteStore implements ITestSuiteStore {
     private readonly collectionService;
     private suite;
+    private suiteDir;
     constructor(collectionService: ICollectionService);
     /**
      * Set the suite
      */
     setSuite(suite: TestSuite): void;
+    /**
+     * Set the suite directory (for folder-based storage)
+     */
+    setSuiteDir(dir: string | undefined): void;
     /**
      * Get the current suite
      */
     getSuite(): TestSuite | undefined;
     /**
-     * Resolve a suite request to its full request data
+     * Load a suite request from its folder.
+     * Reads request.json + scripts/pre-request.js + scripts/post-response.js
+     */
+    private loadSuiteRequest;
+    /**
+     * Save a suite request to its folder.
+     * Writes request.json + scripts/pre-request.js + scripts/post-response.js
+     */
+    private saveSuiteRequest;
+    /**
+     * Check if a suite request has embedded data in its folder
+     */
+    private hasEmbeddedRequest;
+    /**
+     * Resolve a suite request to its full request data.
+     * Priority: suite folder → collection (fallback for legacy suites)
      */
     private resolveRequest;
     /**
@@ -115,6 +154,7 @@ export declare class TestSuiteStore implements ITestSuiteStore {
      * Always resolves fresh from collection service to ensure latest data
      */
     getRequestWithContext(collectionId: string, requestId: string): SuiteRequestEntry | undefined;
+    getRequestBySlug(slug: string): SuiteRequestEntry | undefined;
     /**
      * Get all suite requests with resolved data
      * Always resolves fresh from collection service to ensure latest data
@@ -134,6 +174,8 @@ export declare class TestSuiteStore implements ITestSuiteStore {
         collectionName: string;
         folderPath: string;
         enabled: boolean;
+        hasEmbeddedRequest: boolean;
+        slug?: string;
     }>;
     /**
      * Get selected requests in order
@@ -141,9 +183,14 @@ export declare class TestSuiteStore implements ITestSuiteStore {
      */
     getSelectedRequests(selectedIds: string[]): SuiteRequestEntry[];
     /**
-     * Add a request to the suite
+     * Add a request to the suite.
+     * If fullRequest is provided and suiteDir is set, creates a folder with request.json + scripts.
      */
-    addRequest(request: SuiteRequest): void;
+    addRequest(request: SuiteRequest, fullRequest?: CollectionRequest): void;
+    /**
+     * Resolve a unique slug (handle duplicates with numeric suffix)
+     */
+    private resolveUniqueSlug;
     /**
      * Remove a request from the suite
      */
@@ -152,4 +199,14 @@ export declare class TestSuiteStore implements ITestSuiteStore {
      * Reorder requests by request IDs (format: "collectionId:requestId")
      */
     reorderRequests(orderedKeys: string[]): void;
+    /**
+     * Update the request data in the suite folder.
+     * Called when user edits a request from the suite panel.
+     */
+    updateSuiteRequest(slug: string, updatedRequest: CollectionRequest): void;
+    /**
+     * Replace the suite request with the latest version from the collection.
+     * Overwrites the request folder content.
+     */
+    resyncFromCollection(slug: string): CollectionRequest | undefined;
 }

package/package.json

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