An open-source Google Business Profile SDK with automatic OAuth refresh, pagination and retries.

Mayank Singh Kushwah — Sun, 28 Jun 2026 17:17:08 +0000

Over the last few months I was working on a project that manages hundreds of Google Business Profile locations.

I expected the integration to be straightforward, but the API turned out to be much harder than I anticipated.

The biggest pain points were:
• OAuth access tokens expiring every hour
• Refresh token race conditions
• Manual pagination using nextPageToken
• Handling 429 rate limits and random 503 responses
• Writing the same boilerplate for every project

After solving these problems multiple times, I decided to extract everything into an open-source SDK.

Some features:
✅ Automatic OAuth token refresh
✅ Thread-safe token management
✅ Auto-pagination (fetch all pages automatically)
✅ Built-in retry with exponential backoff
✅ Fully typed TypeScript API
✅ Zero runtime dependencies

Example:
import { GBPClient, ConsoleLogger } from '@vitabletech/gbp-sdk';

const client = new GBPClient({
  clientId: 'YOUR_GOOGLE_CLIENT_ID',
  clientSecret: 'YOUR_GOOGLE_CLIENT_SECRET',
  refreshToken: 'YOUR_REFRESH_TOKEN',
  tokenStorage: 'file', 
// stores tokens in gbp-tokens.json
  logger: new ConsoleLogger(), 
// optional pluggable logger
});

async function main() {

// Automatically handles token generation and pagination!
  const accounts = await client.accounts.listAll();

  if (accounts.length > 0) {
    const accountName = accounts[0].name;
    const locations = await client.locations.listAll(accountName);

    console.log(`Found ${locations.length} locations for ${accountName}`);
  }
}

main();

The project is completely open source.

I'd really appreciate feedback from anyone who has worked with the Google Business Profile API.

What features would you want to see next?

GitHub: https://github.com/vitabletech/gbp-sdk
npm: https://www.npmjs.com/package/@vitabletech/gbp-sdk

Implementing Best Practices for Developing an NPM Package with Automated Testing and Deployment

Mayank Singh Kushwah — Sun, 26 Mar 2023 06:43:09 +0000

In this repository, I have implemented an npm package that contains some useful common functions. These functions should be tested using unit test cases, and the syntax and format should be checked by ESLint during development.

Before committing the code, I have set up a pre-commit hook that checks the unit test cases and code coverage. If all the unit test cases pass, the code is ready for the commit. Additionally, I have set up a commit message format using the conventional commit standard, and the files are automatically formatted using Prettier before committing.

To push the code, you need to create a branch and generate a pull request. Once the pull request is created, SonarQube checks the code for bugs, code smells, vulnerabilities, and shows the code coverage. If there are any bugs, the pull request will not be accepted by the admin.

Once the pull request is accepted, it is merged into the main branch. After the merge, a workflow is triggered that generates the documentation of our functions and deploys it to the GitHub Pages.

If you create a tag and release the branch, an npm package is automatically created and published on the official npm package site. To download or install the package, you can run the command "npm install".

GitHub Repository URL
Documentation GitHub Pages URL
NPM Package URL
SonarQube Report

DEV Community: Mayank Singh Kushwah

An open-source Google Business Profile SDK with automatic OAuth refresh, pagination and retries.

Implementing Best Practices for Developing an NPM Package with Automated Testing and Deployment