Added readBundle

index.d.mts

@@ -1,3 +1,4 @@
+import { URL } from "node:url";
 import Database from "@farjs/better-sqlite3-wrapper";
 
 export interface MigrationBundleItem {
@@ -7,6 +8,8 @@ export interface MigrationBundleItem {
 
 export type MigrationBundle = MigrationBundleItem[];
 
+export function readBundle(url: URL): Promise<MigrationBundle>;
+
 export function runBundle(db: Database, bundle: MigrationBundle): Promise<void>;
 
 export function createBundle(args: string[]): Promise<void>;

index.mjs

@@ -1,8 +1,18 @@
 /**
+ * @typedef {import("node:url").URL} URL
  * @typedef {import("@farjs/better-sqlite3-wrapper").Database} Database
  * @typedef {import("./index.mjs").MigrationBundle} MigrationBundle
  */
 
+/**
+ * @param {URL} url
+ * @returns {Promise<MigrationBundle>}
+ */
+export async function readBundle(url) {
+  const { readBundle } = await import("./src/runner.mjs");
+  return readBundle(url);
+}
+
 /**
  * @param {Database} db
  * @param {MigrationBundle} bundle

src/bundler.mjs

@@ -53,7 +53,11 @@ export async function createBundle(args) {
       };
     });
 
-    fs.writeFileSync(migrationsBundle, JSON.stringify(bundleObj, undefined, 2));
+    fs.writeFileSync(
+      migrationsBundle,
+      JSON.stringify(bundleObj, undefined, 2),
+      { encoding: "utf8" }
+    );
     console.log(`Generated SQL bundle file: ${migrationsBundle}`);
     return;
   }

src/runner.mjs

@@ -1,7 +1,9 @@
 /**
+ * @typedef {import("node:url").URL} URL
  * @typedef {import("@farjs/better-sqlite3-wrapper").Database} Database
  * @typedef {import("../index.mjs").MigrationBundle} MigrationBundle
  */
+import fs from "fs";
 import Database from "@farjs/better-sqlite3-wrapper";
 
 /**
@@ -16,6 +18,18 @@ const dbTable = "schema_versions";
 const versionAndNameRegex = /V(\d+)__(.+).sql/i;
 const underscoreRegex = /_/g;
 
+/**
+ * @param {URL} url
+ * @returns {Promise<MigrationBundle>}
+ */
+export async function readBundle(url) {
+  const json = fs.readFileSync(url, { encoding: "utf8" });
+
+  /** @type {MigrationBundle} */
+  const bundle = JSON.parse(json);
+  return bundle;
+}
+
 /**
  * @param {Database} db
  * @param {MigrationBundle} bundle

test/runner.test.mjs

@@ -2,10 +2,11 @@
  * @typedef {import("@farjs/better-sqlite3-wrapper").Database} Database
  * @typedef {import("../index.mjs").MigrationBundleItem} MigrationBundleItem
  */
+import { URL } from "node:url";
 import assert from "node:assert/strict";
 import mockFunction from "mock-fn";
 import Database from "@farjs/better-sqlite3-wrapper";
-import { runBundle } from "../index.mjs";
+import { readBundle, runBundle } from "../index.mjs";
 
 const { describe, it } = await (async () => {
   // @ts-ignore
@@ -351,6 +352,41 @@ describe("runner.test.mjs", () => {
     assertSchema(db, [{ version: 1, name: "non-transactional migration" }]);
   });
 
+  it("should run migrations from bundle.json", async () => {
+    //given
+    const db = new Database(":memory:");
+    const logs = /** @type {string[]} */ ([]);
+    const logMock = mockFunction((msg) => {
+      logs.push(msg);
+    });
+    const savedLog = console.log;
+    console.log = logMock;
+
+    //when & then
+    const bundleUrl = new URL("./migrations/bundle.json", import.meta.url);
+    const bundle = await readBundle(bundleUrl);
+
+    //when
+    await runBundle(db, bundle);
+
+    //then
+    console.log = savedLog;
+    assert.deepEqual(logMock.times, 3);
+    assert.deepEqual(logs, [
+      "DB: migrating to version 1 - initial db structure",
+      "DB: migrating to version 2 - rename db field",
+      "DB: 2 migration(s) were applied successfully",
+    ]);
+    assertDb(db, [
+      { id: 1, name: "test 1" },
+      { id: 2, name: "test 2" },
+    ]);
+    assertSchema(db, [
+      { version: 1, name: "initial db structure" },
+      { version: 2, name: "rename db field" },
+    ]);
+  });
+
   it("should fail if cannot parse migration version and name", async () => {
     //given
     const db = new Database(":memory:");