Migrating to io.Connect Browser

Glue42 Core and Glue42 Core+ are now io.Connect Browser. It's now required to have a valid license key to create an io.Connect Browser project, as Glue42 Core is deprecated as a free option. All related libraries are also no longer open-source.

All web libraries are now published in the @interopio scope in NPM.

The following table lists the renamed JavaScript, React and Angular libraries in the new scope:

For new apps or apps in development, it's strongly recommended to start using the new packages.

The old libraries in the @glue42 scope are still available and compatible with io.Connect Browser, so it isn't necessary to upgrade your older apps. If you want to migrate your older apps to the new libraries, you only need to update the imports with the new library names, and optionally update the names of the factory functions (if you are using TypeScript, see the TypeScript section for further details on what else you must update). The new libraries support the old factory functions, so it isn't mandatory to update them.

You may also need to update the .npmrc file because of the new @interopio scope.

The following sections describe the major changes introduced by the new io.Connect libraries. Some of the changes won't break your existing implementations, as they are backwards compatible - e.g., in the JavaScript libraries, both the old and new factory functions are supported, as well as the old glue42core and the new iobrowser objects injected in the global window object.

JavaScript

The glue42core object injected in the global window object and used for accessing io.Connect functionalities before the io.Connect library initialization has completed, is now named iobrowser. The previous name is still supported.

The following factory functions have been renamed:

The previous factory function names are still supported.

The configuration object for initializing the @interopio/browser-platform library now has a required licenseKey property which you must use to provide a valid license key for your io.Connect Browser project.

Also, the following properties of the configuration object for the IOBrowserPlatform() factory function have been renamed:

The glue property of the object returned from initializing the @interopio/browser-platform library, which grants access to the io.Connect APIs, has been renamed to io:

const config = { licenseKey: "my-license-key" };

const { io, platform } = await IOBrowserPlatform(config);

TypeScript

If you are using TypeScript, take into consideration that some type names are different in the new libraries.

The following types have been renamed in the @interopio/browser-platform library:

The following types have been renamed in the @interopio/browser library:

The following types have been renamed in the @interopio/core library:

The following types have been renamed in the @interopio/workspaces-api library:

The following types have been renamed in the @interopio/intents-resolver-api library:

React

The following contexts, components and hooks have been renamed in the @interopio/react-hooks library:

If you are using TypeScript with React, consider that the following types have been renamed in the @interopio/react-hooks library:

The following properties of the IOConnectInitSettings object have been renamed:

The glue property of the <Workspaces />, <AddApplicationPopup />, <AddWorkspacePopup /> and <SaveWorkspacePopup /> components in the @interopio/workspaces-ui-react library has been renamed to io. A new <Logo /> component is available to be used instead of the <GlueLogo /> component. The <GlueLogo /> component is still supported.

Angular

The following modules and services have been renamed in the @interopio/ng library:

The getGlue() method of the IOConnectStore service has been renamed to getIOConnect().

The following types have been renamed in the @interopio/ng library:

The following properties of the IOConnectNgSettings object have been renamed: