contentful-export 8.2.0 → 8.2.1

package/README.md

@@ -216,6 +216,14 @@ Skip exporting webhooks
 
 Untag assets and entries
 
+#### `includeExperienceOrchestration` [boolean] [default: true]
+
+Export Experience Orchestration (ExO) entities: Design Tokens, Components, Experience Templates, Data Assemblies, Experience Fragments, and Experiences.
+
+Requires the Organization to have the `exo_m1` entitlement. If the Organization is not entitled, the export will not throw — each ExO array will be empty and a warning will be logged.
+
+See [docs/exo-export.md](./docs/exo-export.md) for full details.
+
 #### `contentOnly` [boolean] [default: false]
 
 Only export entries and assets
@@ -340,6 +348,19 @@ This is an overview of the exported data:
 }
 ```
 
+When `includeExperienceOrchestration: true` is set, six additional arrays are included:
+
+```json
+{
+  "designTokens": [],
+  "components": [],
+  "experienceTemplates": [],
+  "dataAssemblies": [],
+  "experienceFragments": [],
+  "experiences": []
+}
+```
+
 _Note:_ Tags feature is not available for all users. If you do not have access to this feature, the tags array will always be empty.
 
 _Note:_ `designTokens`, `components`, `experienceTemplates`, `dataAssemblies`, `experienceFragments`, and `experiences` are Experience Orchestration (ExO) entities — present by default; absent only if you explicitly set `includeExperienceOrchestration: false` — see the "Experience Orchestration (ExO) entities" section below.

package/dist/index.js

@@ -118,8 +118,11 @@ function runContentfulExport(params) {
           return _bfj.default.write(options.logFilePath, ctx.data, {
             circular: 'ignore',
             space: 2,
-            bufferLength: 1024,
-            yieldRate: 16384
+            // Do not set `yieldRate` -- values above `bufferLength`
+            // make bfj 9's serialization quadratic and it never
+            // finishes. See DX-1343.
+            bufferLength: 65536,
+            highWaterMark: 1024 * 1024
           });
         }
       }]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contentful-export",
-  "version": "8.2.0",
+  "version": "8.2.1",
   "description": "this tool allows you to export a space to a JSON dump",
   "main": "dist/index.js",
   "types": "types.d.ts",