feat(prisma): prisma postgres resources #1053

sorenbs · 2025-10-02T10:41:14Z

No description provided.

sam-goodwin · 2025-10-02T10:57:21Z

alchemy/src/prisma/postgres/api.ts

+/**
+ * Minimal client for the Prisma Postgres Management API
+ */
+export class PrismaPostgresApi {


We've been trying to move away from hand-coding the API clients.

Does Prisma have a generated TypeScript SDK for its control plane?

@john-royal has been standardizing our API generation with hey-api. @john-royal, maybe you can take a look at their API spec and see how well it generates.

We don't have TypeScript SDK. hey-api looks really interesting.

Would it be an option to use the hand-coded API client initially, and switch to a prisma provided SDK later?

pkg-pr-new · 2025-10-02T11:01:45Z

Open in StackBlitz

npm i https://pkg.pr.new/alchemy-run/alchemy@1053

commit: 750e9b9

sam-goodwin · 2025-10-02T11:04:32Z

This is very exciting @sorenbs. Great job.

Does Prisma Postgres support branching? I found this doc which indicates it does: https://www.prisma.io/blog/introducing-platform-environments

One feature to make sure we nail here would be CI/CD (see https://alchemy.run/guides/ci/).

The ideal workflow is to have each PR deploy a branched copy of the infrastructure. It's not always possible depending on the service, but Planetscale and Neon each have branching capability exposed as Alchemy Resources that slot in nicely to Alchemy's CI/CD.

sorenbs · 2025-10-02T11:30:11Z

This is very exciting @sorenbs. Great job.

Does Prisma Postgres support branching? I found this doc which indicates it does: https://www.prisma.io/blog/introducing-platform-environments

One feature to make sure we nail here would be CI/CD (see https://alchemy.run/guides/ci/).

The ideal workflow is to have each PR deploy a branched copy of the infrastructure. It's not always possible depending on the service, but Planetscale and Neon each have branching capability exposed as Alchemy Resources that slot in nicely to Alchemy's CI/CD.

We don't support Branching natively yet, but we have the ability to create a database from a snapshot. Currently a snapshot can only be created from the Console UI - I will speak to the team about getting it enabled in the API. I believe that should enable a complete CI/CD workflow as you describe.

sam-goodwin · 2025-10-02T11:58:53Z

I believe that should enable a complete CI/CD workflow as you describe.

That's similar to what we do for D1.

Downside of this approach is cost, I'm assuming? Since it is a total copy?

Mkassabov

haven't looked at the code but read through the docs written here.
Its a good start, but some of the default behavior seems to differ from what we do for alchemy usually.

We'd prefer if we could align here but if there are good reasons for it we're open to discussion

Mkassabov · 2025-10-02T18:31:27Z

alchemy-web/src/content/docs/guides/prisma-postgres.md

+const project = await Project("project", {
+  name: "prisma-app",
+  region: "us-east-1",
+  createDatabase: false,
+});
+
+const database = await Database("database", {
+  project,
+  name: "primary",
+  region: "us-east-1",
+});


is it possible to make the region on database optional and just do project.region?

The way the region selection works is this:

projects do not have a concept of region

when you create a project and specify createDatabase: true, then you need to specify the region. You will then get a database in that region

When you create a database in a project, you need to specify the region

To simplify things, what we could do in Alchemy is hide the ability to automatically create a database with the project. That would eliminate the region and createDatabase flags from Project creation.

To simplify things, what we could do in Alchemy is hide the ability to automatically create a database with the project. That would eliminate the region and createDatabase flags from Project creation.

This seems like the right approach. Centralize database config on the Database resource rather than conflate them.

alchemy-web/src/content/docs/guides/prisma-postgres.md

Mkassabov · 2025-10-02T18:37:02Z

alchemy-web/src/content/docs/providers/prisma-postgres/database-connection.md

+## Rotate If Missing
+
+If the underlying connection is deleted, rerunning the resource automatically creates a replacement with a fresh secret:
+
+```ts
+await DatabaseConnection("application", {
+  database,
+  name: "application",
+});
+```


I feel like this would work better as a tip on the create a connection section since you're explaining how the resource works not showing any unique configuration.

CC @JacobMGEvans

Mkassabov · 2025-10-02T18:38:43Z

alchemy-web/src/content/docs/providers/prisma-postgres/database.md

+import { Database } from "alchemy/prisma/postgres";
+
+const database = await Database("primary", {
+  project,


where does project come from. its a bit ambiguous what project is here. Can we give an example with the simplest possible project?

Good catch - thank you!

I noticed that Planetscale refers to orgs and databases by id instead of objects. Is that the preferred approach?

const devBranch = await Branch("feature-123", { name: "feature-123", organizationId: "my-org", databaseName: "my-database", parentBranch: "main", isProduction: false, });

I noticed that Planetscale refers to orgs and databases by id instead of objects. Is that the preferred approach?

No, but great question.

The preferred approach is to drop the Id suffix and use a union type. For example: organization: string | Organization.

The planetscale should be:

const devBranch = await Branch("feature-123", { name: "feature-123", organization: "my-org" | MyOrg, database: "my-database" | MyDatabase, parentBranch: "main", isProduction: false, });

@Mkassabov we should make these changes in a separate PR.

@sorenbs
better example is our new clickhouse provider:

alchemy/alchemy/src/clickhouse/service.ts

Lines 390 to 395 in 80ef082

const organizationId =

typeof props.organization === "string"

? await OrganizationRef(props.organization)

.then((organization) => organization.id!)

.catch(() => props.organization as string)

: props.organization.id!;

Mkassabov · 2025-10-02T18:39:01Z

alchemy-web/src/content/docs/providers/prisma-postgres/database-connection.md

+const connection = await DatabaseConnection("application", {
+  database,
+  name: "application",
+});


where does database come from. its a bit ambiguous what project is here. Can we give an example with the simplest possible database?

Mkassabov · 2025-10-02T18:39:46Z

alchemy-web/src/content/docs/providers/prisma-postgres/database.md

+const database = await Database("isolated", {
+  project,
+  name: "isolated",
+  region: "eu-central-1",
+  adopt: false,
+});


we generally have adopt: false and you have to specify it manually or run with the --adopt flag. can we keep that behavior consistent with the rest of alchemy here.

Yes. I was unsure what to do, so thanks for calling it out.

Inside a resource you need to check props.adopt ?? this.scope.adopt.

this.scope.adopt is how we apply blanket adopt across an app or scope.

Mkassabov · 2025-10-02T18:46:07Z

alchemy-web/src/content/docs/providers/prisma-postgres/database.md

+
+## Promote to Default Database
+
+Set `isDefault` to true to promote the database when the workspace allows it:


this makes me hesitant since it could be isDefault on multiple databases but only one of them promotes. It dilutes alchemy as being the sense of truth.

could we do something like canPromoteToDefault or at least an output property to show if something is the default?

Mkassabov · 2025-10-02T20:18:19Z

alchemy-web/src/content/docs/providers/prisma-postgres/project.md

+  name: "fresh-project",
+  region: "eu-central-1",
+  createDatabase: false,
+  adopt: false,


adopt should be false by default

sorenbs · 2025-10-04T05:23:50Z

I believe that should enable a complete CI/CD workflow as you describe.

That's similar to what we do for D1.

Downside of this approach is cost, I'm assuming? Since it is a total copy?

Yes, storage costs double. In you experience, is it a common use case to create a branch with the full production data? We haven't heard much request for this.

sam-goodwin · 2025-10-04T05:29:38Z

Yes, storage costs double. In you experience, is it a common use case to create a branch with the full production data? We haven't heard much request for this.

I don't see many people branch Prod, especially for a PR. But what we do care about is the cost per PR in terms of $$$ or quota consumption.

Prisma's free plan only allows 5 databases, which can be hit quite easily. So while a DB might be low $$$ cost when it contains less data, a PR still has a high, fixed "quota" cost.

sorenbs · 2025-10-04T05:34:33Z

I don't see many people branch Prod, especially for a PR.

👍

Prisma's free plan only allows 5 databases, which can be hit quite easily. So while a DB might be low $$$ cost when it contains less data, a PR still has a high, fixed "quota" cost.

We are currently fixing this by 10x-ing the db limits. So Free will give you 50 databases, and the $10 plan will include 100 dbs. As soon as a PR is closed, the database can be deleted and freed up for the next PR.

sam-goodwin · 2025-10-04T05:36:20Z

We are currently fixing this by 10x-ing the db limits. So Free will give you 50 databases, and the $10 plan will include 100 dbs. As soon as a PR is closed, the database can be deleted and freed up for the next PR.

Nice, sounds good. 100 databases is high enough to not worry about it.

sam-goodwin · 2025-10-07T03:01:29Z

examples/prisma-postgres/alchemy.run.ts

+export const connection = await DatabaseConnection("connection", {
+  database,
+  name: "application",
+});


Should we also use hyperdrive ?

Hyperdrive and bind to a Worker would be killer demo

sorenbs added 3 commits October 2, 2025 15:44

feat(prisma-postgres): add provider, docs, tests, example

c318361

docs(example): document alchemy password and default

63c6d7f

feat(prisma-postgres): allow region to be optional

750e9b9

sam-goodwin reviewed Oct 2, 2025

View reviewed changes

sam-goodwin changed the title ~~Add prisma postgres~~ feat(prisma): prisma postgres Oct 2, 2025

sam-goodwin changed the title ~~feat(prisma): prisma postgres~~ feat(prisma): prisma postgres resources Oct 2, 2025

Mkassabov reviewed Oct 2, 2025

View reviewed changes

sam-goodwin reviewed Oct 7, 2025

View reviewed changes

	const organizationId =
	typeof props.organization === "string"
	? await OrganizationRef(props.organization)
	.then((organization) => organization.id!)
	.catch(() => props.organization as string)
	: props.organization.id!;


		## Promote to Default Database

		Set `isDefault` to true to promote the database when the workspace allows it:

feat(prisma): prisma postgres resources #1053

Are you sure you want to change the base?

feat(prisma): prisma postgres resources #1053

Uh oh!

Conversation

sorenbs commented Oct 2, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

pkg-pr-new bot commented Oct 2, 2025

Uh oh!

sam-goodwin commented Oct 2, 2025

Uh oh!

sorenbs commented Oct 2, 2025

Uh oh!

sam-goodwin commented Oct 2, 2025

Uh oh!

Mkassabov left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sorenbs commented Oct 4, 2025

Uh oh!

sam-goodwin commented Oct 4, 2025

Uh oh!

sorenbs commented Oct 4, 2025

Uh oh!

sam-goodwin commented Oct 4, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!