GalaxiesSdk Documentation

GalaxiesSdk is a class designed to integrate Telegram bot interactions with Firebase Firestore. It provides methods for user authentication via Telegram, managing user data, and handling game-related operations.

To use GalaxiesSdk, you need to install it via npm.

npm install galaxies-access-layer node-telegram-bot-api

When initializing GalaxiesSdk, provide the following Firebase configuration options:

• apiKey: Your Firebase API key.
• authDomain: Firebase Auth domain.
• projectId: Firebase project ID.
• storageBucket: Firebase storage bucket.
• messagingSenderId: Firebase messaging sender ID.
• appId: Firebase app ID.
• measurementId: Firebase measurement ID (optional).

Import the GalaxiesSdk class and initialize it with your configuration.

import { GalaxiesSdk } from "galaxies-access-layer/dist/galaxies-access-layer.es.js";

const firebaseConfig = {
  apiKey: "YOUR_API_KEY",
  authDomain: "YOUR_AUTH_DOMAIN",
  projectId: "YOUR_PROJECT_ID",
  storageBucket: "YOUR_STORAGE_BUCKET",
  messagingSenderId: "YOUR_MESSAGING_SENDER_ID",
  appId: "YOUR_APP_ID",
  measurementId: "YOUR_MEASUREMENT_ID",
};

const sdk = new GalaxiesSdk({
  firebaseConfig,
  buttonLabel: "Launch Game",
  botToken: "YOUR_BOT_TOKEN",
  websiteUrl: "YOUR_WEBSITE_URL",
  welcomeMessage: "Let's take you to the galaxies",
});

Fetches the Telegram user's profile information including their photo URL.

Parameters:

• userId (String): The Telegram user ID.

Returns:

• An object containing userId, username, and photoUrl.

Checks if a user already exists in Firestore.

Parameters:

• userId (String): The Telegram user ID.

Returns:

• true if the user exists, false otherwise.

Creates a new user in Firestore with the initial ticket count.

Parameters:

• user (Object): The user object containing user details.

Returns:

• The created user object.

Reduces the ticket count for a user by one.

Parameters:

• userId (String): The Telegram user ID.

Returns:

• The updated user object.

Increases the ticket count for a user by one.

Parameters:

• userId (String): The Telegram user ID.

Returns:

• The updated user object.

Sets the score for a user.

Parameters:

• userId (String): The Telegram user ID.
• score (Number): The score to be added.

Returns:

• The updated score object.

Gets the score for a user.

Parameters:

• userId (String): The Telegram user ID.

Returns:

• The user's score object.

Gets top 3 players.

Returns:

• List user's score object.

Gets top 3 players.

Returns:

• List user's score object.