Resum de breaking changes a Prisma Client v6.14 i com adaptar el teu servei Prisma personalitzat a NestJS
Si fas servir Prisma ORM en un projecte NestJS i vas crear un servei Prisma personalitzat que estén el client generat, presta atenció a un canvi rellevant a la versió 6.14 de Prisma. Fins a Prisma v6.13 era comú definir un servei que estenia PrismaClient, però a partir de v6.14 aquest enfocament provoca errors de compilació i s'ha de modificar.
Patró anterior a v6.14: molts projectes tenien un servei que estenia PrismaClient i afegia la inicialització del mòdul i altres hooks. Un exemple conceptual era declarar la classe PrismaService extends PrismaClient i implementar OnModuleInit per gestionar la connexió i desconnexió.
Nova recomanació a v6.14: ja no estendre PrismaClient. En lloc d'això declara una propietat pública de tipus PrismaClient i crea la instància al constructor. D'aquesta manera el client quedarà accessible des d'altres parts del codi per fer consultes a la base de dades. Exemple conceptual d'implementació: readonly client: PrismaClient; constructor() { this.client = new PrismaClient() }
Ús actualitzat en altres serveis: quan abans es cridava this.prisma.user.findMany ara s'ha d'usar this.prisma.client.user.findMany. Aquesta substitució simple resol l'error de compilació i manté clar que la instància de PrismaClient és una propietat del servei i no la classe base.
Passos pràctics per migrar: 1 Actualitza el teu servei Prisma per eliminar extends PrismaClient i en lloc d'això declara la propietat client i crea la instància al constructor. 2 Assegura la inicialització i tancament adequats cridant a client.$connect i client.$disconnect als hooks de NestJS com OnModuleInit i OnModuleDestroy. 3 Reemplaça totes les crides this.prisma.entitat per this.prisma.client.entitat o crea getters/proxies si vols minimitzar canvis a tota la base de codi. 4 Executa proves i compila per comprovar que no queden referències a estendre el client.
Consejos addicionals: si vols evitar tocar moltes referències al codi pots afegir mètodes o getters a PrismaService que deleguin en this.client, per exemple get user() { return this.client.user } de manera que seguir usant this.prisma.user sigui possible sense estendre la classe. Una altra opció és crear helpers o wrappers per encapsular lògica d'accés a dades i mantenir un contracte estable per a la resta de l'aplicació.
Impacte en el cicle de vida i bones pràctiques: mantenir control explícit de la instància de PrismaClient facilita gestionar la connexió en entorns serverless i en processos amb reinicis. Assegura cridar a client.$connect a l'arrencada i client.$disconnect al tancament, i considera usar maneig d'errors centralitzat per reconnexions i logs.
Sobre Q2BSTUDIO: a Q2BSTUDIO som una empresa de desenvolupament de programari especialitzada en aplicacions a mida i programari a mida. Oferim solucions completes que inclouen integració d'intel·ligència artificial i IA per a empreses, desenvolupament d'agents IA i dashboards amb Power BI per a intel·ligència de negoci. També proporcionem serveis de ciberseguretat, serveis cloud AWS i Azure i consultoria per a serveis d'intel·ligència de negoci. Si necessites migrar aplicacions Node i NestJS amb Prisma, optimitzar bases de dades o integrar solucions d'IA i analítica, el nostre equip pot ajudar-te a adaptar la teva arquitectura i garantir compatibilitat i seguretat.
Paraules clau i posicionament: aplicacions a mida, programari a mida, intel·ligència artificial, ciberseguretat, serveis cloud AWS i Azure, serveis d'intel·ligència de negoci, IA per a empreses, agents IA, Power BI.
Contacte i següent pas: si vols que a Q2BSTUDIO revisem el teu projecte i fem la migració o implementem bones pràctiques amb Prisma Client v6.14, posa't en contacte amb el nostre equip per a avaluació tècnica, proposta i pressupost personalitzat.
