@agoric/internal

NOTE: unsupported

Usage

This package contains code that is required by agoric-sdk and not meant to be imported anywhere else.

Like all @agoric packages it follows Semantic Versioning. Unlike the others, it will never have a stable API. In terms of SemVer spec item 4, it will never reach 1.0:

Major version zero (0.y.z) is for initial development. Anything MAY change at any time. The public API SHOULD NOT be considered stable.

Design

It must be the lowest agoric-sdk package in any import graph. Therefore it must never depend on another agoric-sdk package. If there's a module in an another agoric-package that has no agoric-sdk dependencies, it can be moved into this package.

It must never export ambient types.

It should not be imported by deep imports. Eventually this will be enforced by exports but the tooling isn't ready: - https://github.com/import-js/eslint-plugin-import/issues/1810 - https://github.com/microsoft/TypeScript/issues/33079 (or some related problem with JSdoc types)