@apiquest/fracture 1.0.4 → 1.0.6

package/README.md

@@ -50,6 +50,10 @@ fracture run ./collection.json \
 fracture run ./collection.json \
   --parallel \
   --concurrency 5
+
+# With external libraries (npm, file, or CDN)
+fracture run ./collection.json \
+  --allow-external-libraries
 ```
 
 ### Programmatic API
@@ -74,6 +78,7 @@ console.log(`Tests: ${result.passedTests}/${result.totalTests} passed`);
 - **Plugin architecture** - Support for HTTP, GraphQL, gRPC, WebSocket, SSE via plugins
 - **Collection-level iterations** - Data-driven testing with CSV/JSON files
 - **Event-based reporting** - Real-time progress events for custom reporters
+- **External libraries** - Load npm packages, local files, or CDN scripts (opt-in)
 
 ## Collection Schema
 
@@ -109,10 +114,93 @@ Collections are JSON files following the ApiQuest schema:
 }
 ```
 
+## CLI Options
+
+Key runtime options (see [full CLI reference](../../docs/quest_cli.md) for all options):
+
+```bash
+# Variables & Environment
+-g, --global <key=value>      Set global variable
+-e, --environment <file>      Environment file
+--env-var <key=value>         Set environment variable
+
+# Execution
+--parallel                    Enable parallel execution
+--concurrency <number>        Max concurrent requests
+--bail                        Stop on first test failure
+--delay <ms>                  Delay between requests
+--timeout <ms>                Request timeout
+
+# SSL/TLS
+--ssl-cert <path>             Client certificate (PEM)
+--ssl-key <path>              Client private key
+--insecure                    Disable SSL validation
+
+# Proxy
+--proxy <url>                 HTTP/HTTPS proxy
+--proxy-auth <user:pass>      Proxy credentials
+
+# Plugins & Libraries
+--install-plugins             Auto-install missing plugins
+--allow-external-libraries    Enable external libraries (npm/file/cdn)
+
+# Output
+--silent                      Suppress output
+--log-level <level>           error|warn|info|debug|trace
+--no-color                    Disable colors
+```
+
+**Exit Codes:**
+- `0` — All tests passed
+- `1` — One or more tests failed
+- `2` — Invalid CLI input
+- `3` — Pre-run validation failed
+- `4` — Runtime error
+
+## External Libraries
+
+Load npm packages, local files, or CDN scripts in your test scripts. Requires `--allow-external-libraries` flag for security.
+
+```json
+{
+  "options": {
+    "libraries": [
+      {
+        "name": "validator",
+        "source": { "type": "npm", "package": "validator" },
+        "version": "^13.11.0"
+      },
+      {
+        "name": "myutils",
+        "source": { "type": "file", "path": "./utils/helpers.js" }
+      },
+      {
+        "name": "lodash",
+        "source": { "type": "cdn", "url": "https://cdn.jsdelivr.net/npm/lodash@4.17.21/lodash.min.js" }
+      }
+    ]
+  }
+}
+```
+
+Use in scripts with `require()`:
+
+```javascript
+const validator = require('validator');
+quest.test('Valid email', () => {
+  expect(validator.isEmail('test@example.com')).to.be.true;
+});
+```
+
+Run with: `fracture run collection.json --allow-external-libraries`
+
+See [CLI documentation](../../docs/quest_cli.md#external-libraries) for details.
+
 ## Documentation
 
-- [Fracture Documentation](https://apiquest.net/docs/fracture)
-- [Schema Specification](https://apiquest.net/schemas/collection-v1.0.json)
+- [CLI Reference](../../docs/quest_cli.md)
+- [Runner API](../../docs/quest_runner.md)
+- [Schema Specification](../../docs/quest_schema_spec.md)
 
 ## License
 

package/dist/CollectionRunner.d.ts

@@ -18,6 +18,9 @@ export declare class CollectionRunner extends EventEmitter {
     private bailEnabled;
     private abortReason?;
     private shouldDelayNextRequest;
+    private libraryLoader;
+    private loadedLibraries;
+    private folderScopeById;
     constructor(options?: CollectionRunnerOptions);
     /**
      * Queue script execution to ensure sequential execution (thread-safe)

package/dist/CollectionRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CollectionRunner.d.ts","sourceRoot":"","sources":["../src/CollectionRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,SAAS,EAQT,uBAAuB,EAMvB,eAAe,EACf,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAkBzB,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,uBAAuB,CAA4B;IAC3D,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,sBAAsB,CAAS;gBAE3B,OAAO,CAAC,EAAE,uBAAuB;IA6B7C;;OAEG;YACW,WAAW;IASzB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAI7C,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAI7C,OAAO,CAAC,iBAAiB;IAmBzB;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAwBtE;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,cAAc;IAWhB,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAmX/E,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,YAAY;IA2EpB;;;OAGG;YACW,iBAAiB;IAqC/B;;OAEG;YACW,cAAc;IAsD5B;;OAEG;YACW,mBAAmB;YAwDnB,0BAA0B;YA2B1B,2BAA2B;IA2BzC;;;OAGG;YACW,kBAAkB;IAsBhC;;;;;;OAMG;YACW,iBAAiB;YA2BjB,sBAAsB;YA+BtB,uBAAuB;YA+BvB,wBAAwB;IAqCtC;;;OAGG;YACW,sBAAsB;CAwXrC"}
+{"version":3,"file":"CollectionRunner.d.ts","sourceRoot":"","sources":["../src/CollectionRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,SAAS,EAQT,uBAAuB,EAMvB,eAAe,EACf,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAmBzB,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,uBAAuB,CAA4B;IAC3D,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,eAAe,CAAwC;gBAEnD,OAAO,CAAC,EAAE,uBAAuB;IA8B7C;;OAEG;YACW,WAAW;IASzB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAI7C,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAI7C,OAAO,CAAC,iBAAiB;IAmBzB;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAwBtE;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,cAAc;IAWhB,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IA+Y/E,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,YAAY;IA0FpB;;;OAGG;YACW,iBAAiB;IAuC/B;;OAEG;YACW,cAAc;IAsD5B;;OAEG;YACW,mBAAmB;YAwDnB,0BAA0B;YA2B1B,2BAA2B;IA2BzC;;;OAGG;YACW,kBAAkB;IAgChC;;;;;;OAMG;YACW,iBAAiB;YAuBjB,sBAAsB;YA+BtB,uBAAuB;YA+BvB,wBAAwB;IAqCtC;;;OAGG;YACW,sBAAsB;CA2arC"}