Documentation incorrectly instructs developers to install @amazon-devices/package-manager-lib, which is not available on the public npm registry, preventing successful setup of the IAP library


:backhand_index_pointing_right: Bug Description


1. Summary

The setup documentation for @amazon-devices/keplerscript-appstore-iap-lib instructs developers to install @amazon-devices/package-manager-lib, but this package is not available on the public npm registry, making the documented setup impossible to follow.

App Name: N/A (Documentation Issue)
App Link on Amazon Appstore N/A

Bug Severity
Select one that applies

  • Impacts operation of app
  • Blocks current development
  • Improvement suggestion
  • Issue with documentation (If selected, please share the doc link and describe the issue)
  • Other

Documentation Link: @amazon-devices/keplerscript-appstore-iap-lib | Vega API

2. Steps to Reproduce

  1. Open the @amazon-devices/keplerscript-appstore-iap-lib setup documentation.
  2. Add the documented dependencies to package.json:
{
  "@amazon-devices/keplerscript-appstore-iap-lib": "~2.12.13",
  "@amazon-devices/package-manager-lib": "~1.0.1767254401"
}
  1. Run:
npm install
  1. Observe that npm fails to install @amazon-devices/package-manager-lib with a 404 error.

Additionally, running:

npm view @amazon-devices/keplerscript-appstore-iap-lib@2.12.13

shows that @amazon-devices/package-manager-lib is not listed as one of its dependencies.

3. Observed Behavior

npm install fails with:

npm ERR! 404 Not Found - GET https://registry.npmjs.org/@amazon-devices%2fpackage-manager-lib
npm ERR! 404 '@amazon-devices/package-manager-lib@~1.0.1767254401' is not in this registry.

The published @amazon-devices/keplerscript-appstore-iap-lib@2.12.13 package also does not list @amazon-devices/package-manager-lib as a dependency.

4. Expected Behavior

The documentation should either:

  • Remove @amazon-devices/package-manager-lib if it is no longer required, or
  • Clearly explain how external developers are expected to obtain this package if it is required.

The documented setup instructions should be reproducible using the public npm registry.

4.a Possible Root Cause & Temporary Workaround

The documentation appears to reference an internal or unpublished package.

As a workaround, removing @amazon-devices/package-manager-lib allows npm install to complete successfully for the remaining public dependencies, but it is unclear whether this is the intended setup because the documentation still lists it as required.


5. Logs or crash report

npm ERR! code E404
npm ERR! 404 Not Found - GET https://registry.npmjs.org/@amazon-devices%2fpackage-manager-lib
npm ERR! 404 '@amazon-devices/package-manager-lib@~1.0.1767254401' is not in this registry.

Output of:

npm view @amazon-devices/keplerscript-appstore-iap-lib@2.12.13

shows the following dependencies:

react
react-native
react-native-uuid
@amazon-devices/react-native-kepler
@amazon-devices/keplerscript-turbomodule-api

@amazon-devices/package-manager-lib is not listed.

6. Environment

SDK Version

Active SDK Version: 0.23.8358
Vega CLI Version: 1.3.2

App State

N/A (Documentation issue)

OS Information

Ubuntu 26.04

7. Example Code Snippet / Screenshots / Screengrabs

package.json

{
  "dependencies": {
    "@amazon-devices/keplerscript-appstore-iap-lib": "~2.12.13",
    "@amazon-devices/package-manager-lib": "~1.0.1767254401"
  }
}

:backhand_index_pointing_right: Additional Context


The documentation instructs developers to add @amazon-devices/package-manager-lib, but this package is not available on the public npm registry and is not listed as a dependency of @amazon-devices/keplerscript-appstore-iap-lib@2.12.13.

Could you please confirm whether:

  • @amazon-devices/package-manager-lib should be removed from the documentation, or
  • the package is intended to be publicly available through another registry?

This would help external developers follow the documented setup successfully.

Hi @Gizmeon,

Welcome to the Amazon Developer Community!

Thank you for the detailed bug report. You’re correct - @amazon-devices/package-manager-lib is not available on the public npm registry and is not listed as a dependency of @amazon-devices/keplerscript-appstore-iap-lib@2.12.13.

Your workaround of removing @amazon-devices/package-manager-lib from your package.json is the correct approach. The IAP library will function without it as long as you use a release build (system bundles are only included in release builds).

We are reviewing the documentation and will update it if needed.

Please let us know if you encounter any other issues.

Warm regards,
Aishwarya