1.0.1 โ€ข Published 7 months ago

@mojito-inc/loyalty-cli v1.0.1

Weekly downloads
-
License
MIT
Repository
github
Last release
7 months ago

๐Ÿงช Mojito Loyalty CLI

@mojito-inc/loyalty-cli is a command-line tool to interact with the Mojito Loyalty Platform.
It supports authentication, mission & reward handling, claims, redemptions, and leaderboard queries โ€“ all from your terminal.


๐Ÿ“ฆ Installation

  1. Before installing, make sure Node.js is available in your system.

    **Install Node.js**:  

    https://nodejs.org/en/download/

    Verify installation:
    ```bash
    node -v
    npm -v 
    ```
  2. Install CLI:

    npm install @mojito-inc/loyalty-cli
  1. Install CLI (If globally required):
    npm install -g @mojito-inc/loyalty-cli
  1. Run the CLI:

    Once installed successfully, you can access the CLI tool via mojito loyalty in your terminal.

    mojito-loyalty --help

โš™๏ธ Global Options

You can specify the environment using:

--env <env>  Specify environment: dev, staging, sandbox, or prod (default: prod)

๐Ÿ”‘ Authentication Commands

fetchSignMessage

Fetch the sign message for a user:

mojito-loyalty fetchSignMessage <walletAddress> -k <apiKey>

generateJWT

Generate a JWT token:

mojito-loyalty generateJWT <walletAddress> <signature> <message> -k <apiKey>

๐ŸŽฏ Mission Commands

getMissions

Fetch missions for a user:

mojito-loyalty getMissions <tenantId> <user_reference> -k <apiKey> [options]

Options:

  • --status <status>: Mission status (default: AVAILABLE)
  • --missionId <id>
  • --sortBy <field>: Sort field (default: created_at)
  • --order <asc|desc>: Sort order (default: desc)
  • --limit <n>: Number of results (default: 10)
  • --offset <n>: Pagination offset (default: 0)

fetchMission

Fetch mission details by ID:

mojito-loyalty fetchMission <missionId> -k <apiKey>

๐Ÿงพ Claim Commands

initiateClaim

Initiate a claim process:

mojito-loyalty initiateClaim <missionId> <userReference> -k <apiKey>

getClaimStatus

Get claim status:

mojito-loyalty getClaimStatus <tenantId> <missionId> <userId> <claimId> -k <apiKey>

๐ŸŽ Reward Commands

getRewards

Fetch rewards for a user:

mojito-loyalty getRewards <tenantId> <user_reference> -k <apiKey> [options]

Options:

  • --status <status> (default: AVAILABLE)
  • --sortBy <field> (default: created_at)
  • --order <asc|desc> (default: desc)
  • --limit <n> (default: 10)
  • --offset <n> (default: 0)

fetchReward

Fetch reward details by ID:

mojito-loyalty fetchReward <rewardId> -k <apiKey>

initiateReward

Initiate reward redemption:

mojito-loyalty initiateReward <rewardId> <userReference> <walletAddress> -k <apiKey>

getRedeemStatus

Fetch reward redemption status:

mojito-loyalty getRedeemStatus <tenantId> <rewardId> <userId> <redeemId> -k <apiKey>

๐Ÿงฎ User Credits

getUserCredits

Get userโ€™s available credit points:

mojito-loyalty getUserCredits <tenantId> <user_reference> -k <apiKey>

๐Ÿ† Leaderboard

getLeaderboard

Fetch leaderboard data:

mojito-loyalty getLeaderboard <tenantId> -k <apiKey> [options]

Options:

  • --sort <field> (default: Points)
  • --date-range <range> (default: ALLTIME)
  • --limit <n> (default: 10)
  • --offset <n> (default: 0)

๐Ÿ’ณ Transactions

getTransactions

Fetch user transaction history:

mojito-loyalty getTransactions <tenantId> <userReference> -k <apiKey> [options]

Options:

  • --date-range <range> (default: ALLTIME)
  • --limit <n> (default: 10)
  • --offset <n> (default: 0)

๐Ÿ“ž Support