fix(testcontainers): create template_db explicitly + throw on failed schema push

Author: nicktrn

internal-packages/testcontainers/src/index.ts

@@ -151,6 +151,18 @@ const getWorkerPostgresContainer = () => {
       const container = await withCiResourceLimits(new PostgreSqlContainer("docker.io/postgres:14"))
         .withCommand(["-c", "listen_addresses=*", "-c", "wal_level=logical"])
         .start();
+      // Create the template db explicitly via an admin connection (the same primitive the per-test
+      // clone uses) instead of relying on `prisma db push` to create a missing database. That
+      // create-if-missing path behaves differently on CI and - because push errors were swallowed -
+      // surfaced only later as a confusing "template database template_db does not exist" at clone
+      // time. Pushing into an already-existing db is the path the pre-worker-scope code always used.
+      const admin = new PrismaClient({
+        datasources: {
+          db: { url: postgresUriWithDatabase(container.getConnectionUri(), "postgres") },
+        },
+      });
+      await admin.$executeRawUnsafe(`CREATE DATABASE "${POSTGRES_TEMPLATE_DB}"`);
+      await admin.$disconnect();
       await pushDatabaseSchema(
         postgresUriWithDatabase(container.getConnectionUri(), POSTGRES_TEMPLATE_DB)
       );

internal-packages/testcontainers/src/utils.ts

@@ -19,11 +19,13 @@ export function postgresUriWithDatabase(uri: string, database: string): string {
   return url.toString();
 }
 
-/** Pushes the Prisma schema into the database at `databaseUrl` (creating it if missing). */
+/** Pushes the Prisma schema into the database at `databaseUrl` (which must already exist). */
 export async function pushDatabaseSchema(databaseUrl: string) {
   const databasePath = path.resolve(__dirname, "../../database");
 
-  await x(
+  // throwOnError is essential: without it tinyexec swallows a non-zero `prisma db push`, so a failed
+  // push looks like success and only surfaces much later as a confusing downstream error.
+  const result = await x(
     `${databasePath}/node_modules/.bin/prisma`,
     [
       "db",
@@ -35,6 +37,7 @@ export async function pushDatabaseSchema(databaseUrl: string) {
       `${databasePath}/prisma/schema.prisma`,
     ],
     {
+      throwOnError: true,
       nodeOptions: {
         env: {
           ...process.env,
@@ -44,6 +47,8 @@ export async function pushDatabaseSchema(databaseUrl: string) {
       },
     }
   );
+
+  return result;
 }
 
 /**