@zeno-lib/db 0.7.0-beta.0 → 0.7.0

package/dist/config.d.mts

@@ -15,6 +15,13 @@ import { Config, defineConfig } from "drizzle-kit";
  * Verified against Supabase CLI 2.84.1 / Postgres 17.
  */
 declare const supabaseManagedRoles: readonly ["pg_checkpoint", "pg_database_owner", "pg_execute_server_program", "pg_monitor", "pg_read_all_data", "pg_read_all_settings", "pg_read_all_stats", "pg_read_server_files", "pg_signal_backend", "pg_stat_scan_tables", "pg_write_all_data", "pg_write_server_files", "pgbouncer", "postgres", "supabase_functions_admin", "supabase_read_only_user", "supabase_realtime_admin", "supabase_replication_admin"];
-declare function defineDrizzleConfig(overrides?: Partial<Config>): ReturnType<typeof defineConfig>;
+/**
+ * Drizzle Kit config for migrations the Supabase CLI applies.
+ * Moves each generated `<name>/migration.sql` to `<name>.sql` when `drizzle-kit generate` exits.
+ * Set `moveGeneratedSql: false` if `drizzle-kit migrate` applies them instead.
+ */
+declare function defineDrizzleConfig(overrides?: Partial<Config> & {
+  moveGeneratedSql?: boolean;
+}): ReturnType<typeof defineConfig>;
 //#endregion
 export { defineDrizzleConfig, supabaseManagedRoles };

package/dist/config.mjs

@@ -77,8 +77,13 @@ const supabaseManagedRoles = [
 * never right. Add your own schemas here rather than dropping the filter.
 */
 const DEFAULT_SCHEMA_FILTER = ["public"];
+/**
+* Drizzle Kit config for migrations the Supabase CLI applies.
+* Moves each generated `<name>/migration.sql` to `<name>.sql` when `drizzle-kit generate` exits.
+* Set `moveGeneratedSql: false` if `drizzle-kit migrate` applies them instead.
+*/
 function defineDrizzleConfig(overrides = {}) {
-	const { entities, ...configOverrides } = overrides;
+	const { entities, moveGeneratedSql = true, ...configOverrides } = overrides;
 	const roleOverrides = typeof entities?.roles === "object" ? entities.roles : {};
 	const config = defineConfig({
 		dbCredentials: { url: process.env.SUPABASE_DATABASE_URL ?? "" },
@@ -96,7 +101,7 @@ function defineDrizzleConfig(overrides = {}) {
 		schemaFilter: DEFAULT_SCHEMA_FILTER,
 		...configOverrides
 	});
-	if (config.out) moveGeneratedSqlAfterGenerate({ migrationsDir: config.out });
+	if (moveGeneratedSql && config.out) moveGeneratedSqlAfterGenerate({ migrationsDir: config.out });
 	return config;
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeno-lib/db",
-  "version": "0.7.0-beta.0",
+  "version": "0.7.0",
   "type": "module",
   "exports": {
     ".": {

package/src/config.ts

@@ -45,10 +45,15 @@ export const supabaseManagedRoles = [
  */
 const DEFAULT_SCHEMA_FILTER = ["public"]
 
+/**
+ * Drizzle Kit config for migrations the Supabase CLI applies.
+ * Moves each generated `<name>/migration.sql` to `<name>.sql` when `drizzle-kit generate` exits.
+ * Set `moveGeneratedSql: false` if `drizzle-kit migrate` applies them instead.
+ */
 export function defineDrizzleConfig(
-  overrides: Partial<Config> = {}
+  overrides: Partial<Config> & { moveGeneratedSql?: boolean } = {}
 ): ReturnType<typeof defineConfig> {
-  const { entities, ...configOverrides } = overrides
+  const { entities, moveGeneratedSql = true, ...configOverrides } = overrides
   // `entities.roles` may be a boolean (`true`) in drizzle-kit config; in that
   // form there are no role options to preserve, so we only merge the object
   // form. The `provider: "supabase"` flag below is always enforced regardless.
@@ -76,7 +81,7 @@ export function defineDrizzleConfig(
     ...configOverrides,
   } as Config)
 
-  if (config.out) {
+  if (moveGeneratedSql && config.out) {
     moveGeneratedSqlAfterGenerate({ migrationsDir: config.out })
   }
 

package/src/move-generated-sql.test.ts

@@ -0,0 +1,98 @@
+import {
+  mkdirSync,
+  mkdtempSync,
+  readdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync,
+} from "node:fs"
+import { tmpdir } from "node:os"
+import { join } from "node:path"
+import { afterEach, beforeEach, describe, expect, it } from "vitest"
+import { moveGeneratedSql } from "./move-generated-sql.ts"
+
+const POSTS = "20260102030405_posts"
+const COMMENTS = "20260102030406_comments"
+
+let migrationsDir: string
+
+beforeEach(() => {
+  migrationsDir = mkdtempSync(join(tmpdir(), "zeno-db-migrations-"))
+})
+
+afterEach(() => {
+  rmSync(migrationsDir, { force: true, recursive: true })
+})
+
+// Write `<name>/migration.sql` and `<name>/snapshot.json`, as `drizzle-kit generate` does.
+function generated(name: string): void {
+  mkdirSync(join(migrationsDir, name))
+  writeFileSync(join(migrationsDir, name, "migration.sql"), `-- ${name}`)
+  writeFileSync(join(migrationsDir, name, "snapshot.json"), "{}")
+}
+
+// The migrations folder, sorted.
+const files = () => readdirSync(migrationsDir).sort()
+
+const read = (name: string) => readFileSync(join(migrationsDir, name), "utf-8")
+
+describe("moveGeneratedSql", () => {
+  it("moves migration.sql next to its folder", () => {
+    generated(POSTS)
+
+    moveGeneratedSql({ migrationsDir })
+
+    expect(files()).toEqual([POSTS, `${POSTS}.sql`])
+    expect(readdirSync(join(migrationsDir, POSTS))).toEqual(["snapshot.json"])
+    expect(read(`${POSTS}.sql`)).toBe(`-- ${POSTS}`)
+  })
+
+  it("returns the new paths in name order", () => {
+    generated(COMMENTS)
+    generated(POSTS)
+
+    expect(moveGeneratedSql({ migrationsDir })).toEqual({
+      moved: [
+        join(migrationsDir, `${POSTS}.sql`),
+        join(migrationsDir, `${COMMENTS}.sql`),
+      ],
+    })
+  })
+
+  it("moves nothing on a second run", () => {
+    generated(POSTS)
+    moveGeneratedSql({ migrationsDir })
+
+    expect(moveGeneratedSql({ migrationsDir })).toEqual({ moved: [] })
+  })
+
+  it("leaves a hand-written .sql file alone", () => {
+    generated(POSTS)
+    writeFileSync(join(migrationsDir, "20260102030407_grants.sql"), "grant;")
+
+    moveGeneratedSql({ migrationsDir })
+
+    expect(files()).toEqual([
+      POSTS,
+      `${POSTS}.sql`,
+      "20260102030407_grants.sql",
+    ])
+    expect(read("20260102030407_grants.sql")).toBe("grant;")
+  })
+
+  it("throws before moving anything when a .sql file is in the way", () => {
+    generated(POSTS)
+    generated(COMMENTS)
+    writeFileSync(join(migrationsDir, `${COMMENTS}.sql`), "-- edited by hand")
+
+    expect(() => moveGeneratedSql({ migrationsDir })).toThrow(`${COMMENTS}.sql`)
+    expect(files()).toEqual([POSTS, COMMENTS, `${COMMENTS}.sql`])
+    expect(read(`${COMMENTS}.sql`)).toBe("-- edited by hand")
+  })
+
+  it("returns nothing for a missing folder", () => {
+    expect(
+      moveGeneratedSql({ migrationsDir: join(migrationsDir, "missing") })
+    ).toEqual({ moved: [] })
+  })
+})