@spacejunk/airlock v1.7.0
šš¦ @spacejunk/airlock āØ
Spacetraders.io API client built with TypeScript, generated via openapi-generator-cli. See options for generator type typescript-fetch
š Spacetraders Homepage | š Getting Started Guide | š§ API Playground
Installation
npm install @spacejunk/airlock
Features
- TypeScript support
- Fetch-based HTTP requests
- Generates both ESM and CJS clients
- Autogenerated by openapi-generator-cli
Prerequisites
If you're using this in the Browser, you don't need to setup anything!
However, if you're using it serverside with Node.js, this package requires Node.js v18 or higher. Node 18 is the first version to support native fetch. To install Node.js v18, we recommend using Node Version Manager (nvm). Follow the instructions below based on your operating system:
macOS
To install nvm on macOS, run the following command in your terminal:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
Restart your terminal and run the following command to install Node.js v18:
nvm install 18
# then, set your version to Node 18 via use
nvm use 18
Windows
To install nvm on Windows, download and run the installer from the nvm-windows GitHub repository.
Once installed, open a new Command Prompt or PowerShell window and run the following command to install Node.js v18:
nvm install 18
# then, set your version to Node 18 via use
nvm use 18
Getting Started
To use the @spacejunk/airlock
package in your project, follow this example:
import {
Configuration,
FleetApi,
} from '@spacejunk/airlock';
// Set up a configuration with your access token
export const config = new Configuration({
accessToken: 'your agent token'
});
// create and configure an api client
const fleet = new FleetApi(config);
// List your agent's ships
export const getShips = async () => {
try {
const { data } = await fleet.getMyShips();
return data;
} catch (error) {
console.error(error);
}
};
// Navigate to a target destination
export const navigateShip = async ({
shipSymbol,
waypointSymbol,
}: {
shipSymbol: string;
waypointSymbol: string;
}) => {
const { data } = await fleet.navigateShip(shipSymbol, { waypointSymbol });
return data;
};
Building the package
To build the package and automatically pull the latest OpenAPI schema from https://github.com/SpaceTradersAPI/api-docs, run the following command:
npm run build
This command generates the API client in both ESM and CJS formats.
To watch for changes and rebuild automatically, use:
npm run watch