@prisma/dev 0.21.0 → 0.22.1

package/dist/index.d.ts

@@ -1,10 +1,55 @@
-import { P as ProgrammaticServer } from './programmatic-QofJRfwC.js';
-import { ServerOptions } from './state.js';
+import { Exports, ServerOptions } from './state.js';
 export { ServerAlreadyRunningError } from './state.js';
-import { DBServerPurpose } from './db.js';
+import { WalEvent, DBServerPurpose } from './db.js';
 import 'valibot';
 import '@electric-sql/pglite';
 
+/**
+ * A readonly batch of WAL events emitted together.
+ *
+ * @experimental This API may change without notice.
+ */
+type ExperimentalWalEventBatch = readonly WalEvent[];
+/**
+ * Callback invoked when a batch of WAL events is available.
+ *
+ * @experimental This API may change without notice.
+ */
+type ExperimentalWalEventCallback = (events: ExperimentalWalEventBatch) => void;
+/**
+ * The experimental public WAL event API returned from `startPrismaDevServer()`.
+ *
+ * @experimental This API may change without notice.
+ */
+interface ExperimentalWalEvents {
+    /**
+     * Subscribe to WAL event batches. The returned function unsubscribes the callback.
+     */
+    subscribe(callback: ExperimentalWalEventCallback): () => void;
+    /**
+     * Create an async iterator that yields WAL event batches as they arrive.
+     */
+    stream(): AsyncIterableIterator<ExperimentalWalEventBatch>;
+}
+/**
+ * Experimental capabilities exposed on the public programmatic server.
+ *
+ * @experimental This API may change without notice.
+ */
+interface ExperimentalServerFeatures {
+    readonly wal: ExperimentalWalEvents;
+}
+interface ProgrammaticServer extends Exports {
+    close(): Promise<void>;
+    /**
+     * Experimental capabilities that may change without notice.
+     *
+     * @experimental
+     */
+    experimental: ExperimentalServerFeatures;
+    name: string;
+}
+
 declare const DEFAULT_DATABASE_PORT = 51214;
 declare const DEFAULT_SERVER_PORT = 51213;
 declare const DEFAULT_SHADOW_DATABASE_PORT = 51215;
@@ -20,6 +65,9 @@ type ReadonlyServer = Omit<ProgrammaticServer, "close">;
  * Starts a `prisma dev` server instance programmatically.
  *
  * DO NOT USE IN PRODUCTION. This is only intended for development and testing purposes.
+ *
+ * The returned server also includes experimental capabilities under `server.experimental`,
+ * including WAL event subscriptions at `server.experimental.wal`.
  */
 declare function startPrismaDevServer(options?: ServerOptions): Promise<ProgrammaticServer>;
 /**
@@ -27,4 +75,4 @@ declare function startPrismaDevServer(options?: ServerOptions): Promise<Programm
  */
 declare function unstable_startServer(options?: ServerOptions): Promise<ProgrammaticServer>;
 
-export { DEFAULT_DATABASE_PORT, DEFAULT_SERVER_PORT, DEFAULT_SHADOW_DATABASE_PORT, type PortAssignableService, PortNotAvailableError, type ReadonlyServer, ProgrammaticServer as Server, ServerOptions, startPrismaDevServer, unstable_startServer };
+export { DEFAULT_DATABASE_PORT, DEFAULT_SERVER_PORT, DEFAULT_SHADOW_DATABASE_PORT, type ExperimentalServerFeatures, WalEvent as ExperimentalWalEvent, type ExperimentalWalEventBatch, type ExperimentalWalEvents, type PortAssignableService, PortNotAvailableError, type ReadonlyServer, type ProgrammaticServer as Server, ServerOptions, startPrismaDevServer, unstable_startServer };

package/dist/index.js

@@ -1 +1 @@
-import{a as f,b as g}from"./chunk-VXHP3HPZ.js";import"./chunk-DZGCLGSX.js";import{g as e}from"./chunk-FIY24ARL.js";import{a,b,c,g as d}from"./chunk-OTI5SWIV.js";import"./chunk-6ORCLJD5.js";import"./chunk-DGKV2DPF.js";export{a as DEFAULT_DATABASE_PORT,b as DEFAULT_SERVER_PORT,c as DEFAULT_SHADOW_DATABASE_PORT,d as PortNotAvailableError,e as ServerAlreadyRunningError,f as startPrismaDevServer,g as unstable_startServer};
+import{a as f,b as g}from"./chunk-E7DPFNXK.js";import"./chunk-YYOOMJ67.js";import{g as e}from"./chunk-FIY24ARL.js";import{a,b,c,g as d}from"./chunk-OTI5SWIV.js";import"./chunk-6ORCLJD5.js";import"./chunk-DGKV2DPF.js";export{a as DEFAULT_DATABASE_PORT,b as DEFAULT_SERVER_PORT,c as DEFAULT_SHADOW_DATABASE_PORT,d as PortNotAvailableError,e as ServerAlreadyRunningError,f as startPrismaDevServer,g as unstable_startServer};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma/dev",
-  "version": "0.21.0",
+  "version": "0.22.1",
   "description": "A local Prisma Postgres server for development and testing",
   "type": "module",
   "author": "Igal Klebanov <igalklebanov@gmail.com> (https://github.com/igalklebanov)",
@@ -77,16 +77,16 @@
     "common-stuff": "^0.0.0"
   },
   "dependencies": {
-    "@electric-sql/pglite": "0.3.16",
-    "@electric-sql/pglite-socket": "0.0.22",
-    "@electric-sql/pglite-tools": "0.2.21",
-    "@hono/node-server": "1.19.9",
-    "@mrleebo/prisma-ast": "0.13.1",
+    "@electric-sql/pglite": "0.4.0",
+    "@electric-sql/pglite-socket": "0.1.0",
+    "@electric-sql/pglite-tools": "0.3.0",
+    "@hono/node-server": "1.19.11",
+    "@mrleebo/prisma-ast": "0.15.0",
     "@prisma/get-platform": "7.2.0",
     "@prisma/query-plan-executor": "7.2.0",
     "foreground-child": "3.3.1",
     "get-port-please": "3.2.0",
-    "hono": "4.11.4",
+    "hono": "^4.12.8",
     "http-status-codes": "2.3.0",
     "pathe": "2.0.3",
     "proper-lockfile": "4.1.2",

package/dist/chunk-DZGCLGSX.js

@@ -1,84 +0,0 @@
-import{g as w}from"./chunk-OTI5SWIV.js";import{e as b}from"./chunk-DGKV2DPF.js";import{filename as k}from"pathe/utils";import{protocol as G}from"@electric-sql/pglite";var m="_prisma_dev_wal",p="events",_="install_all_triggers",f="capture_event",N="prisma_dev_wal_capture",E=new WeakMap,W=new Set(["ALTER","COMMIT","COPY","CREATE","DELETE","DROP","INSERT","MERGE","TRUNCATE","UPDATE"]);async function g(e,t){let o=E.get(e);if(o&&!o.closed)return o.bridge;let n=e.execProtocolRaw.bind(e),r={bridge:{close:async()=>{r.closed||(r.closed=!0,r.subscribers.clear(),e.execProtocolRaw===s&&(e.execProtocolRaw=n),await r.pollPromise,E.delete(e))},poll:async()=>{await S(r,e)},subscribe:d=>(r.subscribers.add(d),()=>{r.subscribers.delete(d)})},closed:!1,ensureInfrastructurePromise:null,pendingPoll:!1,pollPromise:null,subscribers:new Set,suppressDepth:0},s=async(d,l)=>{let i=await n(d,l);return!r.closed&&r.suppressDepth===0&&L(i)&&S(r,e),i};return e.execProtocolRaw=s,E.set(e,r),await D(r,e),r.bridge}async function R(e){let t=E.get(e);t&&await t.bridge.close()}function A(e){for(let t of e){if(t.name!=="commandComplete"||typeof t.text!="string")continue;let o=t.text.split(/\s+/,1)[0]?.toUpperCase();if(o&&W.has(o))return!0}return!1}function L(e){if(e.length===0)return!1;let t=[];return new G.Parser().parse(e,n=>{t.push(n)}),A(t)}async function D(e,t){e.ensureInfrastructurePromise??=T(e,t,async()=>{await t.exec(`CREATE SCHEMA IF NOT EXISTS "${m}"`),await t.exec(`
-      CREATE TABLE IF NOT EXISTS "${m}"."${p}" (
-        id BIGSERIAL PRIMARY KEY,
-        txid BIGINT NOT NULL DEFAULT txid_current(),
-        schema_name TEXT NOT NULL,
-        table_name TEXT NOT NULL,
-        op TEXT NOT NULL,
-        row_data JSONB,
-        old_row_data JSONB,
-        created_at TIMESTAMPTZ NOT NULL DEFAULT clock_timestamp()
-      )
-    `),await t.exec(`
-      CREATE OR REPLACE FUNCTION "${m}"."${f}"()
-      RETURNS trigger
-      LANGUAGE plpgsql
-      AS $$
-      BEGIN
-        IF TG_TABLE_SCHEMA = '${m}' THEN
-          RETURN COALESCE(NEW, OLD);
-        END IF;
-
-        INSERT INTO "${m}"."${p}" (
-          txid,
-          schema_name,
-          table_name,
-          op,
-          row_data,
-          old_row_data
-        )
-        VALUES (
-          txid_current(),
-          TG_TABLE_SCHEMA,
-          TG_TABLE_NAME,
-          lower(TG_OP),
-          CASE WHEN TG_OP IN ('INSERT', 'UPDATE') THEN to_jsonb(NEW) ELSE NULL END,
-          CASE WHEN TG_OP IN ('UPDATE', 'DELETE') THEN to_jsonb(OLD) ELSE NULL END
-        );
-
-        RETURN COALESCE(NEW, OLD);
-      END;
-      $$;
-    `),await t.exec(`
-      CREATE OR REPLACE FUNCTION "${m}"."${_}"()
-      RETURNS void
-      LANGUAGE plpgsql
-      AS $$
-      DECLARE
-        target REGCLASS;
-      BEGIN
-        FOR target IN
-          SELECT c.oid::regclass
-          FROM pg_class AS c
-          JOIN pg_namespace AS n ON n.oid = c.relnamespace
-          WHERE c.relkind IN ('r', 'p')
-            AND n.nspname NOT IN ('${m}', 'information_schema', 'pg_catalog')
-            AND n.nspname NOT LIKE 'pg_temp_%'
-            AND n.nspname NOT LIKE 'pg_toast%'
-        LOOP
-          IF EXISTS (
-            SELECT 1
-            FROM pg_trigger
-            WHERE tgrelid = target
-              AND tgname = '${N}'
-          ) THEN
-            CONTINUE;
-          END IF;
-
-          EXECUTE format(
-            'CREATE TRIGGER %I AFTER INSERT OR UPDATE OR DELETE ON %s FOR EACH ROW EXECUTE FUNCTION "${m}"."${f}"()',
-            '${N}',
-            target::text
-          );
-        END LOOP;
-      END;
-      $$;
-    `),await v(e,t)}),await e.ensureInfrastructurePromise}async function v(e,t){await T(e,t,async()=>{await t.query(`SELECT "${m}"."${_}"()`)})}async function U(e,t){await D(e,t),await v(e,t);let o=await T(e,t,async()=>await t.query(`
-      WITH drained AS (
-        DELETE FROM "${m}"."${p}"
-        RETURNING txid, schema_name, table_name, op, row_data, old_row_data, id
-      )
-      SELECT txid, schema_name, table_name, op, row_data, old_row_data
-      FROM drained
-      ORDER BY id
-    `));if(o.rows.length===0||e.subscribers.size===0)return;let n=o.rows.map(M);for(let r of e.subscribers)queueMicrotask(()=>{if(!e.closed&&e.subscribers.has(r))try{r(n)}catch(s){console.error("[WAL bridge] subscriber failed",s)}})}async function S(e,t){if(!e.closed){if(e.pollPromise){e.pendingPoll=!0,await e.pollPromise;return}e.pollPromise=(async()=>{do e.pendingPoll=!1,await U(e,t);while(e.pendingPoll&&!e.closed)})().finally(()=>{e.pollPromise=null}),await e.pollPromise}}async function T(e,t,o){e.suppressDepth+=1;try{return await o()}finally{e.suppressDepth-=1,e.suppressDepth===0&&!e.closed&&E.get(t)!==e&&(e.closed=!0)}}function M(e){return{oldRecord:e.old_row_data,record:e.row_data,schema:e.schema_name,table:e.table_name,txid:String(e.txid),type:F(e.op)}}function F(e){switch(e.toLowerCase()){case"delete":return"delete";case"insert":return"insert";case"update":return"update";default:throw new Error(`Unsupported WAL bridge operation: ${e}`)}}var H=10,a={connectionLimit:H,connectTimeout:0,database:"template1",maxIdleConnectionLifetime:0,password:"postgres",poolTimeout:0,socketTimeout:0,sslMode:"disable",username:"postgres"},q=`postgres://${a.username}:${a.password}@localhost`,h=new URLSearchParams({sslmode:a.sslMode}),X=new URLSearchParams({...Object.fromEntries(h.entries()),connection_limit:String(a.connectionLimit),connect_timeout:String(a.connectTimeout),max_idle_connection_lifetime:String(a.maxIdleConnectionLifetime),pool_timeout:String(a.poolTimeout),socket_timeout:String(a.socketTimeout)});async function te(e,t){let o=e==="database"?t.databasePort:t.shadowDatabasePort;if(t.dryRun)return y(e,t,{db:null,port:o,server:null});let{debug:n}=t,s=await(e==="shadow_database"?Y:O)(t.pgliteDataDirPath,n);n&&s.onNotification((c,u)=>{console.debug(`[${e}][${c}] ${u}`)});let{PGLiteSocketServer:d}=await import("@electric-sql/pglite-socket"),l=e==="shadow_database"?t.shadowDatabaseIdleTimeoutMillis:t.databaseIdleTimeoutMillis,i=new d({db:s,debug:n,idleTimeout:Number.isFinite(l)?l:0,inspect:n,maxConnections:a.connectionLimit,port:o});n&&(i.addEventListener("listening",c=>{let{detail:u}=c;console.debug(`[${e}] server listening on ${JSON.stringify(u)}`)}),i.addEventListener("connection",c=>{let{clientAddress:u,clientPort:$}=c.detail;console.debug(`[${e}] client connected from ${u}:${$}`)}),i.addEventListener("error",c=>{let{detail:u}=c;console.error(`[${e}] server error:`,u)}));try{await i.start()}catch(c){throw c instanceof Error&&"code"in c&&c.code==="EADDRINUSE"?new w(o):c}let P=Number(i.getServerConn().split(":").at(1));return t[e==="database"?"databasePort":"shadowDatabasePort"]=P,y(e,t,{db:s,port:P,server:i})}function y(e,t,o){let{debug:n}=t,{db:r,port:s,server:d}=o||{};return n&&console.debug(`[${e}] server started on port ${s}`),{...a,attachWalEventBridge:async()=>{if(e!=="database"||!r)throw new Error("WAL bridge is only available for the primary database server");return await g(r)},close:async()=>{let l=[];try{await d?.stop(),n&&console.debug(`[${e}] server stopped on port ${s}`)}catch(i){console.error(`[${e}] server stop error`,i),l.push(i)}if(e==="database"){try{r&&await R(r),n&&console.debug(`[${e}] closed WAL bridge`)}catch(i){console.error(`[${e}] WAL bridge close error`,i),l.push(i)}try{await r?.syncToFs(),n&&console.debug(`[${e}] synced to filesystem`)}catch(i){console.error(`[${e}] sync error`,i),l.push(i)}}try{await r?.close(),n&&console.debug(`[${e}] closed`)}catch(i){console.error(`[${e}] close error`,i),l.push(i)}if(l.length>0)throw new AggregateError(l,`Failed to close ${e} properly`)},connectionString:I(s,h),dump:async l=>{e==="shadow_database"||!r||await Q({db:r,debug:n,destinationPath:l})},port:s,prismaORMConnectionString:I(s,X),terminalCommand:`PGPASSWORD=${a.password} PGSSLMODE=${a.sslMode} psql -h localhost -p ${s} -U ${a.username} -d ${a.database}`}}function I(e,t){return`${q}:${e}/${a.database}?${t.toString()}`}async function O(e,t){let{PGlite:o}=await import("@electric-sql/pglite");return await o.create({database:a.database,dataDir:e,debug:t?5:void 0,extensions:await B(),relaxedDurability:!1,username:a.username})}async function Y(e,t){let{PGlite:o}=await import("@electric-sql/pglite");return await o.create({database:a.database,dataDir:"memory://",debug:t?5:void 0,extensions:await B(),relaxedDurability:!1,username:a.username})}async function B(){let e=await Promise.all([import("@electric-sql/pglite/contrib/amcheck"),import("@electric-sql/pglite/contrib/bloom"),import("@electric-sql/pglite/contrib/btree_gin"),import("@electric-sql/pglite/contrib/btree_gist"),import("@electric-sql/pglite/contrib/citext"),import("@electric-sql/pglite/contrib/cube"),import("@electric-sql/pglite/contrib/dict_int"),import("@electric-sql/pglite/contrib/dict_xsyn"),import("@electric-sql/pglite/contrib/earthdistance"),import("@electric-sql/pglite/contrib/file_fdw"),import("@electric-sql/pglite/contrib/fuzzystrmatch"),import("@electric-sql/pglite/contrib/hstore"),import("@electric-sql/pglite/contrib/intarray"),import("@electric-sql/pglite/contrib/isn"),import("@electric-sql/pglite/contrib/lo"),import("@electric-sql/pglite/contrib/ltree"),import("@electric-sql/pglite/contrib/pageinspect"),import("@electric-sql/pglite/contrib/pg_buffercache"),import("@electric-sql/pglite/contrib/pg_freespacemap"),import("@electric-sql/pglite/contrib/pg_surgery"),import("@electric-sql/pglite/contrib/pg_trgm"),import("@electric-sql/pglite/contrib/pg_visibility"),import("@electric-sql/pglite/contrib/pg_walinspect"),import("@electric-sql/pglite/contrib/seg"),import("@electric-sql/pglite/contrib/tablefunc"),import("@electric-sql/pglite/contrib/tcn"),import("@electric-sql/pglite/contrib/tsm_system_rows"),import("@electric-sql/pglite/contrib/tsm_system_time"),import("@electric-sql/pglite/contrib/unaccent"),import("@electric-sql/pglite/contrib/uuid_ossp"),import("@electric-sql/pglite/vector")]);return Object.assign({},...e)}async function Q(e){let{dataDir:t,db:o,debug:n,destinationPath:r}=e,s=o||await O(t,n),{pgDump:d}=await import("@electric-sql/pglite-tools/pg_dump"),l=await d({args:["--schema-only","--no-owner"],fileName:r?k(r):void 0,pg:await s.clone()});return r?(n&&console.debug(`[DB] Dumping database to ${r}`),await b(l,r)):(n&&console.debug("[DB] Dumping database to memory"),await l.text())}export{g as a,A as b,L as c,te as d,Q as e};

package/dist/chunk-VXHP3HPZ.js

@@ -1 +0,0 @@
-import{d as S}from"./chunk-DZGCLGSX.js";import{a as P}from"./chunk-FIY24ARL.js";import{g as p}from"./chunk-OTI5SWIV.js";import{a as v,c as u,d}from"./chunk-6ORCLJD5.js";import{createServer as D}from"http";import{promisify as A}from"util";import E from"@prisma/get-platform";async function w(t,r){let{port:e}=r;if(r.dryRun)return f(e,null);let o=await R(t,r),{promise:a,reject:l,resolve:s}=u(),{serve:c}=await import("@hono/node-server"),m=c({createServer:D,fetch:o.fetch,overrideGlobalObjects:!1,port:e},s);m.on("error",i=>{if(typeof i=="object"&&"code"in i&&i.code==="EADDRINUSE")return l(new p(e));console.error("[Accelerate]",i)});let{port:n}=await a;return r.port=n,f(n,m)}function f(t,r){return{async close(){r&&await Promise.allSettled([A(r.close.bind(r))(),d.stopAll()])},port:t,url:`http://localhost:${t}`}}async function R(t,r){let{debug:e}=r,[{Hono:o},{accelerateRoute:a},{utilityRoute:l}]=await Promise.all([import("hono/tiny"),import("./accelerate-HABH6RJU.js"),import("./utility-Q5A254LJ.js")]),s=new o,c=await E.getPlatformInfo();if(e&&console.debug("[Accelerate] platform info: %s",JSON.stringify(c)),e){let{logger:n}=await import("hono/logger");s.use("*",n((...i)=>console.log("[Accelerate]",...i)))}s.use("*",async(n,i)=>(n.set("databaseDumpPath",r.databaseDumpPath),n.set("db",t),n.set("debug",!!e),n.set("name",r.name),n.set("platform",c),n.set("shadowDBPort",r.shadowDatabasePort),await i()));let m=new o;return m.route("/",a),m.route("/",l),s.route("/",m),s}async function h(t){let r=await P.createExclusively(t),e=null,o=null,a=null;try{[e,a]=await Promise.all([S("database",r),S("shadow_database",r)]);let l=await e.attachWalEventBridge();o=await w(e,r);let s=b(e,a,o,r);await r.writeServerDump(s);let c=e,m=a,n=o,i=async()=>await T(r,[n,c,m]);return{close:i,dbServer:e,httpServer:o,server:{...s,close:i,name:r.name},serverState:r,shadowDbServer:a,walBridge:l}}catch(l){return await B(r,[o,e,a],l)}}function b(t,r,e,o){let a=`prisma+postgres://localhost:${e.port}/?${new URLSearchParams({api_key:v({databaseUrl:t.prismaORMConnectionString,name:o.name,shadowDatabaseUrl:r.prismaORMConnectionString})}).toString()}`;return{database:{connectionString:t.connectionString,prismaORMConnectionString:t.prismaORMConnectionString,terminalCommand:t.terminalCommand},http:{url:e.url},ppg:{url:a},shadowDatabase:{connectionString:r.prismaORMConnectionString,prismaORMConnectionString:r.prismaORMConnectionString,terminalCommand:r.terminalCommand}}}async function T(t,r){let o=(await Promise.allSettled(r.map(a=>a.close()))).filter(a=>a.status==="rejected").map(a=>new Error(a.reason));try{await t.close()}catch(a){o.push(a)}if(o.length>0)throw new AggregateError(o,"Failed to close some servers")}async function B(t,r,e){try{await T(t,r.filter(o=>o!==null))}catch(o){throw new AggregateError([e,o],"Failed to start Prisma Dev server cleanly")}throw e}async function O(t){let{server:r}=await h(t);return r}async function z(t){return await O(t)}export{O as a,z as b};

package/dist/programmatic-CRY-l5_J.d.cts

@@ -1,8 +0,0 @@
-import { Exports } from './state.cjs';
-
-interface ProgrammaticServer extends Exports {
-    close(): Promise<void>;
-    name: string;
-}
-
-export type { ProgrammaticServer as P };

package/dist/programmatic-QofJRfwC.d.ts

@@ -1,8 +0,0 @@
-import { Exports } from './state.js';
-
-interface ProgrammaticServer extends Exports {
-    close(): Promise<void>;
-    name: string;
-}
-
-export type { ProgrammaticServer as P };