APIMatic Runtime Packages for JavaScript SDKs

This is a collection of packages used in SDKs generated by the APIMatic Code Generator.

They provide common runtime utilities needed by SDKs to make API calls and handle request/response data.

List of Packages

Name	Version	Description
@apimatic/schema		Validate and transform data using schema definitions.
@apimatic/authentication-adapters		Provides pluggable adapters for different authentication schemes.
@apimatic/axios-client-adapter		Axios HTTP Client adapter which can be plugged into @apimatic/core package.
@apimatic/convert-to-stream		Provides bidirectional conversion between strings and streams/blobs.
@apimatic/core		Provides core http logic of request building, response handling and validation and using api error classes
@apimatic/core-interfaces		Abstraction layer for @apimatic/core.
@apimatic/file-wrapper		Wrapper around the file types and their utilities.
@apimatic/http-headers		HTTP Headers utilities for apimatic-js-runtime libraries.
@apimatic/http-query		HTTP Query utilities for apimatic-js-runtime libraries
@apimatic/oauth-adapters		Provides pluggable adapters for OAuth 2.0 authentication schemes.
@apimatic/xml-adapter		Provides XML serialization and deserialization utilities for apimatic-js-runtime libraries.
@apimatic/test-utilities		Provides assertion utilities for testing api calls. It can be plugged in as dev dependency to any library.
@apimatic/pagination		Provides utilities to handle paginated API responses, including support for asynchronous iteration over pages or items.
@apimatic/proxy		Provides proxy configuration utilities for HTTP clients.
@apimatic/hmac-signature-verifier		Provides HMAC signature verification utilities to secure HTTP requests.

Builds and Usage

The following environments are supported:

1. Node.js v14.15.0+
2. Bundlers like Rollup or Webpack
3. Web browsers

To support multiple environments, we export various builds:

Environment	Usage
Common.js	Import like this: require('@apimatic/<package-name>').
ES Module	Import like this: import { /* your imports */ } from '@apimatic/<package-name>'.
Browsers	*Use script: https://unpkg.com/@apimatic/<package-name>@VERSION/umd/<package-name>.js
Modern Browsers (supports ESM and uses modern JS)	*Use script: https://unpkg.com/@apimatic/<package-name>@VERSION/umd/<package-name>.esm.js

* Don't forget to replace VERSION with the version number.

Note: We discourage importing files or modules directly from the package. These are likely to change in the future and should not be considered stable.