Notoriously Psychedelic Modules

    lockstep-sdk
    TypeScript icon, indicating that this package has built-in type declarations

    2022.37.24 • Public • Published

    Lockstep Platform API SDK for Typescript and Javascript

    npm

    This SDK allows you to work with the Lockstep Platform API in JavaScript and TypeScript. JavaScript developers will find a fully featured library with convenient functions to automate most of the method calls within the Lockstep API; developers using TypeScript will find a rich definition of strict types. Both languages will have access to docblocks, hover, autocomplete, and convenience features to make your code easier to write.

    Dependencies:

    Using this SDK

    This tutorial will walk you through the basics of creating a project that uses the Lockstep Platform SDK.

    1. Let's begin by creating a new project with a skeleton package.json file using in NodeJS:
    > npm init --y
    1. If you choose to use TypeScript, you can now add TypeScript features to this project. The following steps will install TypeScript, create a tsconfig.json file, and gain access to most built-in types for NodeJS:
    > npm install typescript
    > npx tsc --init
    > npm install -D @types/node
    1. Add the Lockstep SDK to your project via Node Package Manager:
    > npm install lockstep-sdk
    1. Obtain a free Lockstep developer account from the Lockstep developer site. When you fill out your information, you will receive an email with an API key.
    2. Set your API key to an environment variable such as LOCKSTEP_APIKEY so that it will not be committed to source control.
    3. Create a basic index.ts file for your project that creates a Lockstep API client:
    import { LockstepApi } from 'lockstep-sdk';
    
    var client = LockstepApi
        .withEnvironment("sbx")
        .withApiKey(process.env["LOCKSTEP_APIKEY"]);
    1. Make an API call and check the result:
    var status = await client.Status.ping();
    if (status.success) {
        if (status.value?.loggedIn) {
            console.log(`Logged in as ${status.value.userName}`);
        } else {
            console.log(`API key is not recognized: ${status.value?.errorMessage}`);
        }
    }

    You're ready to begin writing code with the Lockstep API!

    Install

    npm i lockstep-sdk

    DownloadsWeekly Downloads

    33

    Version

    2022.37.24

    License

    MIT

    Unpacked Size

    1.02 MB

    Total Files

    6

    Last publish

    Collaborators

    • lockstep-admin
    • dhric-lockstep
    • ted-lockstep