@infrab4a/connect-nestjs 2.0.0-alpha.9 → 3.0.0-alpha.0

package/eslint.config.js

@@ -0,0 +1,17 @@
+const baseConfig = require('../../eslint.config.js')
+
+module.exports = [
+  ...baseConfig,
+  {
+    files: ['**/*.ts'],
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.json',
+      },
+    },
+    rules: {
+      // Regras específicas para o projeto connect-nestjs
+      // Regras adaptadas para NestJS
+    },
+  },
+]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infrab4a/connect-nestjs",
-  "version": "2.0.0-alpha.9",
+  "version": "3.0.0-alpha.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   },
@@ -9,26 +9,15 @@
     "url": "https://github.com/B4AGroup/b4a-firebase-libs"
   },
   "peerDependencies": {
-    "@infrab4a/connect": "5.0.0-alpha.8",
+    "@infrab4a/connect": "6.0.0-alpha.0",
     "@nestjs/common": "^10.3.3",
     "@nestjs/core": "^10.3.3",
-    "firebase-admin": "^12.0.0",
-    "reflect-metadata": "^0.1.13"
+    "firebase-admin": "^12.0.0"
   },
   "dependencies": {
     "@elastic/elasticsearch": "^8.13.1",
     "@google-cloud/discoveryengine": "^1.14.0",
     "nestjs-firebase": "^10.4.0",
     "pagarme": "4.35.2"
-  },
-  "exports": {
-    "./package.json": "./package.json",
-    ".": {
-      "module": "./index.esm.js",
-      "import": "./index.cjs.mjs",
-      "default": "./index.cjs.js"
-    }
-  },
-  "module": "./index.esm.js",
-  "main": "./index.cjs.js"
+  }
 }

package/project.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "name": "connect-nestjs",
+  "projectType": "library",
+  "sourceRoot": "projects/connect-nestjs/src",
+  "prefix": "infrab4a",
+  "tags": ["type:lib", "scope:publishable", "framework:nestjs"],
+  "targets": {
+    "build": {
+      "executor": "@nx/rollup:rollup",
+      "dependsOn": ["connect:build"],
+      "options": {
+        "main": "projects/connect-nestjs/src/index.ts",
+        "tsConfig": "projects/connect-nestjs/tsconfig.lib.json",
+        "project": "projects/connect-nestjs/package.json",
+        "outputPath": "dist/connect-nestjs",
+        "publishable": true,
+        "format": ["cjs", "esm"],
+        "compiler": "tsc",
+        "generateExportsField": true,
+        "clean": true,
+        "external": ["@infrab4a/connect"],
+        "rollupConfig": "projects/connect-nestjs/rollup.config.js"
+      },
+      "configurations": {
+        "production": {
+          "tsConfig": "projects/connect-nestjs/tsconfig.lib.prod.json",
+          "optimization": true,
+          "external": ["@infrab4a/connect"]
+        }
+      },
+      "outputs": ["{workspaceRoot}/dist/connect-nestjs"]
+    },
+    "test": {
+      "executor": "@angular-devkit/build-angular:karma",
+      "options": {
+        "main": "projects/connect-nestjs/src/test.ts",
+        "tsConfig": "projects/connect-nestjs/tsconfig.spec.json",
+        "karmaConfig": "projects/connect-nestjs/karma.conf.js"
+      }
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "options": {
+        "lintFilePatterns": ["projects/connect-nestjs/**/*.ts"]
+      }
+    }
+  }
+}

package/rollup.config.js

@@ -0,0 +1,17 @@
+const { join } = require('path')
+
+module.exports = (config) => {
+  return {
+    ...config,
+    external: [
+      '@infrab4a/connect',
+      '@nestjs/common',
+      '@nestjs/core',
+      'firebase-admin',
+      '@elastic/elasticsearch',
+      '@google-cloud/discoveryengine',
+      'nestjs-firebase',
+      'pagarme',
+    ],
+  }
+}

package/src/consts/es-config.const.ts

@@ -0,0 +1 @@
+export const ES_CONFIG = 'ES_CONFIG'

package/src/consts/hasura-options.const.ts

@@ -0,0 +1 @@
+export const HASURA_OPTIONS = 'HASURA_OPTIONS'

package/src/consts/index.ts

@@ -0,0 +1,4 @@
+export * from './es-config.const'
+export * from './hasura-options.const'
+export * from './storage.const'
+export * from './vertex-config.const'

package/src/consts/storage.const.ts

@@ -0,0 +1 @@
+export const FIREBASE_STORAGE = 'FIREBASE_STORAGE'

package/src/consts/vertex-config.const.ts

@@ -0,0 +1 @@
+export const VERTEX_CONFIG = 'VERTEX_CONFIG'

package/src/index.ts

@@ -0,0 +1,7 @@
+export * from './consts'
+export * from './infra'
+export * from './nest-connect.module'
+export * from './nest-elastic-search.module'
+export * from './nest-firestore.module'
+export * from './nest-hasura-graphql.module'
+export * from './nest-storage.module'

package/src/infra/elasticsearch/adapters/index.ts

@@ -0,0 +1 @@
+export * from './native-elasticsearch-adapter'

package/src/infra/elasticsearch/adapters/native-elasticsearch-adapter.ts

@@ -0,0 +1,137 @@
+import { Client } from '@elastic/elasticsearch'
+import {
+  BaseModel,
+  DebugHelper,
+  ElasticSearchAdapter,
+  ElasticSearchResult,
+  NotFoundError,
+  isEmpty,
+} from '@infrab4a/connect'
+import { Inject, Injectable } from '@nestjs/common'
+
+import { ES_CONFIG } from '../../../consts'
+
+export interface ESClientOptions {
+  cloud: { id: string }
+  auth: { apiKey: string }
+}
+
+@Injectable()
+export class NativeElasticSearchAdapter<T extends BaseModel<T> = any> implements ElasticSearchAdapter<T> {
+  private client: Client
+  private logger: DebugHelper
+
+  constructor(@Inject(ES_CONFIG) config: ESClientOptions) {
+    this.logger = DebugHelper.from(this)
+
+    try {
+      this.client = !isEmpty(config.cloud.id) && !isEmpty(config.auth.apiKey) && new Client(config)
+    } catch (error) {
+      this.logger.error({ req: config, res: error })
+
+      throw error
+    }
+  }
+
+  public async get(index: string, id: string): Promise<T> {
+    const logger = this.logger.with('get')
+    const req = { index, id }
+
+    try {
+      const data = await this.client.get({ index, id })
+
+      logger.log({ req, res: data })
+
+      return data._source as T
+    } catch (error) {
+      const message = error instanceof Error ? error.message : `${index}/${id} not found`
+
+      logger.log({ req, res: error })
+
+      throw new NotFoundError(message)
+    }
+  }
+
+  public async query(index: string, query: any): Promise<ElasticSearchResult<T>> {
+    const logger = this.logger.with('query')
+    const params = {
+      index,
+      query,
+    }
+
+    try {
+      const result = await this.client.search(params)
+      const res = {
+        total: result.hits.total as number,
+        hits: result.hits.hits as ElasticSearchResult<T>['hits'],
+      }
+
+      logger.log({ req: params, res })
+
+      return res
+    } catch (error) {
+      logger.error({ req: params, res: error })
+
+      throw error
+    }
+  }
+
+  public async save(index: string, data: T): Promise<void> {
+    const logger = this.logger.with('save')
+    const req = {
+      index,
+      id:
+        data.identifiersFields.length > 1
+          ? JSON.stringify(data.identifier)
+          : Object.values(data.identifier).shift().toString(),
+      document: data.toPlain(),
+    }
+
+    try {
+      const res = await this.client.index(req)
+
+      logger.log({ req, res })
+    } catch (error) {
+      logger.error({ req, res: error })
+
+      throw error
+    }
+  }
+
+  public async update(index: string, id: string, data: Partial<T>): Promise<void> {
+    const logger = this.logger.with('update')
+    const req = {
+      index,
+      id,
+      doc: data,
+    }
+
+    try {
+      await this.client.update(req)
+
+      logger.log({ req, res: undefined })
+    } catch (error) {
+      logger.error({ req, res: error })
+
+      throw error
+    }
+  }
+
+  public async delete(index: string, id: string): Promise<void> {
+    const logger = this.logger.with('delete')
+    const req = {
+      index,
+      id,
+    }
+
+    try {
+      await this.client.delete(req)
+
+      logger.log({ req, res: undefined })
+    } catch (error) {
+      logger.error({ req, res: error })
+
+      throw error
+    }
+  }
+}

package/src/infra/elasticsearch/index.ts

@@ -0,0 +1 @@
+export * from './adapters'

package/src/infra/firebase/firestore/index.ts

@@ -0,0 +1,2 @@
+export * from './services'
+export * from './types'

package/src/infra/firebase/firestore/services/connect-collection-reference.ts

@@ -0,0 +1,27 @@
+import {
+  ConnectDocumentData,
+  ConnectDocumentSnapshot,
+  ConnectQuerySnapshot,
+  ConnectSnapshotOptions,
+  ConnectWhereOption,
+} from '@infrab4a/connect'
+
+import { ConnectDocumentReference } from './connect-document-reference'
+
+export interface ConnectCollectionReference<T extends ConnectDocumentData> {
+  add(data: T, id?: string): Promise<ConnectDocumentReference<T>>
+  where(attribute: string, operator: ConnectWhereOption, value: any): ConnectCollectionReference<T>
+  order(attribute: string, order: 'asc' | 'desc'): ConnectCollectionReference<T>
+  limit(quantity: number): ConnectCollectionReference<T>
+  offset(offset: number): ConnectCollectionReference<T>
+  fromStartAt(startAt: number): ConnectCollectionReference<T>
+  fromStartAt(startAt: ConnectDocumentReference<T>): ConnectCollectionReference<T>
+  fromStartAfter(startAt: number): ConnectCollectionReference<T>
+  fromStartAfter(startAt: ConnectDocumentReference<T>): ConnectCollectionReference<T>
+  withConverter(converter: {
+    toFirestore: (data: T) => ConnectDocumentData<T>
+    fromFirestore: (snapshot: ConnectDocumentSnapshot<T>, options?: ConnectSnapshotOptions) => T
+  }): ConnectCollectionReference<T>
+  getDoc(id?: string): ConnectDocumentReference<T>
+  getDocs(): Promise<ConnectQuerySnapshot<T>>
+}

package/src/infra/firebase/firestore/services/connect-collection.service.ts

@@ -0,0 +1,137 @@
+import {
+  ConnectDocumentData,
+  ConnectDocumentSnapshot,
+  ConnectQuerySnapshot,
+  ConnectSnapshotOptions,
+  ConnectWhereOption,
+  isEmpty,
+} from '@infrab4a/connect'
+import {
+  CollectionReference,
+  DocumentReference,
+  Firestore,
+  Query,
+  QueryDocumentSnapshot,
+} from 'firebase-admin/firestore'
+
+import { ConnectBaseDocumentSnapshot } from '../vo'
+
+import { ConnectCollectionReference } from './connect-collection-reference'
+import { ConnectDocumentReference } from './connect-document-reference'
+import { ConnectDocumentService } from './connect-document.service'
+
+export class ConnectCollectionService<T extends ConnectDocumentData> implements ConnectCollectionReference<T> {
+  private reference: CollectionReference<T>
+  private query: Query
+  private orderBy: { fieldPath: string; directionStr: 'asc' | 'desc' }
+  private limitBy: number
+  private offsetBy: number
+  private startingAt: number | unknown
+  private startingAfter: number | unknown
+  private converter: {
+    toFirestore: (data: T) => ConnectDocumentData<T>
+    fromFirestore: (snapshot: ConnectDocumentSnapshot<T>, options?: ConnectSnapshotOptions) => T
+  }
+
+  constructor(path: string, private readonly firestore: Firestore) {
+    this.reference = firestore.collection(path).withConverter({
+      toFirestore: (data) => data,
+      fromFirestore: (snapshot) => {
+        return { id: snapshot.id, ...snapshot.data() } as T
+      },
+    })
+  }
+
+  async add(data: T, id?: string): Promise<ConnectDocumentReference<T>> {
+    const newDoc = await this.save(data, id)
+
+    return new ConnectDocumentService<T>(newDoc.path, this.firestore).withConverter(this.converter)
+  }
+
+  async getDocs(): Promise<ConnectQuerySnapshot<T>> {
+    if (this.startingAt) this.limitBy += this.startingAt as number
+
+    let query = this.query ? this.query : this.reference
+
+    query = this.orderBy ? query.orderBy(this.orderBy.fieldPath, this.orderBy.directionStr) : query
+    query = this.limitBy ? query.limit(this.limitBy) : query
+
+    return query.get().then((docs) => {
+      const docsPaginated = this.startingAt ? docs.docs.slice(this.startingAt as number, this.limitBy) : docs.docs
+
+      return {
+        empty: Boolean(docsPaginated.length),
+        size: docsPaginated.length,
+        docs: docsPaginated.map((doc) => new ConnectBaseDocumentSnapshot(doc)),
+      } as any
+    })
+  }
+
+  getDoc(id?: string): ConnectDocumentReference<T> {
+    return new ConnectDocumentService<T>(`${this.reference.path}/${id}`, this.firestore).withConverter(this.converter)
+  }
+
+  where(fieldPath: string, opStr: ConnectWhereOption, value: any): ConnectCollectionReference<T> {
+    this.query = this.query ? this.query.where(fieldPath, opStr, value) : this.reference.where(fieldPath, opStr, value)
+
+    return this
+  }
+
+  order(attribute: string, order: 'asc' | 'desc'): ConnectCollectionReference<T> {
+    this.orderBy = { fieldPath: attribute, directionStr: order }
+
+    return this
+  }
+
+  limit(quantity: number): ConnectCollectionReference<T> {
+    this.limitBy = quantity
+
+    return this
+  }
+
+  offset(offsetBy: number): ConnectCollectionReference<T> {
+    this.offsetBy = offsetBy
+
+    return this
+  }
+
+  fromStartAt(startingAt: number): ConnectCollectionReference<T>
+  fromStartAt(startingAt: ConnectDocumentReference<T>): ConnectCollectionReference<T>
+  fromStartAt(startingAt: unknown): ConnectCollectionReference<T> {
+    this.startingAt = startingAt
+
+    return this
+  }
+
+  fromStartAfter(startingAt: number): ConnectCollectionReference<T>
+  fromStartAfter(startingAt: ConnectDocumentReference<T>): ConnectCollectionReference<T>
+  fromStartAfter(startingAt: unknown): ConnectCollectionReference<T> {
+    this.startingAfter = startingAt
+
+    return this
+  }
+
+  withConverter(params: {
+    toFirestore: (data: T) => ConnectDocumentData<T>
+    fromFirestore: (snapshot: ConnectDocumentSnapshot<T>, options?: ConnectSnapshotOptions) => T
+  }): ConnectCollectionReference<T> {
+    this.converter = params
+    this.reference = this.reference.withConverter({
+      toFirestore: (data: T) => params.toFirestore(data),
+      fromFirestore: (snapshot: QueryDocumentSnapshot<T>, options?: ConnectSnapshotOptions) =>
+        params.fromFirestore(new ConnectBaseDocumentSnapshot(snapshot), options),
+    })
+
+    return this
+  }
+
+  private async save(data: T, id?: string): Promise<DocumentReference<T>> {
+    if (isEmpty(id)) return this.reference.add(data)
+
+    const docRef = this.reference.doc(id)
+
+    await docRef.set(data)
+
+    return docRef
+  }
+}

package/src/infra/firebase/firestore/services/connect-document-reference.ts

@@ -0,0 +1,12 @@
+import { ConnectDocumentData, ConnectDocumentSnapshot, ConnectSnapshotOptions } from '@infrab4a/connect'
+
+export interface ConnectDocumentReference<T extends ConnectDocumentData> {
+  get(): Promise<ConnectDocumentSnapshot<T>>
+  getId(): string
+  save(data: T): Promise<ConnectDocumentReference<T>>
+  delete(): Promise<void>
+  withConverter(converter: {
+    toFirestore: (data: T) => ConnectDocumentData<T>
+    fromFirestore: (snapshot: ConnectDocumentSnapshot<T>, options?: ConnectSnapshotOptions) => T
+  }): ConnectDocumentReference<T>
+}

package/src/infra/firebase/firestore/services/connect-document.service.ts

@@ -0,0 +1,51 @@
+import { ConnectDocumentData, ConnectDocumentSnapshot, ConnectSnapshotOptions } from '@infrab4a/connect'
+import { DocumentReference, Firestore, QueryDocumentSnapshot } from 'firebase-admin/firestore'
+
+import { ConnectBaseDocumentSnapshot } from '../vo'
+
+import { ConnectDocumentReference } from './connect-document-reference'
+
+export class ConnectDocumentService<T extends ConnectDocumentData> implements ConnectDocumentReference<T> {
+  private reference: DocumentReference<T>
+
+  constructor(private path: string, private firestore: Firestore) {
+    this.reference = this.firestore.doc(this.path).withConverter({
+      toFirestore: (data) => data as any,
+      fromFirestore: (snapshot) => {
+        return { id: snapshot.id, ...snapshot.data() } as T
+      },
+    })
+  }
+
+  async get(): Promise<ConnectDocumentSnapshot<T>> {
+    return new ConnectBaseDocumentSnapshot(await this.reference.get())
+  }
+
+  getId(): string {
+    return this.reference.id
+  }
+
+  async save(data: T): Promise<ConnectDocumentReference<T>> {
+    if (this.reference) this.reference.update(data)
+    else await this.reference.set(data)
+
+    return this
+  }
+
+  async delete(): Promise<void> {
+    await this.reference.delete()
+  }
+
+  withConverter(params: {
+    toFirestore: (data: T) => ConnectDocumentData<T>
+    fromFirestore: (snapshot: ConnectDocumentSnapshot<T>, options?: ConnectSnapshotOptions) => T
+  }): ConnectDocumentReference<T> {
+    this.reference = this.reference.withConverter({
+      toFirestore: (data: T) => params.toFirestore(data),
+      fromFirestore: (snapshot: QueryDocumentSnapshot<T>, options?: ConnectSnapshotOptions) =>
+        params.fromFirestore(new ConnectBaseDocumentSnapshot(snapshot), options),
+    })
+
+    return this
+  }
+}

package/src/infra/firebase/firestore/services/connect-firestore.service.ts

@@ -0,0 +1,24 @@
+import {
+  ConnectCollectionReference,
+  ConnectDocumentData,
+  ConnectDocumentReference,
+  ConnectFirestore,
+} from '@infrab4a/connect'
+import { Injectable } from '@nestjs/common'
+import { Firestore } from 'firebase-admin/firestore'
+
+import { ConnectCollectionService } from './connect-collection.service'
+import { ConnectDocumentService } from './connect-document.service'
+
+@Injectable()
+export class ConnectFirestoreService implements ConnectFirestore {
+  constructor(private readonly firestore: Firestore) {}
+
+  public getCollection<T extends ConnectDocumentData>(path: string): ConnectCollectionReference<T> {
+    return new ConnectCollectionService<T>(path, this.firestore)
+  }
+
+  public getDocument<T extends ConnectDocumentData>(path: string): ConnectDocumentReference<T> {
+    return new ConnectDocumentService<T>(path, this.firestore)
+  }
+}

package/src/infra/firebase/firestore/services/connect-firestore.ts

@@ -0,0 +1,9 @@
+import { ConnectDocumentData } from '@infrab4a/connect'
+
+import { ConnectCollectionReference } from './connect-collection-reference'
+import { ConnectDocumentReference } from './connect-document-reference'
+
+export interface ConnectFirestore {
+  getCollection<T extends ConnectDocumentData>(path: string): ConnectCollectionReference<T>
+  getDocument<T extends ConnectDocumentData>(path: string): ConnectDocumentReference<T>
+}

package/src/infra/firebase/firestore/services/index.ts

@@ -0,0 +1,6 @@
+export * from './connect-collection-reference'
+export * from './connect-collection.service'
+export * from './connect-document-reference'
+export * from './connect-document.service'
+export * from './connect-firestore'
+export * from './connect-firestore.service'

package/src/infra/firebase/firestore/types/connect-query-snapshot.type.ts

@@ -0,0 +1,6 @@
+import { ConnectDocumentData, ConnectDocumentSnapshot as ConnectDocumentSnapshotBase } from '@infrab4a/connect'
+
+export type ConnectDocumentSnapshot<T extends ConnectDocumentData = ConnectDocumentData> =
+  ConnectDocumentSnapshotBase<T> & {
+    exists: boolean
+  }

package/src/infra/firebase/firestore/types/index.ts

@@ -0,0 +1 @@
+export * from './connect-query-snapshot.type'

package/src/infra/firebase/firestore/vo/connect-base-document-snapshot.vo.ts

@@ -0,0 +1,27 @@
+import { ConnectDocumentData, ConnectSnapshotOptions } from '@infrab4a/connect'
+import { DocumentSnapshot } from 'firebase-admin/firestore'
+
+import { ConnectDocumentSnapshot } from '../types'
+
+export class ConnectBaseDocumentSnapshot<T extends ConnectDocumentData = ConnectDocumentData>
+  implements ConnectDocumentSnapshot<T>
+{
+  public id: string
+  public exists: boolean
+
+  constructor(private readonly connectDocumentSnapshot: DocumentSnapshot<T>) {
+    this.id = connectDocumentSnapshot.id
+  }
+
+  public isNotEmpty(): boolean {
+    return this.connectDocumentSnapshot.exists
+  }
+
+  public data(_options?: ConnectSnapshotOptions): T {
+    return this.connectDocumentSnapshot.data()
+  }
+
+  public get(fieldPath: string) {
+    return this.connectDocumentSnapshot.get(fieldPath)
+  }
+}

package/src/infra/firebase/firestore/vo/index.ts

@@ -0,0 +1 @@
+export * from './connect-base-document-snapshot.vo'

package/src/infra/firebase/index.ts

@@ -0,0 +1 @@
+export * from './firestore'

package/src/infra/index.ts

@@ -0,0 +1,4 @@
+export * from './elasticsearch'
+export * from './firebase'
+export * from './pagarme'
+export * from './vertex-ai'

package/src/infra/pagarme/adapters/index.ts

@@ -0,0 +1,3 @@
+export * from './pagarme-bank-slip-api.adapter'
+export * from './pagarme-card-api.adapter'
+export * from './pagarme-pix-api.adapter'