ImageKit NestJS Module

This module integrates ImageKit with the NestJS framework, allowing you to easily use ImageKit's features in your NestJS applications.

Installation

First, install the package via npm:

1npm install imagekit-nestjs

Configuration

You can configure the ImageKitModule asynchronously to load your ImageKit credentials. Example with NestJS Config Module

First, install the necessary packages:

1npm install @nestjs/config

Then, create a configuration file (e.g., configs/imagekit.config.ts):

1import { ConfigService } from "@nestjs/config";
2import { ImageKitModuleOptions } from "imagekit-nestjs";
3
4export const ImageKitConfig = (
5  configService: ConfigService
6): ImageKitModuleOptions => ({
7  privateKey: configService.get("IMAGEKIT_PRIVATE_KEY"),
8  publicKey: configService.get("IMAGEKIT_PUBLIC_KEY"),
9  urlEndpoint: configService.get("IMAGEKIT_URL_ENDPOINT"),
10});

Update your AppModule to import the ImageKitModule with the configuration:

1import { Module } from "@nestjs/common";
2import { ConfigModule, ConfigService } from "@nestjs/config";
3import { ImageKitModule } from "imagekit-nestjs";
4import { ImageKitConfig } from "configs/imagekit.conf";
5
6@Module({
7  imports: [
8    ImageKitModule.forRootAsync({
9      useFactory: ImageKitConfig,
10      inject: [ConfigService],
11      imports: [ConfigModule],
12      isGlobal: true, // is optional
13    }),
14  ],
15})
16export class AppModule {}

Usage

You can now inject the ImageKitService into your controllers or services and use its methods. Example Controller

1import { Controller, Get } from "@nestjs/common";
2import { ImageKitService } from "imagekit-nestjs";
3
4@Controller("images")
5export class ImagesController {
6  constructor(private readonly imageKitService: ImageKitService) {}
7
8  @Get("upload")
9  async uploadImage() {
10    const result = await this.imageKitService.upload({
11      file: "your_file_path",
12      fileName: "example.jpg",
13    });
14    return result;
15  }
16}

Example Service

1import { Injectable } from "@nestjs/common";
2import { ImageKitService } from "imagekit-nestjs";
3
4@Injectable()
5export class ImagesService {
6  constructor(private readonly imageKitService: ImageKitService) {}
7
8  async uploadImage(filePath: string, fileName: string) {
9    const result = await this.imageKitService.upload({
10      file: filePath,
11      fileName: fileName,
12    });
13    return result;
14  }
15}

Using ImageKit Methods

The ImageKitService extends the official ImageKit library, so you can use all methods provided by the ImageKit library. Here are some examples: Upload an Image

1const uploadResponse = await this.imageKitService.upload({
2  file: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgA...",
3  fileName: "example.png",
4});
5console.log(uploadResponse);

Get File Details

1const fileDetails = await this.imageKitService.getFileDetails("fileId");
2console.log(fileDetails);

List Files

1const fileList = await this.imageKitService.listFiles({
2  skip: 0,
3  limit: 10,
4});
5console.log(fileList);

Delete a File

1const deleteResponse = await this.imageKitService.deleteFile("fileId");
2console.log(deleteResponse);

Refer to the official ImageKit documentation for more details on available methods. API ImageKitService

The ImageKitService extends the official ImageKit library, so all methods from the ImageKit library are available. Refer to the official ImageKit documentation for more details. Contributing

Contributions are welcome! Please open an issue or submit a pull request for any bugs or feature requests.