@philosophocat/postgres-migrations 0.1.1

package/README.md

@@ -0,0 +1,84 @@
+# Postgres Simple Migrations
+
+A tiny migration tool for Node.js/Bun build for [`postgres.js`](https://github.com/porsager/postgres).
+
+It keeps things simple: no CLI magic, just a typed class you can use in your own scripts.
+
+## Features
+
+- **Zero Heavy Dependencies**: Only depends on `postgres` (peer dependency).
+- **Advisory Locks**: Prevents race conditions when multiple instances try to migrate simultaneously.
+- **Atomic**: Migrations are applied inside transactions. If a migration fails, the DB state rolls back.
+- **File-based Scanning**: Automatically loads and sorts migrations from a directory.
+
+## Installation
+
+### npm
+```bash
+npm install @philosophocat/postgres-migrations
+```
+
+### bun
+```bash
+bun add @philosophocat/postgres-migrations
+```
+
+## Usage
+
+Create a file in your migrations folder (e.g., migrations/001_init.ts). The file name determines the execution order.
+
+```typescript
+  // migrations/001_init.ts
+import { Sql } from 'postgres';
+
+// The export name must be 'migration' or 'default'
+export const migration = {
+    name: 'users', // optional
+    async up(sql: Sql) {
+        await sql`
+            CREATE TABLE users (
+                id SERIAL PRIMARY KEY,
+                name TEXT NOT NULL,
+                created_at TIMESTAMP DEFAULT NOW()
+            );
+        `;
+    },
+    async down(sql: Sql) {
+        await sql`DROP TABLE users`;
+    },
+};
+```
+
+And run your migrations
+
+```typescript
+import { resolve } from 'node:path';
+import postgres from 'postgres';
+import { Migrator } from '@philosophocat/postgres-migrations';
+
+// 1. Setup postgres client
+const sql = postgres(process.env.DATABASE_URL!);
+
+// 2. Initialize Migrator
+const migrator = new Migrator({
+    sql,
+    // schema, default 'public'
+    // tableName, default 'migrations'
+    // lockId, optional advisory lock id
+});
+
+const run = async () => {
+    try {
+        // 3. Scan directory for .ts/.js files
+        await migrator.scan(resolve(__dirname, '../migrations'));
+        await migrator.up();
+    } catch (e) {
+        console.error(e);
+        process.exit(1);
+    } finally {
+        await sql.end();
+    }
+};
+
+run();
+```

package/dist/index.cjs

@@ -0,0 +1,177 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Migrator: () => Migrator
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/migrator.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+
+// src/repository.ts
+var Repository = class {
+  schema;
+  tableName;
+  sql;
+  lockID;
+  constructor({
+    sql,
+    schema = "public",
+    tableName = "migrations",
+    lockId = 2128506
+  }) {
+    this.sql = sql;
+    this.schema = schema;
+    this.tableName = tableName;
+    this.lockID = lockId;
+  }
+  async ensureTable() {
+    await this.sql`CREATE SCHEMA IF NOT EXISTS ${this.sql(this.schema)}`;
+    await this.sql`
+            CREATE TABLE IF NOT EXISTS ${this.sql(this.schema)}.${this.sql(this.tableName)} (
+                id SERIAL PRIMARY KEY,
+                name VARCHAR(255) NOT NULL UNIQUE,
+                created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+            )
+        `;
+  }
+  async tryLock() {
+    const [result] = await this.sql`
+            SELECT pg_try_advisory_lock(${this.lockID}) as locked
+        `;
+    return !!result?.locked;
+  }
+  async unlock() {
+    await this.sql`
+            SELECT pg_advisory_unlock(${this.lockID})
+        `;
+  }
+  async listApplied() {
+    await this.ensureTable();
+    const rows = await this.sql`
+            SELECT name FROM ${this.sql(this.schema)}.${this.sql(this.tableName)}
+        `;
+    return new Set(rows.map((r) => r.name));
+  }
+  async markApplied(name, trx) {
+    const sql = trx || this.sql;
+    await sql`
+            INSERT INTO ${this.sql(this.schema)}.${this.sql(this.tableName)} (name) VALUES (${name})
+        `;
+  }
+  async unmarkApplied(name, trx) {
+    const sql = trx || this.sql;
+    await sql`
+            DELETE FROM ${this.sql(this.schema)}.${this.sql(this.tableName)} WHERE name = ${name}
+        `;
+  }
+};
+
+// src/migrator.ts
+var Migrator = class {
+  constructor(options) {
+    this.options = options;
+    this.repo = new Repository(options);
+  }
+  migrations = [];
+  repo;
+  scan = async (dir) => {
+    const files = (0, import_node_fs.readdirSync)(dir).filter((f) => f.endsWith(".js") || f.endsWith(".ts")).sort();
+    for (const file of files) {
+      const filePath = (0, import_node_path.join)(dir, file);
+      const name = (0, import_node_path.parse)(file).name;
+      const module2 = await import(filePath);
+      const m = module2.migration || module2.default;
+      if (!m) {
+        console.warn(`Skipping ${file}: no migration export found`);
+        continue;
+      }
+      if (this.migrations.find((migration) => migration.name === name)) {
+        throw new Error(`Duplicated migration name: ${name}`);
+      }
+      this.migrations.push({
+        up: m.up,
+        down: m.down,
+        name: m.name || name
+      });
+    }
+  };
+  up = async () => {
+    if (this.migrations.length === 0) {
+      return console.log("Empty migrations list");
+    }
+    const locked = await this.repo.tryLock();
+    if (!locked) {
+      return console.log("Migrations are locked by another process");
+    }
+    try {
+      const applied = await this.repo.listApplied();
+      for (const m of this.migrations) {
+        if (!applied.has(m.name)) {
+          console.log(`Applying: ${m.name}`);
+          await this.options.sql.begin(async (trx) => {
+            await m.up(trx);
+            await this.repo.markApplied(m.name, trx);
+          });
+        }
+      }
+    } catch (e) {
+      console.error("Migration failed:", e);
+      throw e;
+    } finally {
+      await this.repo.unlock();
+    }
+  };
+  down = async (count = 1) => {
+    const locked = await this.repo.tryLock();
+    if (!locked) {
+      return console.log("Migrations locked");
+    }
+    try {
+      const applied = await this.repo.listApplied();
+      const toRollback = this.migrations.slice().reverse().filter((m) => applied.has(m.name));
+      let rolledBackCount = 0;
+      for (const m of toRollback) {
+        if (rolledBackCount >= count && count !== -1) {
+          break;
+        }
+        await this.options.sql.begin(async (trx) => {
+          await m.down(trx);
+          await this.repo.unmarkApplied(m.name, trx);
+        });
+        console.log(`Reverted: ${m.name}`);
+        rolledBackCount++;
+      }
+    } finally {
+      await this.repo.unlock();
+    }
+  };
+  async close() {
+    await this.options.sql.end();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Migrator
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/migrator.ts","../src/repository.ts"],"sourcesContent":["export * from './types';\nexport * from './migrator';\n","import { readdirSync } from 'node:fs';\nimport { join, parse } from 'node:path';\nimport { Repository } from './repository';\nimport { Migration, MigratorOptions } from './types';\n\nexport class Migrator {\n\n    private migrations: Migration[] = [];\n\n    private repo: Repository;\n\n    constructor(\n        private readonly options: MigratorOptions\n    ) {\n        this.repo = new Repository(options);\n    }\n\n    public scan = async (\n        dir: string\n    ) => {\n        const files = readdirSync(dir)\n            .filter(f => f.endsWith('.js') || f.endsWith('.ts'))\n            .sort();\n\n        for (const file of files) {\n            const filePath = join(dir, file);\n            const name = parse(file).name;\n            const module = await import(filePath);\n            const m = module.migration || module.default;\n\n            if (!m) {\n                console.warn(`Skipping ${file}: no migration export found`);\n                continue;\n            }\n\n            if (this.migrations.find(migration => migration.name === name)) {\n                throw new Error(`Duplicated migration name: ${name}`);\n            }\n\n            this.migrations.push({\n                up: m.up,\n                down: m.down,\n                name: m.name || name,\n            });\n        }\n    }\n\n    up = async () => {\n        if (this.migrations.length === 0) {\n            return console.log('Empty migrations list')\n        }\n\n        const locked = await this.repo.tryLock();\n        if (!locked) {\n            return console.log('Migrations are locked by another process');\n        }\n\n        try {\n            const applied = await this.repo.listApplied();\n\n            for (const m of this.migrations) {\n                if (!applied.has(m.name)) {\n                    console.log(`Applying: ${ m.name }`);\n\n                    await this.options.sql.begin(async (trx) => {\n                        await m.up(trx);\n                        await this.repo.markApplied(m.name, trx);\n                    });\n                }\n            }\n        } catch (e) {\n            console.error('Migration failed:', e);\n            throw e;\n        } finally {\n            await this.repo.unlock();\n        }\n    };\n\n    down = async (\n        count = 1\n    )  => {\n        const locked = await this.repo.tryLock();\n        if (!locked) {\n            return console.log('Migrations locked');\n        }\n\n        try {\n            const applied = await this.repo.listApplied();\n            const toRollback = this.migrations\n                .slice()\n                .reverse()\n                .filter(m => applied.has(m.name));\n\n            let rolledBackCount = 0;\n            for (const m of toRollback) {\n                if (rolledBackCount >= count && count !== -1) {\n                    break;\n                }\n\n                await this.options.sql.begin(async (trx) => {\n                    await m.down(trx);\n                    await this.repo.unmarkApplied(m.name, trx);\n                });\n                console.log(`Reverted: ${m.name}`);\n                rolledBackCount++;\n            }\n        } finally {\n            await this.repo.unlock();\n        }\n    }\n\n    async close() {\n        await this.options.sql.end();\n    };\n}\n","import type { Sql, TransactionSql } from 'postgres';\nimport { MigratorOptions } from './types';\n\nexport class Repository {\n    private readonly schema: string;\n    private readonly tableName: string;\n    private readonly sql: Sql;\n    private readonly lockID: number;\n\n    constructor({\n        sql,\n        schema = 'public',\n        tableName = 'migrations',\n        lockId = 2128506,\n    }: MigratorOptions) {\n        this.sql = sql;\n        this.schema = schema;\n        this.tableName = tableName;\n        this.lockID = lockId;\n    }\n\n    async ensureTable() {\n        await this.sql`CREATE SCHEMA IF NOT EXISTS ${this.sql(this.schema)}`;\n        await this.sql`\n            CREATE TABLE IF NOT EXISTS ${ this.sql(this.schema) }.${ this.sql(this.tableName) } (\n                id SERIAL PRIMARY KEY,\n                name VARCHAR(255) NOT NULL UNIQUE,\n                created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()\n            )\n        `;\n    };\n\n    async tryLock(): Promise<boolean> {\n        const [result] = await this.sql`\n            SELECT pg_try_advisory_lock(${ this.lockID }) as locked\n        `;\n        return !!result?.locked;\n    };\n\n    async unlock(): Promise<void> {\n        await this.sql`\n            SELECT pg_advisory_unlock(${ this.lockID })\n        `;\n    };\n\n    async listApplied(): Promise<Set<string>> {\n        await this.ensureTable();\n\n        const rows = await this.sql<{ name: string }[]>`\n            SELECT name FROM ${ this.sql(this.schema) }.${ this.sql(this.tableName) }\n        `;\n\n        return new Set(rows.map(r => r.name));\n    };\n\n    async markApplied(\n        name: string,\n        trx?: TransactionSql\n    ) {\n        const sql = (trx || this.sql) as Sql;\n        await sql`\n            INSERT INTO ${ this.sql(this.schema) }.${ this.sql(this.tableName) } (name) VALUES (${name})\n        `;\n    }\n\n    async unmarkApplied(\n        name: string,\n        trx?: TransactionSql\n    ) {\n        const sql = (trx || this.sql) as Sql;\n        await sql`\n            DELETE FROM ${ this.sql(this.schema) }.${ this.sql(this.tableName) } WHERE name = ${name}\n        `;\n    }\n}"],"mappings":"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","names":["module"]}

package/dist/index.d.cts

@@ -0,0 +1,31 @@
+import { Sql, TransactionSql } from 'postgres';
+
+interface Migration {
+    name: string;
+    up(sql: Sql | TransactionSql): Promise<void>;
+    down(sql: Sql | TransactionSql): Promise<void>;
+}
+interface MigratorOptions {
+    sql: Sql;
+    schema?: string;
+    tableName?: string;
+    lockId?: number;
+}
+interface MigrationRecord {
+    id: number;
+    name: string;
+    run_on: Date;
+}
+
+declare class Migrator {
+    private readonly options;
+    private migrations;
+    private repo;
+    constructor(options: MigratorOptions);
+    scan: (dir: string) => Promise<void>;
+    up: () => Promise<void>;
+    down: (count?: number) => Promise<void>;
+    close(): Promise<void>;
+}
+
+export { type Migration, type MigrationRecord, Migrator, type MigratorOptions };

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import { Sql, TransactionSql } from 'postgres';
+
+interface Migration {
+    name: string;
+    up(sql: Sql | TransactionSql): Promise<void>;
+    down(sql: Sql | TransactionSql): Promise<void>;
+}
+interface MigratorOptions {
+    sql: Sql;
+    schema?: string;
+    tableName?: string;
+    lockId?: number;
+}
+interface MigrationRecord {
+    id: number;
+    name: string;
+    run_on: Date;
+}
+
+declare class Migrator {
+    private readonly options;
+    private migrations;
+    private repo;
+    constructor(options: MigratorOptions);
+    scan: (dir: string) => Promise<void>;
+    up: () => Promise<void>;
+    down: (count?: number) => Promise<void>;
+    close(): Promise<void>;
+}
+
+export { type Migration, type MigrationRecord, Migrator, type MigratorOptions };

package/dist/index.js

@@ -0,0 +1,150 @@
+// src/migrator.ts
+import { readdirSync } from "fs";
+import { join, parse } from "path";
+
+// src/repository.ts
+var Repository = class {
+  schema;
+  tableName;
+  sql;
+  lockID;
+  constructor({
+    sql,
+    schema = "public",
+    tableName = "migrations",
+    lockId = 2128506
+  }) {
+    this.sql = sql;
+    this.schema = schema;
+    this.tableName = tableName;
+    this.lockID = lockId;
+  }
+  async ensureTable() {
+    await this.sql`CREATE SCHEMA IF NOT EXISTS ${this.sql(this.schema)}`;
+    await this.sql`
+            CREATE TABLE IF NOT EXISTS ${this.sql(this.schema)}.${this.sql(this.tableName)} (
+                id SERIAL PRIMARY KEY,
+                name VARCHAR(255) NOT NULL UNIQUE,
+                created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
+            )
+        `;
+  }
+  async tryLock() {
+    const [result] = await this.sql`
+            SELECT pg_try_advisory_lock(${this.lockID}) as locked
+        `;
+    return !!result?.locked;
+  }
+  async unlock() {
+    await this.sql`
+            SELECT pg_advisory_unlock(${this.lockID})
+        `;
+  }
+  async listApplied() {
+    await this.ensureTable();
+    const rows = await this.sql`
+            SELECT name FROM ${this.sql(this.schema)}.${this.sql(this.tableName)}
+        `;
+    return new Set(rows.map((r) => r.name));
+  }
+  async markApplied(name, trx) {
+    const sql = trx || this.sql;
+    await sql`
+            INSERT INTO ${this.sql(this.schema)}.${this.sql(this.tableName)} (name) VALUES (${name})
+        `;
+  }
+  async unmarkApplied(name, trx) {
+    const sql = trx || this.sql;
+    await sql`
+            DELETE FROM ${this.sql(this.schema)}.${this.sql(this.tableName)} WHERE name = ${name}
+        `;
+  }
+};
+
+// src/migrator.ts
+var Migrator = class {
+  constructor(options) {
+    this.options = options;
+    this.repo = new Repository(options);
+  }
+  migrations = [];
+  repo;
+  scan = async (dir) => {
+    const files = readdirSync(dir).filter((f) => f.endsWith(".js") || f.endsWith(".ts")).sort();
+    for (const file of files) {
+      const filePath = join(dir, file);
+      const name = parse(file).name;
+      const module = await import(filePath);
+      const m = module.migration || module.default;
+      if (!m) {
+        console.warn(`Skipping ${file}: no migration export found`);
+        continue;
+      }
+      if (this.migrations.find((migration) => migration.name === name)) {
+        throw new Error(`Duplicated migration name: ${name}`);
+      }
+      this.migrations.push({
+        up: m.up,
+        down: m.down,
+        name: m.name || name
+      });
+    }
+  };
+  up = async () => {
+    if (this.migrations.length === 0) {
+      return console.log("Empty migrations list");
+    }
+    const locked = await this.repo.tryLock();
+    if (!locked) {
+      return console.log("Migrations are locked by another process");
+    }
+    try {
+      const applied = await this.repo.listApplied();
+      for (const m of this.migrations) {
+        if (!applied.has(m.name)) {
+          console.log(`Applying: ${m.name}`);
+          await this.options.sql.begin(async (trx) => {
+            await m.up(trx);
+            await this.repo.markApplied(m.name, trx);
+          });
+        }
+      }
+    } catch (e) {
+      console.error("Migration failed:", e);
+      throw e;
+    } finally {
+      await this.repo.unlock();
+    }
+  };
+  down = async (count = 1) => {
+    const locked = await this.repo.tryLock();
+    if (!locked) {
+      return console.log("Migrations locked");
+    }
+    try {
+      const applied = await this.repo.listApplied();
+      const toRollback = this.migrations.slice().reverse().filter((m) => applied.has(m.name));
+      let rolledBackCount = 0;
+      for (const m of toRollback) {
+        if (rolledBackCount >= count && count !== -1) {
+          break;
+        }
+        await this.options.sql.begin(async (trx) => {
+          await m.down(trx);
+          await this.repo.unmarkApplied(m.name, trx);
+        });
+        console.log(`Reverted: ${m.name}`);
+        rolledBackCount++;
+      }
+    } finally {
+      await this.repo.unlock();
+    }
+  };
+  async close() {
+    await this.options.sql.end();
+  }
+};
+export {
+  Migrator
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/migrator.ts","../src/repository.ts"],"sourcesContent":["import { readdirSync } from 'node:fs';\nimport { join, parse } from 'node:path';\nimport { Repository } from './repository';\nimport { Migration, MigratorOptions } from './types';\n\nexport class Migrator {\n\n    private migrations: Migration[] = [];\n\n    private repo: Repository;\n\n    constructor(\n        private readonly options: MigratorOptions\n    ) {\n        this.repo = new Repository(options);\n    }\n\n    public scan = async (\n        dir: string\n    ) => {\n        const files = readdirSync(dir)\n            .filter(f => f.endsWith('.js') || f.endsWith('.ts'))\n            .sort();\n\n        for (const file of files) {\n            const filePath = join(dir, file);\n            const name = parse(file).name;\n            const module = await import(filePath);\n            const m = module.migration || module.default;\n\n            if (!m) {\n                console.warn(`Skipping ${file}: no migration export found`);\n                continue;\n            }\n\n            if (this.migrations.find(migration => migration.name === name)) {\n                throw new Error(`Duplicated migration name: ${name}`);\n            }\n\n            this.migrations.push({\n                up: m.up,\n                down: m.down,\n                name: m.name || name,\n            });\n        }\n    }\n\n    up = async () => {\n        if (this.migrations.length === 0) {\n            return console.log('Empty migrations list')\n        }\n\n        const locked = await this.repo.tryLock();\n        if (!locked) {\n            return console.log('Migrations are locked by another process');\n        }\n\n        try {\n            const applied = await this.repo.listApplied();\n\n            for (const m of this.migrations) {\n                if (!applied.has(m.name)) {\n                    console.log(`Applying: ${ m.name }`);\n\n                    await this.options.sql.begin(async (trx) => {\n                        await m.up(trx);\n                        await this.repo.markApplied(m.name, trx);\n                    });\n                }\n            }\n        } catch (e) {\n            console.error('Migration failed:', e);\n            throw e;\n        } finally {\n            await this.repo.unlock();\n        }\n    };\n\n    down = async (\n        count = 1\n    )  => {\n        const locked = await this.repo.tryLock();\n        if (!locked) {\n            return console.log('Migrations locked');\n        }\n\n        try {\n            const applied = await this.repo.listApplied();\n            const toRollback = this.migrations\n                .slice()\n                .reverse()\n                .filter(m => applied.has(m.name));\n\n            let rolledBackCount = 0;\n            for (const m of toRollback) {\n                if (rolledBackCount >= count && count !== -1) {\n                    break;\n                }\n\n                await this.options.sql.begin(async (trx) => {\n                    await m.down(trx);\n                    await this.repo.unmarkApplied(m.name, trx);\n                });\n                console.log(`Reverted: ${m.name}`);\n                rolledBackCount++;\n            }\n        } finally {\n            await this.repo.unlock();\n        }\n    }\n\n    async close() {\n        await this.options.sql.end();\n    };\n}\n","import type { Sql, TransactionSql } from 'postgres';\nimport { MigratorOptions } from './types';\n\nexport class Repository {\n    private readonly schema: string;\n    private readonly tableName: string;\n    private readonly sql: Sql;\n    private readonly lockID: number;\n\n    constructor({\n        sql,\n        schema = 'public',\n        tableName = 'migrations',\n        lockId = 2128506,\n    }: MigratorOptions) {\n        this.sql = sql;\n        this.schema = schema;\n        this.tableName = tableName;\n        this.lockID = lockId;\n    }\n\n    async ensureTable() {\n        await this.sql`CREATE SCHEMA IF NOT EXISTS ${this.sql(this.schema)}`;\n        await this.sql`\n            CREATE TABLE IF NOT EXISTS ${ this.sql(this.schema) }.${ this.sql(this.tableName) } (\n                id SERIAL PRIMARY KEY,\n                name VARCHAR(255) NOT NULL UNIQUE,\n                created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()\n            )\n        `;\n    };\n\n    async tryLock(): Promise<boolean> {\n        const [result] = await this.sql`\n            SELECT pg_try_advisory_lock(${ this.lockID }) as locked\n        `;\n        return !!result?.locked;\n    };\n\n    async unlock(): Promise<void> {\n        await this.sql`\n            SELECT pg_advisory_unlock(${ this.lockID })\n        `;\n    };\n\n    async listApplied(): Promise<Set<string>> {\n        await this.ensureTable();\n\n        const rows = await this.sql<{ name: string }[]>`\n            SELECT name FROM ${ this.sql(this.schema) }.${ this.sql(this.tableName) }\n        `;\n\n        return new Set(rows.map(r => r.name));\n    };\n\n    async markApplied(\n        name: string,\n        trx?: TransactionSql\n    ) {\n        const sql = (trx || this.sql) as Sql;\n        await sql`\n            INSERT INTO ${ this.sql(this.schema) }.${ this.sql(this.tableName) } (name) VALUES (${name})\n        `;\n    }\n\n    async unmarkApplied(\n        name: string,\n        trx?: TransactionSql\n    ) {\n        const sql = (trx || this.sql) as Sql;\n        await sql`\n            DELETE FROM ${ this.sql(this.schema) }.${ this.sql(this.tableName) } WHERE name = ${name}\n        `;\n    }\n}"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@philosophocat/postgres-migrations",
+  "version": "0.1.1",
+  "description": "Simple migrations for postgres.js",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "postgres",
+    "migrations",
+    "typescript"
+  ],
+  "peerDependencies": {
+    "postgres": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "postgres": "^3.4.8",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.17"
+  },
+  "sideEffects": false,
+  "author": "Viacheslav Sergeev <philosophocat@gmail.com>",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/твое-имя/репозиторий.git"
+  }
+}