@sungv/gitlab-node-client v0.0.1-packtest16

@sungv/gitlab-node-client

Overview

@sungv/gitlab-node-client provides a convenient interface to interact with the GitLab API from Node.js. It allows you to manage projects, issues, merge requests, users, groups, and more.

Features

• Compatible with both Node.js and browser environments.
• Supports ES modules and CommonJS.
• Includes full development setup with linting, testing, and building.
• Automated CI/CD pipeline using GitLab CI and GitHub Actions.
• Prettier and ESLint for consistent code style.

Badges

Installation

npm install @sungv/gitlab-node-client

Usage

Basic Example

const GitLabAPI = require("@sungv/gitlab-node-client");

const gitlab = new GitLabAPI({
  host: "https://gitlab.example.com",
  token: "YOUR_PERSONAL_ACCESS_TOKEN",
});

// Get all projects (paginated)
(async () => {
  try {
    const projects = await gitlab.projects.all({ per_page: 5 });
    console.log("Projects:", projects.items);
  } catch (error) {
    console.error("Error:", error.message);
  }
})();

Available APIs:

The following table lists all currently available API categories and methods within them. You can find the detailed documentation for the GitLab API at https://docs.gitlab.com/ee/api/rest/.

Features

Pagination:

Most API methods that retrieve collections (e.g., projects, issues) support pagination. You can control the page size using the per_page option in the request options object. The response object will include information about the total pages, total items, and the current page.

Rate Limiting:

The GitLab API enforces rate limits to prevent abuse. This module captures the remaining rate limit and reset time from the response headers and stores them in the rateLimitRemaining and rateLimitReset properties of the GitLabAPI instance. You can use this information to implement your own retry mechanism for handling rate limit errors.

Error Handling:

The module uses custom error classes (GitLabAPIError, GitLabNotFoundError, GitLabAuthenticationError, GitLabRateLimitError) to provide more context about API errors. These errors include the HTTP status code, response body, and the URL of the request that failed.

Development

Setup

1. Clone the repository:

   git clone https://gitlab.com/your-repo/gitlab-node-client.git
   cd gitlab-node-client

2. Install dependencies:

   npm install

Scripts

• Build: npm run build
• Test: npm run test
• Lint: npm run lint
• Format: npm run format
• Prepare (Husky hooks): npm run prepare

Code Style Guide

This project enforces consistent code style using Prettier and ESLint:

• Prettier handles code formatting.
• ESLint ensures adherence to the Airbnb base style guide.

Run formatting with:

npm run format

Generate Documentation

This project uses TypeDoc for generating documentation.

Generate documentation with:

npm run typedoc

Contributing

Contributions are welcome! Please open an issue or submit a pull request with your changes.

Issue Templates

Include the following types:

• Bug Reports: Template for submitting bug reports.
• Feature Requests: Template for suggesting new features.

License

This project is licensed under the MIT License.

Changelog

1.0.0 - YYYY-MM-DD

Added

• Initial release with basic functionality.
• Prettier and ESLint setup.
• CI/CD pipeline using GitLab CI and GitHub Actions.
• Tree-shaking and optimized build.
• Issue templates and badges.