@trylight/app 0.1.2 → 0.1.3

package/README.md

@@ -46,6 +46,11 @@ sign-in; a stranger to a public app only reads what members kept.
 
 ## Schema sync
 
+`light-db sync` and `migrate` connect with `DATABASE_URL_UNPOOLED`, the
+database's direct address, and refuse to run without it: they serialise on
+Postgres advisory locks, which a transaction pooler (the app's `DATABASE_URL`
+on Neon) keeps on a pooled connection after the process exits.
+
 `plan()` diffs `db/schema` against the newest migration snapshot with
 drizzle-kit's API, removals first and additions second, so drizzle-kit never
 has to ask whether a column was renamed (it can't without a terminal).

package/dist/db/cli.js

@@ -24,7 +24,9 @@ const SYNC_LOCK_KEY = 4_815_162_343;
 /** Exit code of a migrate whose migrations committed but whose change triggers didn't go on. */
 const APPLIED_UNTRACKED = 2;
 // pg_advisory_lock waits for the one before it; a process that dies releases it.
-const connect = (onnotice = () => undefined) => postgres(databaseUrl(), { max: 1, onnotice });
+// Only on a direct connection: behind a transaction pooler the lock stays on a
+// pooled server connection after the process exits, and every later sync waits.
+const connect = (onnotice = () => undefined) => postgres(unpooledDatabaseUrl(), { max: 1, onnotice });
 const root = process.cwd();
 const envFile = join(root, ".env.local");
 if (existsSync(envFile))
@@ -33,11 +35,12 @@ const [command] = process.argv.slice(2);
 async function loadSchema() {
     return import(pathToFileURL(join(root, SCHEMA_ENTRY)).href);
 }
-function databaseUrl() {
-    const { databaseUrl } = env();
-    if (databaseUrl === undefined)
-        throw new Error("DATABASE_URL is not set: there is no database to sync db/schema into.");
-    return databaseUrl;
+function unpooledDatabaseUrl() {
+    const { unpooledDatabaseUrl } = env();
+    if (unpooledDatabaseUrl === undefined) {
+        throw new Error("DATABASE_URL_UNPOOLED is not set: light-db sync and migrate need the database's direct (unpooled) connection.");
+    }
+    return unpooledDatabaseUrl;
 }
 /**
  * Makes the database match `db/schema`, whatever the change does to the rows

package/dist/server/env.d.ts

@@ -1,6 +1,7 @@
 /** Read when asked, not at import: a build imports this without a runtime env. */
 export declare function env(): {
     databaseUrl: string | undefined;
+    unpooledDatabaseUrl: string | undefined;
     /** Sign-in needs Plaza, this app's id in it, and a database for sessions. */
     configured: boolean;
     /**

package/dist/server/env.js

@@ -4,12 +4,15 @@ import { z } from "zod/v4";
 const serverEnv = z
     .object({
     DATABASE_URL: z.string().min(1).optional(),
+    /** The same database without a pooler: schema changes and their locks need a session. */
+    DATABASE_URL_UNPOOLED: z.string().min(1).optional(),
     MII_PLAZA_URL: z.url().optional(),
     MII_APP_ID: z.string().min(1).optional(),
     NODE_ENV: z.string().optional()
 })
     .transform((env) => ({
     databaseUrl: env.DATABASE_URL,
+    unpooledDatabaseUrl: env.DATABASE_URL_UNPOOLED,
     /** Sign-in needs Plaza, this app's id in it, and a database for sessions. */
     configured: Boolean(env.MII_PLAZA_URL && env.MII_APP_ID && env.DATABASE_URL),
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trylight/app",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "The Light SDK every v2 org app depends on: entities (Drizzle tables with a typed client), sign-in, contracts and in-app chat.",
   "license": "UNLICENSED",
   "type": "module",