Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/svtslv/nestjs-geoip2

Maxmind GeoIP2 module for Nest
https://github.com/svtslv/nestjs-geoip2

geoip2 maxmind nest nestjs

Last synced: 3 months ago
JSON representation

Maxmind GeoIP2 module for Nest

Awesome Lists containing this project

README

        

# NestJS GeoIP2

NPM Version
Package License

## Table of Contents

- [Description](#description)
- [Installation](#installation)
- [Examples](#examples)
- [License](#license)

## Description
Integrates MaxMind GeoIP2 with Nest

## Installation

```sh
npm install nestjs-geoip2 @maxmind/geoip2-node
```

You can also use the interactive CLI

```sh
npx nestjs-modules
```

## Examples

```sh
npx geoip2-cli --download --licenseKey=MAXMIND_LICENSE_KEY
```

### GeoIP2Module.forRoot(options, connection?)

```ts
import { Module } from '@nestjs/common';
import { GeoIP2Module } from 'nestjs-geoip2';
import { AppController } from './app.controller';
import { join } from 'path';

@Module({
imports: [
GeoIP2Module.forRoot({
config: {
file: join(process.cwd(), 'geoip2-cli', 'GeoLite2-City.mmdb'),
},
}),
],
controllers: [AppController],
})
export class AppModule {}
```

### GeoIP2Module.forRootAsync(options, connection?)

```ts
import { Module } from '@nestjs/common';
import { GeoIP2Module } from 'nestjs-geoip2';
import { AppController } from './app.controller';
import { join } from 'path';

@Module({
imports: [
GeoIP2Module.forRootAsync({
useFactory: () => ({
config: {
file: join(process.cwd(), 'geoip2-cli', 'GeoLite2-City.mmdb'),
},
}),
}),
],
controllers: [AppController],
})
export class AppModule {}
```

### InjectGeoIP2(connection?)

```ts
import { Controller, Get, } from '@nestjs/common';
import { InjectGeoIP2, GeoIP2 } from 'nestjs-geoip2';

@Controller()
export class AppController {
constructor(
@InjectGeoIP2() private readonly geoIP2: GeoIP2,
) {}

@Get()
async getHello() {
return await this.geoIP2.city('8.8.8.8');
}
}
```

## License

MIT