alchemy 0.73.1 → 0.74.0

package/lib/prisma-postgres/project.js

@@ -0,0 +1,62 @@
+import { Resource } from "../resource.js";
+import { createPrismaApi } from "./api.js";
+/**
+ * Creates and manages Prisma Postgres projects.
+ *
+ * Prisma Postgres projects are containers for your databases and
+ * their configurations. Projects belong to a workspace and can
+ * contain multiple databases.
+ *
+ * @example
+ * // Create a database for a project
+ * import { Project, Database } from "alchemy/prisma-postgres";
+ * const project = await Project("my-app");
+ */
+export const Project = Resource("prisma::Project", async function (id, props) {
+    const api = createPrismaApi({
+        serviceToken: props?.serviceToken,
+    });
+    const name = props?.name ?? this.output?.name ?? this.scope.createPhysicalName(id);
+    const shouldDelete = props?.delete ?? false;
+    if (this.phase === "delete") {
+        if (shouldDelete) {
+            await api.deleteProject({
+                path: { id: this.output.id },
+            });
+        }
+        return this.destroy();
+    }
+    if (this.phase === "update") {
+        return this.replace();
+    }
+    const project = await api
+        .createProjectWithPostgresDatabase({
+        body: {
+            createDatabase: false,
+            name,
+            //! prisma seems to not support setting the workspace on project creation?
+        },
+    })
+        .then((response) => response.data.data);
+    return {
+        id: project.id,
+        name: project.name,
+        createdAt: project.createdAt,
+        workspace: project.workspace,
+    };
+});
+export async function findProjectByName(props) {
+    const api = createPrismaApi(props);
+    let hasMore = true;
+    let project;
+    while (hasMore) {
+        const response = await api.listProjects();
+        project = response.data.data.find((project) => project.name === props.name);
+        if (project != null) {
+            break;
+        }
+        hasMore = response.data.pagination.hasMore;
+    }
+    return project;
+}
+//# sourceMappingURL=project.js.map

package/lib/prisma-postgres/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/prisma-postgres/project.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAqD3C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAC7B,iBAAiB,EACjB,KAAK,WAEH,EAAU,EACV,KAAoB;IAEpB,MAAM,GAAG,GAAG,eAAe,CAAC;QAC1B,YAAY,EAAE,KAAK,EAAE,YAAY;KAClC,CAAC,CAAC;IACH,MAAM,IAAI,GACR,KAAK,EAAE,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACxE,MAAM,YAAY,GAAG,KAAK,EAAE,MAAM,IAAI,KAAK,CAAC;IAE5C,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,GAAG,CAAC,aAAa,CAAC;gBACtB,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,GAAG;SACtB,iCAAiC,CAAC;QACjC,IAAI,EAAE;YACJ,cAAc,EAAE,KAAK;YACrB,IAAI;YACJ,0EAA0E;SAC3E;KACF,CAAC;SACD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAK,CAAC,CAAC;IAE3C,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAmB;IACzD,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,OAIS,CAAC;IACd,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,YAAY,EAAE,CAAC;QAC1C,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5E,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,MAAM;QACR,CAAC;QACD,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;IAC7C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/prisma-postgres/workspace.d.ts

@@ -0,0 +1,18 @@
+import { type PrismaApiOptions } from "./api.ts";
+/**
+ * Get a prisma workspace by id or name.
+ *
+ * @example
+ * const workspace = await WorkspaceRef("alchemy-test");
+ *
+ * @param identifier The id or name of the workspace to get.
+ * @param props The api credentials to use.
+ * @returns The workspace.
+ */
+export declare function WorkspaceRef(identifier: string, props?: PrismaApiOptions): Promise<{
+    id: string;
+    type: "workspace";
+    name: string;
+    createdAt: string;
+}>;
+//# sourceMappingURL=workspace.d.ts.map

package/lib/prisma-postgres/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/prisma-postgres/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,gBAAgB;;;;;GAYzB"}

package/lib/prisma-postgres/workspace.js

@@ -0,0 +1,21 @@
+import { createPrismaApi } from "./api.js";
+/**
+ * Get a prisma workspace by id or name.
+ *
+ * @example
+ * const workspace = await WorkspaceRef("alchemy-test");
+ *
+ * @param identifier The id or name of the workspace to get.
+ * @param props The api credentials to use.
+ * @returns The workspace.
+ */
+export async function WorkspaceRef(identifier, props) {
+    const api = createPrismaApi(props);
+    const workspaces = await api.listWorkspaces();
+    const workspace = workspaces.data.data.find((workspace) => workspace.id === identifier || workspace.name === identifier);
+    if (!workspace) {
+        throw new Error(`Workspace with identifier ${identifier} not found`);
+    }
+    return workspace;
+}
+//# sourceMappingURL=workspace.js.map

package/lib/prisma-postgres/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/prisma-postgres/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAyB,MAAM,UAAU,CAAC;AAElE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,KAAwB;IAExB,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAEnC,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,cAAc,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACzC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,KAAK,UAAU,CAC5E,CAAC;IACF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,YAAY,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/util/http.d.ts

@@ -1,6 +1,6 @@
 import http from "node:http";
 import { type Duplex } from "node:stream";
-import { WebSocketServer, type WebSocket } from "ws";
+import { WebSocket, WebSocketServer } from "ws";
 export declare class HTTPServer {
     httpServer: http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
     webSocketServer?: WebSocketServer;
@@ -12,7 +12,10 @@ export declare class HTTPServer {
     get url(): string;
     close(): Promise<void>;
 }
-export declare function coupleWebSocket(wss: WebSocketServer, req: http.IncomingMessage, socket: Duplex, head: Buffer, server: WebSocket): void;
+export declare function createUpgradeHandler(props: {
+    wss: WebSocketServer;
+    createServerWebSocket: (req: http.IncomingMessage) => Promise<WebSocket>;
+}): (req: http.IncomingMessage, socket: Duplex, head: Buffer) => Promise<void>;
 export declare function toWebRequest(req: http.IncomingMessage, host?: string): Request;
 export declare function writeNodeResponse(res: http.ServerResponse, response: Response): Promise<void>;
 //# sourceMappingURL=http.d.ts.map

package/lib/util/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/util/http.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,IAAI,CAAC;AAErD,qBAAa,UAAU;IACrB,UAAU,uEAAuB;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;gBAEtB,OAAO,EAAE;QACnB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QACrD,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;KAChD;IAgBD,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM;IAYpB,IAAI,GAAG,WAON;IAEK,KAAK;CAWZ;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,QASlB;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAeT;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,QAAQ,EAAE,QAAQ,iBAoBnB"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/util/http.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,KAAK,MAAM,EAAY,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAEhD,qBAAa,UAAU;IACrB,UAAU,uEAAuB;IACjC,eAAe,CAAC,EAAE,eAAe,CAAC;gBAEtB,OAAO,EAAE;QACnB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;QACrD,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;KAChD;IAmBD,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM;IAYpB,IAAI,GAAG,WAON;IAEK,KAAK;CAIZ;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,GAAG,EAAE,eAAe,CAAC;IACrB,qBAAqB,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAC1E,IAoDe,KAAK,IAAI,CAAC,eAAe,EAAE,QAAQ,MAAM,EAAE,MAAM,MAAM,mBAQtE;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAeT;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,QAAQ,EAAE,QAAQ,iBAoBnB"}

package/lib/util/http.js

@@ -1,23 +1,24 @@
+import { once } from "node:events";
 import http from "node:http";
 import { Readable } from "node:stream";
-import { WebSocketServer } from "ws";
+import { WebSocket, WebSocketServer } from "ws";
 export class HTTPServer {
     httpServer = http.createServer();
     webSocketServer;
     constructor(options) {
+        const websocket = options.websocket;
+        if (websocket) {
+            const wss = new WebSocketServer({ noServer: true });
+            this.webSocketServer = wss;
+            this.httpServer.on("upgrade", createUpgradeHandler({
+                wss,
+                createServerWebSocket: (req) => websocket(toWebRequest(req)),
+            }));
+        }
         this.httpServer.on("request", async (req, res) => {
             const response = await options.fetch(toWebRequest(req));
             await writeNodeResponse(res, response);
         });
-        const websocket = options.websocket;
-        if (websocket) {
-            const webSocketServer = new WebSocketServer({ noServer: true });
-            this.webSocketServer = webSocketServer;
-            this.httpServer.on("upgrade", async (req, socket, head) => {
-                const ws = await websocket(toWebRequest(req));
-                coupleWebSocket(webSocketServer, req, socket, head, ws);
-            });
-        }
     }
     listen(port) {
         return new Promise((resolve, reject) => {
@@ -39,25 +40,69 @@ export class HTTPServer {
         return `http://${hostname}:${address.port}`;
     }
     async close() {
-        const webSocketServer = this.webSocketServer;
-        if (webSocketServer) {
-            await new Promise((resolve, reject) => {
-                webSocketServer.close((err) => (err ? reject(err) : resolve()));
-            });
+        this.webSocketServer?.close();
+        this.httpServer.close();
+    }
+}
+export function createUpgradeHandler(props) {
+    async function waitForWebSocketOpen(server) {
+        if (server.readyState === WebSocket.CONNECTING) {
+            // Wait for client to be open before accepting worker pair (which would
+            // release buffered messages). Note this will throw if an "error" event is
+            // dispatched (https://github.com/cloudflare/miniflare/issues/229).
+            await once(server, "open");
+        }
+        else if (server.readyState >= WebSocket.CLOSING) {
+            throw new TypeError("Incoming WebSocket connection already closed.");
         }
-        await new Promise((resolve, reject) => {
-            this.httpServer.close((err) => (err ? reject(err) : resolve()));
+    }
+    function forwardWebSocketEvents(from, to) {
+        const ready = waitForWebSocketOpen(to);
+        const ifOpen = (fn) => {
+            // Wait for target to be open before sending message
+            void ready.then(() => {
+                // Silently discard messages received after close:
+                // https://www.rfc-editor.org/rfc/rfc6455#section-1.4
+                if (to.readyState !== WebSocket.OPEN)
+                    return;
+                fn();
+            });
+        };
+        from.on("message", (event, binary) => {
+            ifOpen(() => {
+                to.send(event, { binary });
+            });
+        });
+        from.on("close", (code, reason) => {
+            // Handle close events similar to Miniflare:
+            // https://github.com/cloudflare/workers-sdk/blob/88f081f4e2bd299e715d18bcfe181971f534ff76/packages/miniflare/src/http/websocket.ts#L276-L282
+            ifOpen(() => {
+                if (code === 1005 /* No Status Received */) {
+                    to.close();
+                }
+                else if (code === 1006 /* Abnormal Closure */) {
+                    to.terminate();
+                }
+                else {
+                    to.close(code, reason);
+                }
+            });
+        });
+        from.on("error", (error) => {
+            console.error("Websocket error:", error);
+            ifOpen(() => {
+                to.terminate();
+            });
         });
     }
-}
-export function coupleWebSocket(wss, req, socket, head, server) {
-    wss.handleUpgrade(req, socket, head, (client) => {
-        client.on("message", (event, binary) => server.send(event, { binary }));
-        client.on("close", (code, reason) => server.close(code, reason));
-        server.on("message", (event, binary) => client.send(event, { binary }));
-        server.on("close", (code, reason) => client.close(code, reason));
-        wss.emit("connection", client, req);
-    });
+    return async (req, socket, head) => {
+        const server = await props.createServerWebSocket(req);
+        props.wss.handleUpgrade(req, socket, head, async (client) => {
+            forwardWebSocketEvents(server, client);
+            forwardWebSocketEvents(client, server);
+            props.wss.emit("connection", client, req);
+        });
+    };
 }
 export function toWebRequest(req, host) {
     const method = req.method ?? "GET";

package/lib/util/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/util/http.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/util/http.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "alchemy",
-  "version": "0.73.1",
+  "version": "0.74.0",
   "license": "Apache-2.0",
   "author": "Sam Goodwin <sam@alchemy.run>",
   "homepage": "https://alchemy.run",
@@ -128,6 +128,10 @@
       "bun": "./src/planetscale/index.ts",
       "import": "./lib/planetscale/index.js"
     },
+    "./prisma-postgres": {
+      "bun": "./src/prisma-postgres/index.ts",
+      "import": "./lib/prisma-postgres/index.js"
+    },
     "./random": {
       "bun": "./src/random/index.ts",
       "import": "./lib/random/index.js"
@@ -209,6 +213,7 @@
     "drizzle-orm": "^0.44.2",
     "rwsdk": "^0.1.36",
     "stripe": "^18.5.0",
+    "vite": ">=6.0.0",
     "wrangler": "^4.42.2"
   },
   "peerDependenciesMeta": {
@@ -262,6 +267,9 @@
     },
     "stripe": {
       "optional": true
+    },
+    "vite": {
+      "optional": true
     }
   },
   "devDependencies": {

package/src/cloudflare/bound.ts

@@ -100,4 +100,6 @@ export type Bound<T extends Binding> = T extends _DurableObjectNamespace<
                                                             Obj &
                                                               Rpc.DurableObjectBranded
                                                           >
-                                                        : Service;
+                                                        : T extends undefined
+                                                          ? undefined
+                                                          : Service;

package/src/cloudflare/miniflare/miniflare-worker-proxy.ts

@@ -3,7 +3,7 @@ import { once } from "node:events";
 import http from "node:http";
 import { Readable } from "node:stream";
 import { WebSocket, WebSocketServer } from "ws";
-import { coupleWebSocket } from "../../util/http.ts";
+import { createUpgradeHandler } from "../../util/http.ts";
 
 export interface MiniflareWorkerProxy {
   url: URL;
@@ -20,15 +20,14 @@ export async function createMiniflareWorkerProxy(options: {
   const server = http.createServer();
   const wss = new WebSocketServer({ noServer: true });
 
-  server.on("upgrade", async (req, socket, head) => {
-    try {
-      const server = await createServerWebSocket(req);
-      coupleWebSocket(wss, req, socket, head, server);
-    } catch (error) {
-      console.error(error);
-      socket.destroy();
-    }
-  });
+  server.on(
+    "upgrade",
+    createUpgradeHandler({
+      wss,
+      createServerWebSocket: (req) => createServerWebSocket(req),
+    }),
+  );
+
   server.on("request", async (req, res) => {
     try {
       const response = await handleFetch(req);
@@ -84,13 +83,11 @@ export async function createMiniflareWorkerProxy(options: {
     options.transformRequest?.(info);
     const name = options.getWorkerName(info);
 
-    const server = new WebSocket(url, protocols, {
+    return new WebSocket(url, protocols, {
       headers: {
         "MF-Route-Override": name,
       },
     });
-    await once(server, "open");
-    return server;
   };
 
   server.listen(options.port);

package/src/cloudflare/miniflare/remote-binding-proxy.ts

@@ -61,11 +61,19 @@ export async function createRemoteProxyWorker(input: {
     websocket: async (req) => {
       const input = new URL(req.url);
       const proxied = new URL(input.pathname + input.search, `https://${host}`);
+      const headers: Record<string, string> = {
+        "cf-workers-preview-token": token,
+        host,
+      };
+      // We don't want to include all headers because some can mess with websocket connections.
+      // However, it's important to include `mf-` prefixed headers to configure bindings for miniflare to work.
+      req.headers.forEach((value, key) => {
+        if (key.startsWith("mf-")) {
+          headers[key] = value;
+        }
+      });
       return new WebSocket(proxied, {
-        headers: {
-          "cf-workers-preview-token": token,
-          host,
-        },
+        headers,
       });
     },
     fetch: async (req) => {

package/src/cloudflare/tanstack-start/tanstack-start.ts

@@ -1,3 +1,5 @@
+import path from "node:path";
+import { exists } from "../../util/exists.ts";
 import type { Assets } from "../assets.ts";
 import type { Bindings } from "../bindings.ts";
 import { Vite, type ViteProps } from "../vite/vite.ts";
@@ -14,6 +16,11 @@ export async function TanStackStart<B extends Bindings>(
   id: string,
   props?: Partial<TanStackStartProps<B>>,
 ): Promise<TanStackStart<B>> {
+  const main =
+    props?.wrangler?.main ??
+    ((await exists(path.resolve(props?.cwd ?? process.cwd(), "src/server.ts")))
+      ? "src/server.ts"
+      : undefined);
   return await Vite(id, {
     entrypoint: "dist/server/index.js",
     assets: "dist/client",
@@ -23,9 +30,10 @@ export async function TanStackStart<B extends Bindings>(
     ...props,
     wrangler: {
       ...props?.wrangler,
+      main,
       transform: async (spec) => {
         const transformed = (await props?.wrangler?.transform?.(spec)) ?? spec;
-        if (!props?.wrangler?.main) {
+        if (!main) {
           transformed.main = "@tanstack/react-start/server-entry";
         }
         return transformed;

package/src/cloudflare/vite/plugin.ts

@@ -20,17 +20,31 @@ const alchemy = (config?: PluginConfig): PluginOption => {
   if (typeof persistState === "object" && persistState.path.endsWith("v3")) {
     persistState.path = path.dirname(persistState.path);
   }
-  return cloudflare({
-    ...config,
-    configPath: validateConfigPath(
-      // config path doesn't need to be in the root, it can be in the app dir
-      config?.configPath ?? getDefaultConfigPath(),
-    ),
-    persistState,
-    experimental: config?.experimental ?? {
-      remoteBindings: true,
+  return [
+    cloudflare({
+      ...config,
+      configPath: validateConfigPath(
+        // config path doesn't need to be in the root, it can be in the app dir
+        config?.configPath ?? getDefaultConfigPath(),
+      ),
+      persistState,
+      experimental: config?.experimental ?? {
+        remoteBindings: true,
+      },
+    }),
+    {
+      name: "alchemy-supress-watch",
+      config() {
+        return {
+          server: {
+            watch: {
+              ignored: ["**/.alchemy/**"],
+            },
+          },
+        };
+      },
     },
-  }) as PluginOption;
+  ] as PluginOption;
 };
 
 export default alchemy;

package/src/planetscale/branch.ts

@@ -43,6 +43,13 @@ export interface BranchProps extends PlanetScaleProps {
    */
   adopt?: boolean;
 
+  /**
+   * Whether to delete the branch when the resource is destroyed.
+   * When false, the branch will only be removed from the state but not deleted via API.
+   * @default true
+   */
+  delete?: boolean;
+
   /**
    * The parent branch name or Branch object
    * @default "main"
@@ -179,6 +186,7 @@ export const Branch = Resource(
       (typeof props.database === "string"
         ? props.database
         : props.database.name);
+    const shouldDelete = props.delete ?? false;
 
     if (!organization) {
       throw new Error(
@@ -192,7 +200,7 @@ export const Branch = Resource(
     }
 
     if (this.phase === "delete") {
-      if (this.output?.name) {
+      if (shouldDelete && this.output?.name) {
         const response = await api.deleteBranch({
           path: {
             organization,

package/src/planetscale/database.ts

@@ -28,6 +28,13 @@ interface BaseDatabaseProps extends PlanetScaleProps {
    */
   adopt?: boolean;
 
+  /**
+   * Whether to delete the database when the resource is destroyed.
+   * When false, the database will only be removed from the state but not deleted via API.
+   * @default true
+   */
+  delete?: boolean;
+
   /**
    * The region where the database will be created (create only)
    */
@@ -227,6 +234,7 @@ export const Database = Resource(
         "PlanetScale organization is required. Please set the `organization` property or the `PLANETSCALE_ORGANIZATION` environment variable.",
       );
     }
+    const shouldDelete = props.delete ?? false;
 
     if (this.phase === "update" && this.output.name !== databaseName) {
       await api.updateDatabaseSettings({
@@ -239,7 +247,7 @@ export const Database = Resource(
     }
 
     if (this.phase === "delete") {
-      if (this.output?.name) {
+      if (shouldDelete && this.output?.name) {
         const response = await api.deleteDatabase({
           path: {
             organization,

package/src/planetscale/password.ts

@@ -58,6 +58,13 @@ export interface PasswordProps extends PlanetScaleProps {
    * The CIDRs of the password
    */
   cidrs?: string[];
+
+  /**
+   * Whether to delete the password when the resource is destroyed.
+   * When false, the password will only be removed from the state but not deleted via API.
+   * @default true
+   */
+  delete?: boolean;
 }
 
 /**
@@ -293,6 +300,7 @@ export const Password = Resource(
       typeof props.branch === "string"
         ? props.branch
         : (props.branch?.name ?? "main");
+    const shouldDelete = props.delete ?? false;
     if (!organization) {
       throw new Error(
         "PlanetScale organization is required. Please set the `organization` property or the `PLANETSCALE_ORGANIZATION` environment variable.",
@@ -300,7 +308,7 @@ export const Password = Resource(
     }
 
     if (this.phase === "delete") {
-      if (this.output?.id) {
+      if (shouldDelete && this.output?.id) {
         const res = await api.deletePassword({
           path: {
             organization,

package/src/planetscale/role.ts

@@ -44,6 +44,13 @@ export interface RoleProps extends PlanetScaleProps {
    * You can also inherit from another Role resource.
    */
   inheritedRoles: InheritedRole[] | Role;
+
+  /**
+   * Whether to delete the role when the resource is destroyed.
+   * When false, the role will only be removed from the state but not deleted via API.
+   * @default true
+   */
+  delete?: boolean;
 }
 
 /**
@@ -189,10 +196,11 @@ export const Role = Resource(
     const inheritedRoles = Array.isArray(props.inheritedRoles)
       ? props.inheritedRoles
       : props.inheritedRoles.inheritedRoles;
+    const shouldDelete = props.delete ?? false;
 
     switch (this.phase) {
       case "delete": {
-        if (this.output?.id) {
+        if (shouldDelete && this.output?.id) {
           const res = await api.deleteRole({
             path: {
               organization,

package/src/prisma-postgres/api/client.gen.ts

@@ -0,0 +1,27 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+import {
+  type ClientOptions,
+  type Config,
+  createClient,
+  createConfig,
+} from "../../util/api/client/index.ts";
+import type { ClientOptions as ClientOptions2 } from "./types.gen.ts";
+
+/**
+ * The `createClientConfig()` function will be called on client initialization
+ * and the returned object will become the client's initial configuration.
+ *
+ * You may want to initialize your client this way instead of calling
+ * `setConfig()`. This is useful for example if you're using Next.js
+ * to ensure your client always has the correct values.
+ */
+export type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (
+  override?: Config<ClientOptions & T>,
+) => Config<Required<ClientOptions> & T>;
+
+export const client = createClient(
+  createConfig<ClientOptions2>({
+    throwOnError: true,
+  }),
+);