JSPM

  • Created
  • Published
  • Downloads 285
  • Score
    100M100P100Q95653F
  • License ISC

Nestjs Drizzle ORM Helper Module

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (nestjs-drizzle) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    Nest.js Drizzle

    Todo List

    • mysql2
    • node-postgres
    • supabase
    • sqlite
    • planetscale
    • neon
    • vercel postgres
    • turso
    npm install nestjs-drizzle

    For schema

    // drizzle/schemas/users.ts
    import { pgTable, varchar, uuid, timestamp } from 'drizzle-orm/pg-core';
    
    export const users = pgTable('users', {
      id: uuid('id').unique().primaryKey().defaultRandom(),
    
      username: varchar('name', { length: 255 }).notNull(),
      password: varchar('password', { length: 255 }).notNull(),
    
      // more schema
    });
    
    // drizzle/schema.ts
    export * from './schemas/users.ts'

    app.module.ts

    import { DrizzleModule } from 'nestjs-drizzle/mysql';
    
    @Module({
      imports: [
        // in default DrizzleModule gets url from .env DATABASE_URL
        DrizzleModule.forRoot(),
        // or
        DrizzleModule.forRoot({ connectionString: process.env.DATABASE_URL })
      ]
    })

    I recomend to use global.d.ts file for env type safety.

    // For quering data
    declare type ISchema = typeof import('your/path/schema');
    
    declare namespace NodeJS {
      interface ProcessEnv {
        [key: string]: string | undefined;
        DATABASE_URL: string;
        // add more environment variables and their types here
      }
    }

    any.service.ts

    import { Injectable } from "@nestjs/common";
    import { DrizzleService } from "nestjs-drizzle/mysql";
    import { users } from "./drizzle";
    import { isNull } from "drizzle-orm";
    
    @Injectable()
    export class AppService {
      constructor(private readonly drizzle: DrizzleService<ISchema>) {}
    
      async getManyUsers() {
        const users = await this.drizzle.get(users, {
          id: users.id,
          username: users.username,
        });
    
        return users;
      }
    
      async getOneUser(id: string) {
        const [user] = await this.drizzle
          .get(users, {
            id: users.id,
            username: users.username,
          })
          .where(eq(users.id, id));
    
        return user;
      }
    }

    Other helper functions

    // values is basicly drizzle set
    this.drizzle.insert(users, values);
    
    this.drizzle.update(users, values).where(eq(users.id, 10));
    // Increment | Decrement
    this.drizzle.update(users, {
      age: increment(users.age, 20)
    }).where(eq(users.id, 10));
    
    this.drizzle.delete(users).where(eq(users.id, 10));
    
    this.drizzle.query.users.findFirst();

    if you need to other features

    this.drizzle.db; // main db
    
    this.drizzle.delete(users).where(eq(users.id, 10)).prepare();
    
    this.drizzle.insert(users, values).$dynamic;

    Using query

    import { DrizzleService } from "nestjs-drizzle/postgres";
    import * as schema from '/your/path/schema';
    
    @Injectable()
    export class AppService {
      constructor(
        private readonly drizzle: DrizzleService<ISchema> // <- put here <ISchema>
        // or
        private readonly drizzle: DrizzleService<typeof schema> // <- or put here <typeof schema>
      ) {}
    
      getUsers() {
        this.drizzle.query.users.findMany({
          columns: {
            id: true,
            name: true,
          },
          limit: 10,
        });
      }
    }