fix(client): safe and unsafe raw queries

[millsp]

Fixes #7142
Fixes #8189
Fixes #8808

BREAKING CHANGE

[Jolg42]

Looks good! (didn't review everything in detail yet though)

See comment

and what's the state of

TODO:

    add runtime checks (exceptions)

Do not merge now I guess, only for next release?

[millsp]

@Jolg42 the current changes are TS-only changes, we'd like to add an error for JS users too (runtime).

[janpio]

Tracked in #8808 now

[Jolg42]

Looks great! Added a few comments

And need to check the failing tests

FAIL src/__tests__/integration/happy/raw-transactions/test.ts (5.761 s)
  ● transaction › queryRaw

    All elements of the array need to be Prisma Client promises. Hint: Please make sure you are not awaiting the Prisma client calls you intended to pass in the $transaction function.

      977 |           !p?.isExecuteRaw
      978 |         ) {
    > 979 |           throw new Error(
          |                 ^
      980 |             `All elements of the array need to be Prisma Client promises. Hint: Please make sure you are not awaiting the Prisma client calls you intended to pass in the $transaction function.`,
      981 |           )
      982 |         }

      at PrismaClient.$___transactionInternal (src/runtime/getPrismaClient.ts:979:17)
      at PrismaClient.$___transaction (src/runtime/getPrismaClient.ts:1015:21)
      at PrismaClient.$transaction (src/runtime/getPrismaClient.ts:1031:21)
      at Object.<anonymous> (src/__tests__/integration/happy/raw-transactions/test.ts:21:30)
...
...

[Jolg42]

Pre-approval, for the small changes in progress

[Jolg42]

Nice documentation! 💚