@sebspark/spanner-migrate 0.1.0 → 0.2.0

package/README.md

@@ -1,3 +1,124 @@
-# `@sebspark/spanner-migrate`
+# @sebspark/spanner-migrate
 
-Migration tool for Spanner DB
+`spanner-migrate` is a CLI tool for managing schema migrations for Google Cloud Spanner. It simplifies schema evolution by allowing you to create, apply, rollback, and track migrations.
+
+---
+
+## Installation
+
+Install `@sebspark/spanner-migrate` as a global package:
+
+```zsh
+yarn add -D @sebspark/spanner-migrate
+```
+
+---
+
+## CLI Usage
+
+Run `spanner-migrate` from your project root. If no command is provided, the help message is displayed.
+
+```zsh
+spanner-migrate [command] [options]
+```
+
+### Commands
+
+#### `init`
+Initialize a Spanner migration configuration file (`.spanner-migrate.config.json`).
+
+**Usage:**
+
+```zsh
+spanner-migrate init
+```
+
+**Prompts:**
+- `Enter the path for your migrations`: Directory for migration files (default: `./migrations`).
+- `Enter Spanner instance name`: The name of the Spanner instance.
+- `Enter Spanner database name`: The name of the Spanner database.
+- `Enter Google Cloud project name`: (Optional) The Google Cloud project name.
+
+---
+
+#### `create <description>`
+Create a new migration file.
+
+**Usage:**
+
+```zsh
+spanner-migrate create add users table
+```
+
+**Result:**
+
+Example:
+
+`./migrations/20250120145638000_create_table_users.sql`
+
+```sql
+-- Created: 2025-01-20T14:56:38.000Z
+-- Description: create table users
+
+---- UP ----
+
+
+
+---- DOWN ----
+
+
+
+```
+
+#### `up`
+Apply pending migrations
+
+**Usage:**
+
+```zsh
+spanner-migrate up
+```
+
+If you don't want to apply all pending migrations, use the `--max` or `-m` flag
+
+```zsh
+spanner migrate up --max 1
+```
+
+#### `down`
+Rollback one migration
+
+**Usage:**
+
+```zsh
+spanner-migrate down
+```
+
+#### `status`
+Check migration status
+
+**Usage:**
+
+```zsh
+spanner-migrate status
+```
+Displays an overview of applied and peding migrations
+
+```text
+Migrations
+
+Applied
+--------------------------------------------------------------------------------
+20250122080434866_add_users_table
+20250122080444982_add_index_on_users
+
+New
+--------------------------------------------------------------------------------
+20250122080444982_add_index_on_users
+```
+
+---
+
+## License
+
+[Apache-2.0](LICENSE)

package/dist/{chunk-K5WX6ESL.mjs → chunk-Z3ZLNDVO.mjs}

@@ -70,12 +70,11 @@ var runScript = async (db, script) => {
   }
   for (const statement of statements) {
     console.log(`Executing statement: ${statement}`);
-    const sql = statement.replace(/--.*$/gm, "");
-    if (isSchemaChange(sql)) {
-      await db.updateSchema(sql);
+    if (isSchemaChange(statement)) {
+      await db.updateSchema(statement);
     } else {
       await db.runTransactionAsync(async (transaction) => {
-        await transaction.runUpdate(sql);
+        await transaction.runUpdate(statement);
         await transaction.commit();
       });
     }
@@ -132,12 +131,12 @@ var getAppliedMigrations = async (db) => {
 };
 
 // src/files.ts
-import { access, mkdir, readdir, writeFile } from "node:fs/promises";
+import { access, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 var getMigrationFiles = async (path) => {
   try {
     const files = await readdir(path);
-    const migrationFileIds = files.filter((file) => file.endsWith(".ts")).map((file) => file.replace(/\.ts$/, ""));
+    const migrationFileIds = files.filter((file) => file.endsWith(".sql")).map((file) => file.replace(/\.sql$/, ""));
     return migrationFileIds;
   } catch (error) {
     throw new Error(
@@ -147,31 +146,40 @@ var getMigrationFiles = async (path) => {
 };
 var getMigration = async (path, id) => {
   try {
-    const filePath = resolve(process.cwd(), join(path, `${id}.ts`));
+    const filePath = resolve(process.cwd(), join(path, `${id}.sql`));
     try {
       await access(filePath);
     } catch (err) {
       throw new Error(`Migration file not found: ${filePath}`);
     }
-    const migrationModule = await import(filePath);
-    if (!migrationModule.up || !migrationModule.down) {
+    const migrationText = await readFile(filePath, "utf8");
+    const up2 = getSql(migrationText, "up");
+    const down2 = getSql(migrationText, "down");
+    const description = getDescription(migrationText);
+    if (!up2 || !down2) {
       throw new Error(
         `Migration file ${filePath} does not export required scripts (up, down).`
       );
     }
-    return {
-      id,
-      description: id.split("_").slice(1).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" "),
-      // Generate a human-readable description
-      up: migrationModule.up,
-      down: migrationModule.down
-    };
+    return { id, description, up: up2, down: down2 };
   } catch (error) {
     throw new Error(
       `Failed to get migration ${id}: ${error.message}`
     );
   }
 };
+var getDescription = (text) => {
+  var _a, _b;
+  return ((_b = (_a = text == null ? void 0 : text.match(/^--\s*Description:\s*(.+)$/m)) == null ? void 0 : _a[1]) == null ? void 0 : _b.trim()) || "";
+};
+var getSql = (text, direction) => {
+  var _a, _b;
+  const rx = {
+    up: /---- UP ----\n([\s\S]*?)\n---- DOWN ----/,
+    down: /---- DOWN ----\n([\s\S]*)$/
+  };
+  return (_b = (_a = text == null ? void 0 : text.match(rx[direction])) == null ? void 0 : _a[1]) == null ? void 0 : _b.replace(/--.*$/gm, "").trim();
+};
 var getNewMigrations = (applied, files) => {
   const sortedFiles = files.sort();
   for (let ix = 0; ix < applied.length; ix++) {
@@ -190,18 +198,18 @@ var createMigration = async (path, description) => {
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   const compactTimestamp = timestamp.replace(/[-:.TZ]/g, "");
   const parsedDescription = description.replace(/\s+/g, "_").toLowerCase();
-  const filename = `${compactTimestamp}_${parsedDescription}.ts`;
+  const filename = `${compactTimestamp}_${parsedDescription}.sql`;
   const filePath = join(path, filename);
-  const template = `// ${timestamp}
-// ${description}
+  const template = `-- Created: ${timestamp}
+-- Description: ${description}
+
+---- UP ----
+
+
+
+---- DOWN ----
 
-export const up = \`
-  -- SQL for migrate up
-\`
 
-export const down = \`
-  -- SQL for migrate down
-\`
 `;
   try {
     await mkdir(path, { recursive: true });

package/dist/cli.js

@@ -26,6 +26,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/cli.ts
 var import_promises2 = __toESM(require("fs/promises"));
 var import_node_path2 = require("path");
+var import_input = __toESM(require("@inquirer/input"));
 var import_yargs = __toESM(require("yargs"));
 var import_helpers = require("yargs/helpers");
 
@@ -101,12 +102,11 @@ var runScript = async (db, script) => {
   }
   for (const statement of statements) {
     console.log(`Executing statement: ${statement}`);
-    const sql = statement.replace(/--.*$/gm, "");
-    if (isSchemaChange(sql)) {
-      await db.updateSchema(sql);
+    if (isSchemaChange(statement)) {
+      await db.updateSchema(statement);
     } else {
       await db.runTransactionAsync(async (transaction) => {
-        await transaction.runUpdate(sql);
+        await transaction.runUpdate(statement);
         await transaction.commit();
       });
     }
@@ -168,7 +168,7 @@ var import_node_path = require("path");
 var getMigrationFiles = async (path) => {
   try {
     const files = await (0, import_promises.readdir)(path);
-    const migrationFileIds = files.filter((file) => file.endsWith(".ts")).map((file) => file.replace(/\.ts$/, ""));
+    const migrationFileIds = files.filter((file) => file.endsWith(".sql")).map((file) => file.replace(/\.sql$/, ""));
     return migrationFileIds;
   } catch (error) {
     throw new Error(
@@ -178,31 +178,40 @@ var getMigrationFiles = async (path) => {
 };
 var getMigration = async (path, id) => {
   try {
-    const filePath = (0, import_node_path.resolve)(process.cwd(), (0, import_node_path.join)(path, `${id}.ts`));
+    const filePath = (0, import_node_path.resolve)(process.cwd(), (0, import_node_path.join)(path, `${id}.sql`));
     try {
       await (0, import_promises.access)(filePath);
     } catch (err) {
       throw new Error(`Migration file not found: ${filePath}`);
     }
-    const migrationModule = await import(filePath);
-    if (!migrationModule.up || !migrationModule.down) {
+    const migrationText = await (0, import_promises.readFile)(filePath, "utf8");
+    const up2 = getSql(migrationText, "up");
+    const down2 = getSql(migrationText, "down");
+    const description = getDescription(migrationText);
+    if (!up2 || !down2) {
       throw new Error(
         `Migration file ${filePath} does not export required scripts (up, down).`
       );
     }
-    return {
-      id,
-      description: id.split("_").slice(1).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" "),
-      // Generate a human-readable description
-      up: migrationModule.up,
-      down: migrationModule.down
-    };
+    return { id, description, up: up2, down: down2 };
   } catch (error) {
     throw new Error(
       `Failed to get migration ${id}: ${error.message}`
     );
   }
 };
+var getDescription = (text) => {
+  var _a, _b;
+  return ((_b = (_a = text == null ? void 0 : text.match(/^--\s*Description:\s*(.+)$/m)) == null ? void 0 : _a[1]) == null ? void 0 : _b.trim()) || "";
+};
+var getSql = (text, direction) => {
+  var _a, _b;
+  const rx = {
+    up: /---- UP ----\n([\s\S]*?)\n---- DOWN ----/,
+    down: /---- DOWN ----\n([\s\S]*)$/
+  };
+  return (_b = (_a = text == null ? void 0 : text.match(rx[direction])) == null ? void 0 : _a[1]) == null ? void 0 : _b.replace(/--.*$/gm, "").trim();
+};
 var getNewMigrations = (applied, files) => {
   const sortedFiles = files.sort();
   for (let ix = 0; ix < applied.length; ix++) {
@@ -221,18 +230,18 @@ var createMigration = async (path, description) => {
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   const compactTimestamp = timestamp.replace(/[-:.TZ]/g, "");
   const parsedDescription = description.replace(/\s+/g, "_").toLowerCase();
-  const filename = `${compactTimestamp}_${parsedDescription}.ts`;
+  const filename = `${compactTimestamp}_${parsedDescription}.sql`;
   const filePath = (0, import_node_path.join)(path, filename);
-  const template = `// ${timestamp}
-// ${description}
+  const template = `-- Created: ${timestamp}
+-- Description: ${description}
+
+---- UP ----
+
+
+
+---- DOWN ----
 
-export const up = \`
-  -- SQL for migrate up
-\`
 
-export const down = \`
-  -- SQL for migrate down
-\`
 `;
   try {
     await (0, import_promises.mkdir)(path, { recursive: true });
@@ -314,36 +323,34 @@ async function loadConfig() {
     process.exit(1);
   }
 }
-(0, import_yargs.default)((0, import_helpers.hideBin)(process.argv)).scriptName("spanner-migrate").usage("$0 <command> [options]").command(
+(0, import_yargs.default)((0, import_helpers.hideBin)(process.argv)).scriptName("spanner-migrate").usage("$0 <command>").command(
   "init",
   "Initialize a .spanner-migrate.config.json file",
-  (yargs2) => {
-    yargs2.option("migrationsPath", {
-      type: "string",
-      describe: "Path to the migrations folder",
-      default: "./spanner-migrations"
+  async () => {
+    const migrationsPath = await (0, import_input.default)({
+      message: "Enter the path for your migrations",
+      required: true,
+      default: "./migrations"
     });
-    yargs2.option("instanceName", {
-      type: "string",
-      describe: "Spanner instance name",
-      demandOption: true
+    const instanceName = await (0, import_input.default)({
+      message: "Enter Spanner instance name",
+      required: true
     });
-    yargs2.option("databaseName", {
-      type: "string",
-      describe: "Spanner database name",
-      demandOption: true
+    const databaseName = await (0, import_input.default)({
+      message: "Enter Spanner database name",
+      required: true
     });
-    yargs2.option("projectName", {
-      type: "string",
-      describe: "Google Cloud project name (optional)"
+    const projectId = await (0, import_input.default)({
+      message: "Enter Google Cloud project name",
+      required: false
     });
-  },
-  async (args) => {
-    await init(args, CONFIG_FILE);
+    const config = { instanceName, databaseName, migrationsPath };
+    if (projectId) config.projectId = projectId;
+    await init(config, CONFIG_FILE);
     console.log(`Configuration written to ${CONFIG_FILE}`);
   }
 ).command(
-  "create <description>",
+  "create <description ...>",
   "Create a new migration file",
   (yargs2) => {
     yargs2.positional("description", {
@@ -354,9 +361,10 @@ async function loadConfig() {
   },
   async (args) => {
     const config = await loadConfig();
-    await create(config, args.description);
+    const fullDescription = args.description.join(" ");
+    await create(config, fullDescription);
     console.log(
-      `Migration file created: '${(0, import_node_path2.join)(config.migrationsPath, args.description)}'`
+      `Migration file created: '${(0, import_node_path2.join)(config.migrationsPath, args.description.join("_"))}.sql'`
     );
   }
 ).command(
@@ -383,4 +391,4 @@ async function loadConfig() {
   const config = await loadConfig();
   const migrationStatus = await status(config);
   console.log(migrationStatus);
-}).help().strict().parse();
+}).demandCommand().help().parse();

package/dist/cli.mjs

@@ -5,11 +5,12 @@ import {
   init,
   status,
   up
-} from "./chunk-K5WX6ESL.mjs";
+} from "./chunk-Z3ZLNDVO.mjs";
 
 // src/cli.ts
 import fs from "node:fs/promises";
 import { join } from "node:path";
+import input from "@inquirer/input";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 var CONFIG_FILE = "./.spanner-migrate.config.json";
@@ -22,36 +23,34 @@ async function loadConfig() {
     process.exit(1);
   }
 }
-yargs(hideBin(process.argv)).scriptName("spanner-migrate").usage("$0 <command> [options]").command(
+yargs(hideBin(process.argv)).scriptName("spanner-migrate").usage("$0 <command>").command(
   "init",
   "Initialize a .spanner-migrate.config.json file",
-  (yargs2) => {
-    yargs2.option("migrationsPath", {
-      type: "string",
-      describe: "Path to the migrations folder",
-      default: "./spanner-migrations"
+  async () => {
+    const migrationsPath = await input({
+      message: "Enter the path for your migrations",
+      required: true,
+      default: "./migrations"
     });
-    yargs2.option("instanceName", {
-      type: "string",
-      describe: "Spanner instance name",
-      demandOption: true
+    const instanceName = await input({
+      message: "Enter Spanner instance name",
+      required: true
     });
-    yargs2.option("databaseName", {
-      type: "string",
-      describe: "Spanner database name",
-      demandOption: true
+    const databaseName = await input({
+      message: "Enter Spanner database name",
+      required: true
     });
-    yargs2.option("projectName", {
-      type: "string",
-      describe: "Google Cloud project name (optional)"
+    const projectId = await input({
+      message: "Enter Google Cloud project name",
+      required: false
     });
-  },
-  async (args) => {
-    await init(args, CONFIG_FILE);
+    const config = { instanceName, databaseName, migrationsPath };
+    if (projectId) config.projectId = projectId;
+    await init(config, CONFIG_FILE);
     console.log(`Configuration written to ${CONFIG_FILE}`);
   }
 ).command(
-  "create <description>",
+  "create <description ...>",
   "Create a new migration file",
   (yargs2) => {
     yargs2.positional("description", {
@@ -62,9 +61,10 @@ yargs(hideBin(process.argv)).scriptName("spanner-migrate").usage("$0 <command> [
   },
   async (args) => {
     const config = await loadConfig();
-    await create(config, args.description);
+    const fullDescription = args.description.join(" ");
+    await create(config, fullDescription);
     console.log(
-      `Migration file created: '${join(config.migrationsPath, args.description)}'`
+      `Migration file created: '${join(config.migrationsPath, args.description.join("_"))}.sql'`
     );
   }
 ).command(
@@ -91,4 +91,4 @@ yargs(hideBin(process.argv)).scriptName("spanner-migrate").usage("$0 <command> [
   const config = await loadConfig();
   const migrationStatus = await status(config);
   console.log(migrationStatus);
-}).help().strict().parse();
+}).demandCommand().help().parse();

package/dist/index.js

@@ -98,12 +98,11 @@ var runScript = async (db, script) => {
   }
   for (const statement of statements) {
     console.log(`Executing statement: ${statement}`);
-    const sql = statement.replace(/--.*$/gm, "");
-    if (isSchemaChange(sql)) {
-      await db.updateSchema(sql);
+    if (isSchemaChange(statement)) {
+      await db.updateSchema(statement);
     } else {
       await db.runTransactionAsync(async (transaction) => {
-        await transaction.runUpdate(sql);
+        await transaction.runUpdate(statement);
         await transaction.commit();
       });
     }
@@ -165,7 +164,7 @@ var import_node_path = require("path");
 var getMigrationFiles = async (path) => {
   try {
     const files = await (0, import_promises.readdir)(path);
-    const migrationFileIds = files.filter((file) => file.endsWith(".ts")).map((file) => file.replace(/\.ts$/, ""));
+    const migrationFileIds = files.filter((file) => file.endsWith(".sql")).map((file) => file.replace(/\.sql$/, ""));
     return migrationFileIds;
   } catch (error) {
     throw new Error(
@@ -175,31 +174,40 @@ var getMigrationFiles = async (path) => {
 };
 var getMigration = async (path, id) => {
   try {
-    const filePath = (0, import_node_path.resolve)(process.cwd(), (0, import_node_path.join)(path, `${id}.ts`));
+    const filePath = (0, import_node_path.resolve)(process.cwd(), (0, import_node_path.join)(path, `${id}.sql`));
     try {
       await (0, import_promises.access)(filePath);
     } catch (err) {
       throw new Error(`Migration file not found: ${filePath}`);
     }
-    const migrationModule = await import(filePath);
-    if (!migrationModule.up || !migrationModule.down) {
+    const migrationText = await (0, import_promises.readFile)(filePath, "utf8");
+    const up2 = getSql(migrationText, "up");
+    const down2 = getSql(migrationText, "down");
+    const description = getDescription(migrationText);
+    if (!up2 || !down2) {
       throw new Error(
         `Migration file ${filePath} does not export required scripts (up, down).`
       );
     }
-    return {
-      id,
-      description: id.split("_").slice(1).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" "),
-      // Generate a human-readable description
-      up: migrationModule.up,
-      down: migrationModule.down
-    };
+    return { id, description, up: up2, down: down2 };
   } catch (error) {
     throw new Error(
       `Failed to get migration ${id}: ${error.message}`
     );
   }
 };
+var getDescription = (text) => {
+  var _a, _b;
+  return ((_b = (_a = text == null ? void 0 : text.match(/^--\s*Description:\s*(.+)$/m)) == null ? void 0 : _a[1]) == null ? void 0 : _b.trim()) || "";
+};
+var getSql = (text, direction) => {
+  var _a, _b;
+  const rx = {
+    up: /---- UP ----\n([\s\S]*?)\n---- DOWN ----/,
+    down: /---- DOWN ----\n([\s\S]*)$/
+  };
+  return (_b = (_a = text == null ? void 0 : text.match(rx[direction])) == null ? void 0 : _a[1]) == null ? void 0 : _b.replace(/--.*$/gm, "").trim();
+};
 var getNewMigrations = (applied, files) => {
   const sortedFiles = files.sort();
   for (let ix = 0; ix < applied.length; ix++) {
@@ -218,18 +226,18 @@ var createMigration = async (path, description) => {
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   const compactTimestamp = timestamp.replace(/[-:.TZ]/g, "");
   const parsedDescription = description.replace(/\s+/g, "_").toLowerCase();
-  const filename = `${compactTimestamp}_${parsedDescription}.ts`;
+  const filename = `${compactTimestamp}_${parsedDescription}.sql`;
   const filePath = (0, import_node_path.join)(path, filename);
-  const template = `// ${timestamp}
-// ${description}
+  const template = `-- Created: ${timestamp}
+-- Description: ${description}
+
+---- UP ----
+
+
+
+---- DOWN ----
 
-export const up = \`
-  -- SQL for migrate up
-\`
 
-export const down = \`
-  -- SQL for migrate down
-\`
 `;
   try {
     await (0, import_promises.mkdir)(path, { recursive: true });

package/dist/index.mjs

@@ -4,7 +4,7 @@ import {
   init,
   status,
   up
-} from "./chunk-K5WX6ESL.mjs";
+} from "./chunk-Z3ZLNDVO.mjs";
 export {
   create,
   down,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sebspark/spanner-migrate",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "Apache-2.0",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -31,6 +31,7 @@
     "@google-cloud/spanner": "*"
   },
   "dependencies": {
+    "@inquirer/input": "4.1.3",
     "yargs": "17.7.2"
   }
 }