@http-forge/core 0.2.14 → 0.2.17

package/README.md

@@ -31,6 +31,8 @@
 
 ## 🎯 Installation
 
+Requires Node.js `20+`.
+
 ```bash
 npm install @http-forge/core
 ```
@@ -518,6 +520,38 @@ interface PathParamEntry {
 }
 ```
 
+### Postman Collection Import / Export
+
+`CollectionService` can import and export Postman Collection v2.1 JSON files, preserving all request body types, auth, scripts, and folder structure.
+
+**Import** (`importCollection(filePath)`):
+
+Detects Postman format by `info._postman_id` and converts all five body modes:
+
+| Postman `mode` | HTTP Forge `type` | Notes |
+|---|---|---|
+| `raw` | `raw` | `format` inferred from `options.raw.language` (json/xml/html/javascript/text) |
+| `urlencoded` | `x-www-form-urlencoded` | Fields mapped to `[{key, value, enabled}]` |
+| `formdata` | `form-data` | Fields mapped to `[{key, value, type, enabled}]` |
+| `graphql` | `graphql` | `variables` JSON string parsed to object |
+| `binary` | `binary` | File path not portable; imported with empty content |
+
+Auth types `bearer`, `basic`, and `apikey` are converted. Pre-request and test scripts (`prerequest`/`test` events) are imported as `scripts.preRequest`/`scripts.postResponse`. Folder hierarchy and item order are preserved.
+
+**Export** (`exportCollection(collectionId, filePath)`):
+
+Converts back to Postman v2.1 JSON. All body types round-trip correctly: `x-www-form-urlencoded` exports as `mode: "urlencoded"`, `form-data` as `mode: "formdata"`, `graphql` as `mode: "graphql"`, and `binary` as `mode: "binary"`.
+
+```typescript
+const service = container.getCollectionService();
+
+// Import
+const collection = await service.importCollection('./my-api.postman_collection.json');
+
+// Export
+await service.exportCollection(collection.id, './exported.postman_collection.json');
+```
+
 ### OpenAPI Import / Export
 
 The core library includes full OpenAPI 3.0.3 import and export with constraint preservation.
@@ -727,6 +761,12 @@ MIT © Henry Huang
 
 ## 📝 Changelog
 
+### 0.2.16 (Duplicate Collection & Folder)
+
+- ✅ **`duplicateCollection(sourceId, newName)`** — Duplicates a collection including all nested folders, requests, scripts, and schemas
+- ✅ **`duplicateFolder(collectionId, folderId, newName)`** — Duplicates a folder within a collection, preserving all nested request content
+- ✅ **`getItemPath(collectionId, itemId)`** — Resolves the disk path of a folder or request within a collection
+
 ### 0.2.5 (OpenAPI Constraint Round-Trip & Collision Merging)
 
 - ✅ **Full parameter constraint round-trip** — OpenAPI import/export now preserves all schema constraint fields: `pattern`, `minimum`, `maximum`, `exclusiveMinimum`, `exclusiveMaximum`, `minLength`, `maxLength`, and `oneOf` on both `KeyValueEntry` and `PathParamEntry`