ethiotelecom-login-util

A robust, headless utility built with TypeScript to automate the login process for Ethio Telecom Web Access and securely retrieve the authenticated user’s full name.

Designed for backend services, automation scripts, and internal tooling.

✨ Features

• 🔐 Secure – Credentials are passed via environment variables
• 🧩 Type-Safe – Written in TypeScript for reliable, maintainable code
• 🤖 Headless Automation – Performs real login validation
• 🛠 Robust – Handles authentication errors and timeouts gracefully

📦 Installation

Requirements: Node.js 16+

npm install ethiotelecom-login-util
# or
yarn add ethiotelecom-login-util

🚀 Usage

The package exports a single asynchronous function:

getUserName(username: string, password: string): Promise<string>

1️⃣ Set Environment Variables

For security reasons, always provide credentials using environment variables.

| Variable | Description | | ------------- | --------------------------------------------------------- | | ET_USERNAME | Your full Ethio Telecom username (e.g. yonas.mulugetat) | | ET_PASSWORD | Your Ethio Telecom password |

Linux / macOS

export ET_USERNAME=yonas.mulugetat
export ET_PASSWORD=your_password

Windows (PowerShell)

setx ET_USERNAME "your_username"
setx ET_PASSWORD "your_password"

2️⃣ Example (TypeScript)

import { getUserName } from 'ethiotelecom-login-util';

// ⚠️ Read credentials from environment variables
const username: string = process.env.ET_USERNAME ?? '';
const password: string = process.env.ET_PASSWORD ?? '';

async function retrieveUserName(): Promise<void> {
  try {
    console.log(`Attempting login for: ${username}...`);

    const fullName: string = await getUserName(username, password);

    console.log('✅ Login Successful!');
    console.log(`Authenticated User Name: ${fullName}`);
  } catch (error: any) {
    console.error('❌ Authentication Failed.');
    console.error(error.message);
  }
}

retrieveUserName();

⚠️ Notes

• Do not hardcode credentials
• Intended for automation and internal services
• Requires a stable internet connection

🔍 Keywords (npm search)

ethiotelecom, ethio telecom login,
automated login, ethiotelecom automation, headless login, nodejs automation

📄 License

MIT

👨‍💻 Author

Yonas phone 0930327375

If you find this package useful, please ⭐ it on npm or GitHub.