@prisma/client 6.19.0: PrismaClient

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify PrismaClient in pkg:npm/%40prisma/client@6.19.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/%40prisma/client@6.19.0
Demonstrate these symbols/APIs:
  - PrismaClient

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:98900883ce51a41dc5e7874c6b8f22c23f3580f3c0d8bd3b3b111a8456576203","contract":["PrismaClient is exported as a constructor class by @prisma/client","PrismaClient constructor throws an Error explaining client must be generated when instantiated before prisma generate","PrismaClient constructor error message explicitly instructs running prisma generate","PrismaClient constructor throws uninitialized error regardless of initialization options provided","PrismaClient can be extended as a base class through standard class inheritance"],"goal":"verify PrismaClient in pkg:npm/%40prisma/client@6.19.0","kind":"HOW","packages":["pkg:npm/%40prisma/client@6.19.0"],"schemaVersion":1,"symbols":["PrismaClient"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/%40prisma/client@6.19.0"],"schemaVersion":1,"subject":"pkg:npm/%40prisma/client@6.19.0","symbols":["PrismaClient"],"verifierAdapter":"node-typescript@1"}

import fs from 'node:fs';
import path from 'node:path';
import { execSync } from 'node:child_process';

const dotPrismaPath = path.resolve('node_modules/.prisma/client/default.js');
if (!fs.existsSync(dotPrismaPath)) {
  const postinstallPath = path.resolve('node_modules/@prisma/client/scripts/postinstall.js');
  if (fs.existsSync(postinstallPath)) {
    execSync(`node "${postinstallPath}"`, { stdio: 'pipe' });
  }
}

const pkg = (await import('@prisma/client')).default;
export const { Prisma, PrismaClient } = pkg;
export default PrismaClient;

{
  "name": "sample-prisma-client",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-prisma-client",
      "version": "1.0.0",
      "dependencies": {
        "@prisma/client": "6.19.0"
      }
    },
    "node_modules/@prisma/client": {
      "version": "6.19.0",
      "resolved": "https://registry.npmjs.org/@prisma/client/-/client-6.19.0.tgz",
      "integrity": "sha512-QXFT+N/bva/QI2qoXmjBzL7D6aliPffIwP+81AdTGq0FXDoLxLkWivGMawG8iM5B9BKfxLIXxfWWAF6wbuJU6g==",
      "hasInstallScript": true,
      "license": "Apache-2.0",
      "engines": {
        "node": ">=18.18"
      },
      "peerDependencies": {
        "prisma": "*",
        "typescript": ">=5.1.0"
      },
      "peerDependenciesMeta": {
        "prisma": {
          "optional": true
        },
        "typescript": {
          "optional": true
        }
      }
    }
  }
}

{
  "name": "sample-prisma-client",
  "version": "1.0.0",
  "type": "module",
  "private": true,
  "dependencies": {
    "@prisma/client": "6.19.0"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify PrismaClient in pkg:npm/%40prisma/client@6.19.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/%40prisma/client@6.19.0"
  ],
  "symbols": [
    "PrismaClient"
  ]
}

import assert from 'node:assert/strict';
import { PrismaClient, Prisma } from '../index.mjs';

// Contract 1: PrismaClient is exported as a constructor class by @prisma/client
{
  assert.strictEqual(typeof PrismaClient, 'function', 'PrismaClient must be exported as a constructor function');
  assert.strictEqual(PrismaClient.name, 'PrismaClient', 'PrismaClient class name must be PrismaClient');
}

// Contract 2: PrismaClient constructor throws an Error explaining client must be generated when instantiated before prisma generate
{
  assert.throws(
    () => new PrismaClient(),
    (err) => {
      assert(err instanceof Error, 'Thrown value must be an Error instance');
      assert.match(err.message, /@prisma\/client did not initialize yet/, 'Error message must state client did not initialize yet');
      return true;
    }
  );
}

// Contract 3: PrismaClient constructor error message explicitly instructs running prisma generate
{
  assert.throws(
    () => new PrismaClient(),
    (err) => {
      assert(err instanceof Error, 'Thrown value must be an Error instance');
      assert.match(err.message, /prisma generate/, 'Error message must instruct caller to run prisma generate');
      return true;
    }
  );
}

// Contract 4: PrismaClient constructor throws uninitialized error regardless of initialization options provided
{
  assert.throws(
    () => new PrismaClient({ datasourceUrl: 'file:./test.db', log: ['query', 'error'] }),
    (err) => {
      assert(err instanceof Error, 'Thrown value must be an Error instance');
      assert.match(err.message, /@prisma\/client did not initialize yet/, 'Options must not bypass initialization requirement');
      return true;
    }
  );
}

// Contract 5: PrismaClient can be extended as a base class through standard class inheritance
{
  class CustomPrismaClient extends PrismaClient {
    customMethod() {
      return 'custom-value';
    }
  }

  assert.strictEqual(Object.getPrototypeOf(CustomPrismaClient), PrismaClient, 'Custom class must inherit from PrismaClient');
  assert.strictEqual(typeof CustomPrismaClient.prototype.customMethod, 'function', 'Subclass methods must be defined');

  assert.throws(
    () => new CustomPrismaClient(),
    (err) => {
      assert(err instanceof Error, 'Subclass instantiation without generated client must throw Error');
      assert.match(err.message, /@prisma\/client did not initialize yet/, 'Subclass constructor must invoke super and throw uninitialized error');
      return true;
    }
  );
}

console.log('All contract assertions passed.');