@datacapy/migrate 0.1.0 → 0.1.1

package/README.md

@@ -1,10 +1,12 @@
 # @datacapy/migrate
 
+Part of the [DataCapy monorepo](https://github.com/datacapy/datacapy).
+
 Database migration tool for @datacapy/om applications. Manage schema changes, data transformations, and database versioning across multiple datasources with transaction safety and rollback support.
 
 ## Features
 
-- **Multi-Datasource Support**: Migrate account-level databases, project-specific databases, or any custom datasource
+- **Multi-Datasource Support**: Migrate main databases, workspace-specific databases, or any custom datasource
 - **Transaction Safety**: Each patch runs in a transaction with automatic rollback on failure
 - **Version Tracking**: Track applied migrations in a metadata table
 - **Dry Run Mode**: Preview changes without applying them
@@ -66,7 +68,7 @@ export default class AddUsersTable implements DatabasePatchInterface {
 ### 3. Run Migration
 
 ```bash
-# Migrate account-level database
+# Migrate main database
 pnpm @datacapy/migrate --config ./migrate.config.js --datasource db
 
 # Preview changes first
@@ -87,7 +89,7 @@ pnpm @datacapy/migrate --config ./migrate.config.js --datasource db --verbose
 ### Required Options
 
 - `-c, --config <file>` - Path to migration config file
-- `--datasource <name>` - Target datasource name (e.g., 'db', 'project')
+- `--datasource <name>` - Target datasource name (e.g., 'db', 'workspace')
 
 ### Optional Options
 
@@ -102,13 +104,13 @@ pnpm @datacapy/migrate --config ./migrate.config.js --datasource db --verbose
 ### Examples
 
 ```bash
-# Migrate account-level database
+# Migrate main database
 pnpm @datacapy/migrate --config ./migrate.config.js --datasource db
 
-# Migrate specific project database (dynamic datasource)
+# Migrate specific workspace database (dynamic datasource)
 pnpm @datacapy/migrate --config ./migrate.config.js \\
-  --datasource project \\
-  --context projectId=abc123
+  --datasource workspace \\
+  --context workspaceId=abc123
 
 # Dry run to preview changes
 pnpm @datacapy/migrate --config ./migrate.config.js --datasource db --dry-run
@@ -163,7 +165,7 @@ All patches must implement `DatabasePatchInterface`:
 export interface DatabasePatchInterface {
   version: string; // Format: YYYY-MM-DD_HHMM
   description: string; // Human-readable description
-  dataSourceName: string; // Target datasource: 'db', 'project', etc.
+  dataSourceName: string; // Target datasource: 'db', 'workspace', etc.
   update(modelManager: ModelManager): Promise<void>;
 }
 ```
@@ -272,20 +274,20 @@ export default class SeedDefaultRoles implements DatabasePatchInterface {
 }
 ```
 
-#### Project-Specific Migration
+#### Workspace-Specific Migration
 
 ```typescript
-export default class AddProjectStatus implements DatabasePatchInterface {
+export default class AddWorkspaceStatus implements DatabasePatchInterface {
   version = "2024-02-08_1000";
   description = "Add status field to surveys";
-  dataSourceName = "project"; // Targets dynamic project datasource
+  dataSourceName = "workspace"; // Targets dynamic workspace datasource
 
   async update(modelManager: ModelManager): Promise<void> {
-    // Get project datasource (resolved via CLI --context)
-    const projectDS = modelManager.getDataSource("project");
+    // Get workspace datasource (resolved via CLI --context)
+    const workspaceDS = modelManager.getDataSource("workspace");
 
-    // Update all surveys in this project
-    await projectDS.updateMany(
+    // Update all surveys in this workspace
+    await workspaceDS.updateMany(
       "surveys",
       {},
       {
@@ -300,33 +302,33 @@ export default class AddProjectStatus implements DatabasePatchInterface {
 
 @datacapy/migrate supports migrating multiple datasources independently:
 
-### Account-Level Migrations
+### Main-Database Migrations
 
-Migrate the main account database:
+Migrate the main database:
 
 ```bash
 pnpm @datacapy/migrate --config ./migrate.config.js --datasource db
 ```
 
-### Project-Level Migrations
+### Workspace-Level Migrations
 
-Migrate a specific project's database:
+Migrate a specific workspace's database:
 
 ```bash
 pnpm @datacapy/migrate --config ./migrate.config.js \\
-  --datasource project \\
-  --context projectId=abc123
+  --datasource workspace \\
+  --context workspaceId=abc123
 ```
 
-### Migrating Multiple Projects
+### Migrating Multiple Workspaces
 
 ```bash
-# Get all project IDs, then migrate each
-for projectId in $(get-project-ids); do
-  echo "Migrating project $projectId..."
+# Get all workspace IDs, then migrate each
+for workspaceId in $(get-workspace-ids); do
+  echo "Migrating workspace $workspaceId..."
   pnpm @datacapy/migrate --config ./migrate.config.js \\
-    --datasource project \\
-    --context projectId=$projectId
+    --datasource workspace \\
+    --context workspaceId=$workspaceId
 done
 ```
 
@@ -562,14 +564,14 @@ export default class SeedData implements DatabasePatchInterface {
 
 ### Migration Fails with "Datasource not found"
 
-**Problem:** Cannot find datasource 'project'
+**Problem:** Cannot find datasource 'workspace'
 
 **Solution:** Dynamic datasources need context:
 
 ```bash
 pnpm @datacapy/migrate --config ./migrate.config.js \\
-  --datasource project \\
-  --context projectId=abc123
+  --datasource workspace \\
+  --context workspaceId=abc123
 ```
 
 ### Patch Throws "Duplicate key error"

package/dist/cli/command-parser.js

@@ -83,13 +83,13 @@ USAGE:
 
 REQUIRED OPTIONS:
   -c, --config <file>        Path to migration config file
-  --datasource <name>        Target datasource name (e.g., 'db', 'project')
+  --datasource <name>        Target datasource name (e.g., 'db', 'workspace')
 
 OPTIONAL OPTIONS:
   --context <key=value>      Context for dynamic datasources (can be specified multiple times)
-                             Example: --context projectId=abc123
+                             Example: --context workspaceId=abc123
   --context-lookup <pattern> Lookup pattern for batch migrations across multiple contexts
-                             Example: --context-lookup "*" (migrate all projects)
+                             Example: --context-lookup "*" (migrate all workspaces)
                              Requires contextResolver to be configured
   -d, --patch-dir <dir>      Patch directory (default: ./migrate)
   -t, --target <version>     Target version to migrate to (default: latest)
@@ -100,14 +100,14 @@ OPTIONAL OPTIONS:
   --version                  Show package version
 
 EXAMPLES:
-  # Migrate account-level database
+  # Migrate main database
   @datacapy/migrate --config ./migrate.config.js --datasource db
 
-  # Migrate specific project database
-  @datacapy/migrate --config ./migrate.config.js --datasource project --context projectId=abc123
+  # Migrate specific workspace database
+  @datacapy/migrate --config ./migrate.config.js --datasource workspace --context workspaceId=abc123
 
-  # Migrate ALL project databases (batch migration)
-  @datacapy/migrate --config ./migrate.config.js --datasource project --context-lookup "*"
+  # Migrate ALL workspace databases (batch migration)
+  @datacapy/migrate --config ./migrate.config.js --datasource workspace --context-lookup "*"
 
   # Dry run to preview changes
   @datacapy/migrate --config ./migrate.config.js --datasource db --dry-run

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-export { MigrationManager } from "./manager/migration-manager.js";
-export { VersionManager } from "./version/version-manager.js";
-export { MetaTable, MetaRecord } from "./meta/meta-table.js";
-export { PatchScanner } from "./scanner/patch-scanner.js";
-export { PatchExecutor } from "./executor/patch-executor.js";
-export { MigrationLogger } from "./logger/migration-logger.js";
-export { DatabasePatchInterface } from "./interface/database-patch.js";
-export { ContextResolver } from "./interface/context-resolver.js";
-export { MigrationConfig, MigrationConfigResolved, } from "./interface/migration-config.js";
-export { MigrationResult, PatchResult, PatchFile, } from "./interface/migration-result.js";
-export { CommandParser, CliArguments } from "./cli/command-parser.js";
-export { CliRunner } from "./cli/runner.js";
+export { MigrationManager } from "./manager/migration-manager";
+export { VersionManager } from "./version/version-manager";
+export { MetaTable, MetaRecord } from "./meta/meta-table";
+export { PatchScanner } from "./scanner/patch-scanner";
+export { PatchExecutor } from "./executor/patch-executor";
+export { MigrationLogger } from "./logger/migration-logger";
+export { DatabasePatchInterface } from "./interface/database-patch";
+export { ContextResolver } from "./interface/context-resolver";
+export { MigrationConfig, MigrationConfigResolved, } from "./interface/migration-config";
+export { MigrationResult, PatchResult, PatchFile, } from "./interface/migration-result";
+export { CommandParser, CliArguments } from "./cli/command-parser";
+export { CliRunner } from "./cli/runner";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,20 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliRunner = exports.CommandParser = exports.MigrationLogger = exports.PatchExecutor = exports.PatchScanner = exports.MetaTable = exports.VersionManager = exports.MigrationManager = void 0;
-var migration_manager_1 = require("./manager/migration-manager.js");
+var migration_manager_1 = require("./manager/migration-manager");
 Object.defineProperty(exports, "MigrationManager", { enumerable: true, get: function () { return migration_manager_1.MigrationManager; } });
-var version_manager_1 = require("./version/version-manager.js");
+var version_manager_1 = require("./version/version-manager");
 Object.defineProperty(exports, "VersionManager", { enumerable: true, get: function () { return version_manager_1.VersionManager; } });
-var meta_table_1 = require("./meta/meta-table.js");
+var meta_table_1 = require("./meta/meta-table");
 Object.defineProperty(exports, "MetaTable", { enumerable: true, get: function () { return meta_table_1.MetaTable; } });
-var patch_scanner_1 = require("./scanner/patch-scanner.js");
+var patch_scanner_1 = require("./scanner/patch-scanner");
 Object.defineProperty(exports, "PatchScanner", { enumerable: true, get: function () { return patch_scanner_1.PatchScanner; } });
-var patch_executor_1 = require("./executor/patch-executor.js");
+var patch_executor_1 = require("./executor/patch-executor");
 Object.defineProperty(exports, "PatchExecutor", { enumerable: true, get: function () { return patch_executor_1.PatchExecutor; } });
-var migration_logger_1 = require("./logger/migration-logger.js");
+var migration_logger_1 = require("./logger/migration-logger");
 Object.defineProperty(exports, "MigrationLogger", { enumerable: true, get: function () { return migration_logger_1.MigrationLogger; } });
-var command_parser_1 = require("./cli/command-parser.js");
+var command_parser_1 = require("./cli/command-parser");
 Object.defineProperty(exports, "CommandParser", { enumerable: true, get: function () { return command_parser_1.CommandParser; } });
-var runner_1 = require("./cli/runner.js");
+var runner_1 = require("./cli/runner");
 Object.defineProperty(exports, "CliRunner", { enumerable: true, get: function () { return runner_1.CliRunner; } });
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@datacapy/migrate",
   "type": "commonjs",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Datacapy migrate: database migration runner",
   "main": "./dist/index",
   "types": "./dist/index.d.ts",
@@ -21,16 +21,16 @@
   },
   "dependencies": {
     "@datacapy/id": "0.1.0",
-    "@datacapy/om": "0.1.0"
+    "@datacapy/om": "0.2.0"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
-    "@types/node": "^25.9.8",
+    "@types/node": "^26.6.4",
     "jest": "^30.5.2",
     "prettier": "^3.9.9",
     "ts-jest": "^29.4.14",
     "ts-node": "^10.9.2",
-    "tsc-alias": "1.9.5",
+    "tsc-alias": "1.9.1",
     "typescript": "^6.0.3"
   },
   "files": [