@globus/sdk NPM

Help guide the development of the @globus/sdk by reporting issues or suggesting features!

The Globus SDK for JavaScript provides first class TypeScript support and makes it easy to call Globus services using idiomatic JavaScript APIs to build Node.js and web applications.

Installation

You can install the SDK with the following command:

npm install @globus/sdk

Supported Platforms

Node.js

We aim to support all Active LTS Node.js releases. We intend to support all Maintenance LTS versions until their official end-of-life. Removal of support for a Node.js version will be considered a breaking change and result in a major version bump of the SDK.

Version
Node.js 20
Node.js 22
Node.js 24

Browser Support

Officially, the SDK supports widely adopted evergreen browsers: Edge, Chrome, Safari, and Firefox. Our bundled browser distributions target ECMAScript 2015 (ES6), which has broader browser support but may not be explicitly evaluated.

Browser
Google Chrome
Mozilla Firefox
Microsoft Edge
Apple Safari

ESM, CommonJS, and UMD

We distribute our package targeting three different module systems: ESM, CommonJS, and UMD.

ESM

The ESM distribution is the module export of the package.

import { transfer } from '@globus/sdk';
import { GCS } from '@globus/sdk/constants';

CommonJS

The CommonJS distribution is the main export of the package. It is intended for use in Node.js applications and environments that support the require statement.

const { transfer } = require('@globus/sdk');

You can also explicitly use the cjs namespace to import a CommonJS entrypoint.

const transfer = require('@globus/sdk/cjs').transfer;
// or, import { transfer } from '@globus/sdk/cjs';

UMD

The UMD distribution is provided for use in web applications and environments that do not support ESM or CommonJS. Referencing the UMD distribution as a <script> tag will provide a global variable globus that contains all default exports from the package.