@adobe-commerce/aio-toolkit 1.0.18 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,69 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.1.0] - 2026-03-27
9
+
10
+ ### ⚠️ Breaking Changes
11
+
12
+ - **Peer dependency restructuring to resolve duplicate module conflicts**
13
+ - The following packages have been moved from `dependencies` to `peerDependencies`:
14
+ - `@adobe/aio-sdk` (>=5.0.0) — required peer
15
+ - `graphql` (>=16.0.0) — required peer
16
+ - `@adobe/aio-lib-ims` (>=7.0.0) — optional peer
17
+ - `@adobe/aio-lib-telemetry` (>=1.0.0) — optional peer
18
+ - `cloudevents` (>=8.0.0) — optional peer
19
+ - `dotenv` (>=16.0.0) — optional peer
20
+ - `node-fetch` (>=2.6.0) — optional peer
21
+ - `openwhisk` (>=3.0.0) — optional peer
22
+ - `@opentelemetry/resources` (>=1.0.0) — optional peer
23
+ - App Builder projects already have these packages installed — no additional installs required for the vast majority of users
24
+ - If you get `Cannot find module` errors after upgrading, install the missing package directly in your project
25
+
26
+ ### 🐛 Bug Fixes
27
+
28
+ - **Fixed missing `yaml` dependency**
29
+ - `yaml` was used at runtime in `OnboardConfig` (YAML config file parsing) but was not declared in `package.json`
30
+ - This was relying on a transitive install which is fragile and unreliable across package managers
31
+ - `yaml: ^2.0.0` is now a proper direct `dependency`
32
+
33
+ ### 🔧 Dependency Changes
34
+
35
+ | Package | Before | After | Reason |
36
+ |---|---|---|---|
37
+ | `@adobe/aio-sdk` | `dependencies` | `peerDependencies` | Singleton services break with duplicate instances |
38
+ | `@adobe/aio-lib-ims` | `dependencies` | `peerDependencies` (optional) | Shared auth token context |
39
+ | `@adobe/aio-lib-telemetry` | `dependencies` | `peerDependencies` (optional) | Shared telemetry pipeline |
40
+ | `graphql` | `dependencies` | `peerDependencies` | Schema singleton — two copies cause type incompatibility |
41
+ | `cloudevents` | `dependencies` | `peerDependencies` (optional) | App Builder I/O Events projects always install this |
42
+ | `dotenv` | `dependencies` | `peerDependencies` (optional) | Every App Builder project loads `.env` files |
43
+ | `node-fetch` | `dependencies` | `peerDependencies` (optional) | Common fetch polyfill; v2/v3 split causes conflicts |
44
+ | `openwhisk` | `dependencies` | `peerDependencies` (optional) | App Builder Runtime projects always install this |
45
+ | `@opentelemetry/resources` | *(missing)* | `peerDependencies` (optional) | Runtime import in telemetry code; provided by `aio-lib-telemetry` |
46
+ | `yaml` | *(missing)* | `dependencies` | Runtime import in `OnboardConfig` — was undeclared |
47
+ | `got` | `dependencies` | `dependencies` | Internal HTTP client — kept as direct dep |
48
+ | `oauth-1.0a` | `dependencies` | `dependencies` | Internal OAuth signing — kept as direct dep |
49
+ | `uuid` | `dependencies` | `dependencies` | Stateless, no conflict risk — kept as direct dep |
50
+
51
+ ### 💡 Migration Guide
52
+
53
+ Most App Builder projects already have all moved packages installed and **require no changes**:
54
+
55
+ ```bash
56
+ # Standard upgrade — works for most users
57
+ npm install @adobe-commerce/aio-toolkit@1.1.0
58
+ ```
59
+
60
+ If you encounter `Cannot find module` errors for any of the optional peer dependencies, install them explicitly:
61
+
62
+ ```bash
63
+ # Install only the ones you use
64
+ npm install @adobe/aio-sdk graphql dotenv
65
+ npm install cloudevents node-fetch openwhisk # if used
66
+ npm install @adobe/aio-lib-ims @adobe/aio-lib-telemetry # if used
67
+ ```
68
+
69
+ ---
70
+
8
71
  ## [1.0.18] - 2026-03-03
9
72
 
10
73
  ### 🔒 Security Fixes