Merge pull request #1819 from cosmos/exports-in-package.json

webmaster128 · web-flow · commit 447b457610fd · 2025-10-08T09:23:24.000+02:00
Add exports field to all package.json files
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -6,6 +6,27 @@ and this project adheres to
 
 ## [Unreleased]
 
+### Changed
+
+- all: The `package.json`s now all use the modern `exports` field instead of the
+  classic `main`/`types` to define the entry points. This ensures only symbols
+  from the top level module can be imported (like
+  `import { toBech32 } from "@cosmjs/encoding"`). Other import paths like
+  `import { toBech32 } from "@cosmjs/encoding/src/bech32"` are not allowed
+  anymore. As all public interfaces used to be exported from the top level for a
+  long time, this should not affect most users. However, if you accidentally
+  imported a subpath before you will get an error now. This can typically be
+  resolved like this:
+
+  ```diff
+  -import { toBech32 } from "@cosmjs/encoding/src/bech32"
+  +import { toBech32 } from "@cosmjs/encoding"
+  ```
+
+  ([#1819])
+
+[#1819]: https://github.com/cosmos/cosmjs/pull/1819
+
 ## [0.36.1] - 2025-10-02
 
 ### Fixed
diff --git a/packages/amino/package.json b/packages/amino/package.json
@@ -6,8 +6,10 @@
     "Simon Warta <webmaster128@users.noreply.github.com>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/cosmwasm-stargate/package.json b/packages/cosmwasm-stargate/package.json
@@ -6,8 +6,10 @@
     "Will Clark <willclarktech@users.noreply.github.com>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/crypto/package.json b/packages/crypto/package.json
@@ -7,8 +7,10 @@
     "Simon Warta"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/encoding/package.json b/packages/encoding/package.json
@@ -6,8 +6,10 @@
     "IOV SAS <admin@iov.one>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/faucet-client/package.json b/packages/faucet-client/package.json
@@ -6,8 +6,10 @@
     "Will Clark <willclarktech@users.noreply.github.com>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/json-rpc/package.json b/packages/json-rpc/package.json
@@ -8,8 +8,10 @@
     "Will Clark <willclarktech@users.noreply.github.com>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/ledger-amino/package.json b/packages/ledger-amino/package.json
@@ -6,8 +6,10 @@
     "Will Clark <willclarktech@users.noreply.github.com>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/math/package.json b/packages/math/package.json
@@ -6,8 +6,10 @@
     "IOV SAS <admin@iov.one>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/proto-signing/package.json b/packages/proto-signing/package.json
@@ -7,8 +7,10 @@
     "Simon Warta <webmaster128@users.noreply.github.com>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/socket/package.json b/packages/socket/package.json
@@ -8,8 +8,10 @@
     "Will Clark <willclarktech@users.noreply.github.com>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/stargate/package.json b/packages/stargate/package.json
@@ -6,8 +6,10 @@
     "Simon Warta <webmaster128@users.noreply.github.com>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/stream/package.json b/packages/stream/package.json
@@ -8,8 +8,10 @@
     "Will Clark <willclarktech@users.noreply.github.com>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/tendermint-rpc/package.json b/packages/tendermint-rpc/package.json
@@ -8,8 +8,10 @@
     "Will Clark <willclarktech@users.noreply.github.com>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
diff --git a/packages/utils/package.json b/packages/utils/package.json
@@ -6,8 +6,10 @@
     "IOV SAS <admin@iov.one>"
   ],
   "license": "Apache-2.0",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
+  "exports": {
+    "types": "./build/index.d.ts",
+    "default": "./build/index.js"
+  },
   "files": [
     "build/",
     "*.md",
