@ftschopp/dynatable-migrations 1.0.0

package/dist/core/tracker.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoDBMigrationTracker = void 0;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+class DynamoDBMigrationTracker {
+    constructor(client, config) {
+        this.client = client;
+        this.tableName = config.tableName;
+        this.trackingPrefix = config.trackingPrefix || '_SCHEMA#VERSION';
+        this.gsi1Name = config.gsi1Name || 'GSI1';
+    }
+    async initialize() {
+        // Check if current version pointer exists, if not create it
+        const current = await this.getCurrentVersion();
+        if (!current) {
+            // Create initial version pointer
+            await this.client.send(new lib_dynamodb_1.PutCommand({
+                TableName: this.tableName,
+                Item: {
+                    PK: `${this.trackingPrefix}#CURRENT`,
+                    SK: `${this.trackingPrefix}#CURRENT`,
+                    GSI1PK: 'SCHEMA#CURRENT',
+                    GSI1SK: 'v0000',
+                    currentVersion: 'v0000',
+                    updatedAt: new Date().toISOString(),
+                },
+            }));
+        }
+    }
+    async getAppliedMigrations() {
+        const result = await this.client.send(new lib_dynamodb_1.QueryCommand({
+            TableName: this.tableName,
+            KeyConditionExpression: 'PK = :pk',
+            ExpressionAttributeValues: {
+                ':pk': this.trackingPrefix,
+            },
+        }));
+        return (result.Items || []);
+    }
+    async getCurrentVersion() {
+        const result = await this.client.send(new lib_dynamodb_1.GetCommand({
+            TableName: this.tableName,
+            Key: {
+                PK: `${this.trackingPrefix}#CURRENT`,
+                SK: `${this.trackingPrefix}#CURRENT`,
+            },
+        }));
+        return result.Item?.currentVersion || null;
+    }
+    async markAsApplied(version, name, schemaDefinition, schemaChanges) {
+        const now = new Date().toISOString();
+        // Create migration record
+        await this.client.send(new lib_dynamodb_1.PutCommand({
+            TableName: this.tableName,
+            Item: {
+                PK: this.trackingPrefix,
+                SK: version,
+                version,
+                name,
+                timestamp: now,
+                appliedAt: now,
+                status: 'applied',
+                schemaDefinition,
+                schemaChanges,
+            },
+        }));
+        // Update current version pointer
+        await this.client.send(new lib_dynamodb_1.UpdateCommand({
+            TableName: this.tableName,
+            Key: {
+                PK: `${this.trackingPrefix}#CURRENT`,
+                SK: `${this.trackingPrefix}#CURRENT`,
+            },
+            UpdateExpression: 'SET currentVersion = :version, updatedAt = :updatedAt, GSI1SK = :gsi1sk',
+            ExpressionAttributeValues: {
+                ':version': version,
+                ':updatedAt': now,
+                ':gsi1sk': version,
+            },
+        }));
+    }
+    async markAsRolledBack(version) {
+        await this.client.send(new lib_dynamodb_1.UpdateCommand({
+            TableName: this.tableName,
+            Key: {
+                PK: this.trackingPrefix,
+                SK: version,
+            },
+            UpdateExpression: 'SET #status = :status, rolledBackAt = :timestamp',
+            ExpressionAttributeNames: {
+                '#status': 'status',
+            },
+            ExpressionAttributeValues: {
+                ':status': 'rolled_back',
+                ':timestamp': new Date().toISOString(),
+            },
+        }));
+        // Find previous version and update current pointer
+        const migrations = await this.getAppliedMigrations();
+        const appliedMigrations = migrations
+            .filter((m) => m.status === 'applied' && m.version !== version)
+            .sort((a, b) => b.version.localeCompare(a.version));
+        const previousVersion = appliedMigrations[0]?.version || 'v0000';
+        await this.client.send(new lib_dynamodb_1.UpdateCommand({
+            TableName: this.tableName,
+            Key: {
+                PK: `${this.trackingPrefix}#CURRENT`,
+                SK: `${this.trackingPrefix}#CURRENT`,
+            },
+            UpdateExpression: 'SET currentVersion = :version, updatedAt = :updatedAt, GSI1SK = :gsi1sk',
+            ExpressionAttributeValues: {
+                ':version': previousVersion,
+                ':updatedAt': new Date().toISOString(),
+                ':gsi1sk': previousVersion,
+            },
+        }));
+    }
+    async markAsFailed(version, error) {
+        await this.client.send(new lib_dynamodb_1.UpdateCommand({
+            TableName: this.tableName,
+            Key: {
+                PK: this.trackingPrefix,
+                SK: version,
+            },
+            UpdateExpression: 'SET #status = :status, #error = :error, failedAt = :timestamp',
+            ExpressionAttributeNames: {
+                '#status': 'status',
+                '#error': 'error',
+            },
+            ExpressionAttributeValues: {
+                ':status': 'failed',
+                ':error': error,
+                ':timestamp': new Date().toISOString(),
+            },
+        }));
+    }
+    async recordSchemaChange(change) {
+        const currentVersion = await this.getCurrentVersion();
+        if (!currentVersion || currentVersion === 'v0000') {
+            throw new Error('Cannot record schema change: No migration has been applied yet');
+        }
+        // Append to schemaChanges array
+        await this.client.send(new lib_dynamodb_1.UpdateCommand({
+            TableName: this.tableName,
+            Key: {
+                PK: this.trackingPrefix,
+                SK: currentVersion,
+            },
+            UpdateExpression: 'SET schemaChanges = list_append(if_not_exists(schemaChanges, :empty_list), :change)',
+            ExpressionAttributeValues: {
+                ':empty_list': [],
+                ':change': [change],
+            },
+        }));
+    }
+    async getMigration(version) {
+        const result = await this.client.send(new lib_dynamodb_1.GetCommand({
+            TableName: this.tableName,
+            Key: {
+                PK: this.trackingPrefix,
+                SK: version,
+            },
+        }));
+        return result.Item || null;
+    }
+    async isApplied(version) {
+        const migration = await this.getMigration(version);
+        return migration?.status === 'applied';
+    }
+}
+exports.DynamoDBMigrationTracker = DynamoDBMigrationTracker;
+//# sourceMappingURL=tracker.js.map

package/dist/core/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../../src/core/tracker.ts"],"names":[],"mappings":";;;AACA,wDAA4F;AAG5F,MAAa,wBAAwB;IAMnC,YAAY,MAA8B,EAAE,MAAuB;QACjE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,iBAAiB,CAAC;QACjE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,4DAA4D;QAC5D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,iCAAiC;YACjC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,yBAAU,CAAC;gBACb,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE;oBACJ,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,UAAU;oBACpC,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,UAAU;oBACpC,MAAM,EAAE,gBAAgB;oBACxB,MAAM,EAAE,OAAO;oBACf,cAAc,EAAE,OAAO;oBACvB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,oBAAoB;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACnC,IAAI,2BAAY,CAAC;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,sBAAsB,EAAE,UAAU;YAClC,yBAAyB,EAAE;gBACzB,KAAK,EAAE,IAAI,CAAC,cAAc;aAC3B;SACF,CAAC,CACH,CAAC;QAEF,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAsB,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACnC,IAAI,yBAAU,CAAC;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE;gBACH,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,UAAU;gBACpC,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,UAAU;aACrC;SACF,CAAC,CACH,CAAC;QAEF,OAAO,MAAM,CAAC,IAAI,EAAE,cAAc,IAAI,IAAI,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,OAAe,EACf,IAAY,EACZ,gBAAsC,EACtC,aAA8B;QAE9B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,0BAA0B;QAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,yBAAU,CAAC;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE;gBACJ,EAAE,EAAE,IAAI,CAAC,cAAc;gBACvB,EAAE,EAAE,OAAO;gBACX,OAAO;gBACP,IAAI;gBACJ,SAAS,EAAE,GAAG;gBACd,SAAS,EAAE,GAAG;gBACd,MAAM,EAAE,SAAS;gBACjB,gBAAgB;gBAChB,aAAa;aACK;SACrB,CAAC,CACH,CAAC;QAEF,iCAAiC;QACjC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,4BAAa,CAAC;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE;gBACH,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,UAAU;gBACpC,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,UAAU;aACrC;YACD,gBAAgB,EAAE,yEAAyE;YAC3F,yBAAyB,EAAE;gBACzB,UAAU,EAAE,OAAO;gBACnB,YAAY,EAAE,GAAG;gBACjB,SAAS,EAAE,OAAO;aACnB;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,4BAAa,CAAC;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE;gBACH,EAAE,EAAE,IAAI,CAAC,cAAc;gBACvB,EAAE,EAAE,OAAO;aACZ;YACD,gBAAgB,EAAE,kDAAkD;YACpE,wBAAwB,EAAE;gBACxB,SAAS,EAAE,QAAQ;aACpB;YACD,yBAAyB,EAAE;gBACzB,SAAS,EAAE,aAAa;gBACxB,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACvC;SACF,CAAC,CACH,CAAC;QAEF,mDAAmD;QACnD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACrD,MAAM,iBAAiB,GAAG,UAAU;aACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC;aAC9D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAEtD,MAAM,eAAe,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC;QAEjE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,4BAAa,CAAC;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE;gBACH,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,UAAU;gBACpC,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,UAAU;aACrC;YACD,gBAAgB,EAAE,yEAAyE;YAC3F,yBAAyB,EAAE;gBACzB,UAAU,EAAE,eAAe;gBAC3B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACtC,SAAS,EAAE,eAAe;aAC3B;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,KAAa;QAC/C,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,4BAAa,CAAC;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE;gBACH,EAAE,EAAE,IAAI,CAAC,cAAc;gBACvB,EAAE,EAAE,OAAO;aACZ;YACD,gBAAgB,EAAE,+DAA+D;YACjF,wBAAwB,EAAE;gBACxB,SAAS,EAAE,QAAQ;gBACnB,QAAQ,EAAE,OAAO;aAClB;YACD,yBAAyB,EAAE;gBACzB,SAAS,EAAE,QAAQ;gBACnB,QAAQ,EAAE,KAAK;gBACf,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACvC;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,MAAoB;QAC3C,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACtD,IAAI,CAAC,cAAc,IAAI,cAAc,KAAK,OAAO,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QAED,gCAAgC;QAChC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,IAAI,4BAAa,CAAC;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE;gBACH,EAAE,EAAE,IAAI,CAAC,cAAc;gBACvB,EAAE,EAAE,cAAc;aACnB;YACD,gBAAgB,EACd,qFAAqF;YACvF,yBAAyB,EAAE;gBACzB,aAAa,EAAE,EAAE;gBACjB,SAAS,EAAE,CAAC,MAAM,CAAC;aACpB;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACnC,IAAI,yBAAU,CAAC;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE;gBACH,EAAE,EAAE,IAAI,CAAC,cAAc;gBACvB,EAAE,EAAE,OAAO;aACZ;SACF,CAAC,CACH,CAAC;QAEF,OAAQ,MAAM,CAAC,IAAwB,IAAI,IAAI,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACnD,OAAO,SAAS,EAAE,MAAM,KAAK,SAAS,CAAC;IACzC,CAAC;CACF;AAtND,4DAsNC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @ftschopp/dynatable-migrations
+ * DynamoDB migration tool for single table design with schema versioning
+ */
+export * from './types';
+export { DynamoDBMigrationTracker } from './core/tracker';
+export { MigrationLoader } from './core/loader';
+export { MigrationRunner } from './core/runner';
+export { ConfigLoader, loadConfig } from './core/config';
+export { generateMigrationTemplate } from './templates/migration';
+export { createMigration } from './commands/create';
+export { runMigrations } from './commands/up';
+export { rollbackMigrations } from './commands/down';
+export { showStatus } from './commands/status';
+export { initProject } from './commands/init';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * @ftschopp/dynatable-migrations
+ * DynamoDB migration tool for single table design with schema versioning
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initProject = exports.showStatus = exports.rollbackMigrations = exports.runMigrations = exports.createMigration = exports.generateMigrationTemplate = exports.loadConfig = exports.ConfigLoader = exports.MigrationRunner = exports.MigrationLoader = exports.DynamoDBMigrationTracker = void 0;
+// Types
+__exportStar(require("./types"), exports);
+// Core
+var tracker_1 = require("./core/tracker");
+Object.defineProperty(exports, "DynamoDBMigrationTracker", { enumerable: true, get: function () { return tracker_1.DynamoDBMigrationTracker; } });
+var loader_1 = require("./core/loader");
+Object.defineProperty(exports, "MigrationLoader", { enumerable: true, get: function () { return loader_1.MigrationLoader; } });
+var runner_1 = require("./core/runner");
+Object.defineProperty(exports, "MigrationRunner", { enumerable: true, get: function () { return runner_1.MigrationRunner; } });
+var config_1 = require("./core/config");
+Object.defineProperty(exports, "ConfigLoader", { enumerable: true, get: function () { return config_1.ConfigLoader; } });
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+// Template
+var migration_1 = require("./templates/migration");
+Object.defineProperty(exports, "generateMigrationTemplate", { enumerable: true, get: function () { return migration_1.generateMigrationTemplate; } });
+// Commands (for programmatic use)
+var create_1 = require("./commands/create");
+Object.defineProperty(exports, "createMigration", { enumerable: true, get: function () { return create_1.createMigration; } });
+var up_1 = require("./commands/up");
+Object.defineProperty(exports, "runMigrations", { enumerable: true, get: function () { return up_1.runMigrations; } });
+var down_1 = require("./commands/down");
+Object.defineProperty(exports, "rollbackMigrations", { enumerable: true, get: function () { return down_1.rollbackMigrations; } });
+var status_1 = require("./commands/status");
+Object.defineProperty(exports, "showStatus", { enumerable: true, get: function () { return status_1.showStatus; } });
+var init_1 = require("./commands/init");
+Object.defineProperty(exports, "initProject", { enumerable: true, get: function () { return init_1.initProject; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,QAAQ;AACR,0CAAwB;AAExB,OAAO;AACP,0CAA0D;AAAjD,mHAAA,wBAAwB,OAAA;AACjC,wCAAgD;AAAvC,yGAAA,eAAe,OAAA;AACxB,wCAAgD;AAAvC,yGAAA,eAAe,OAAA;AACxB,wCAAyD;AAAhD,sGAAA,YAAY,OAAA;AAAE,oGAAA,UAAU,OAAA;AAEjC,WAAW;AACX,mDAAkE;AAAzD,sHAAA,yBAAyB,OAAA;AAElC,kCAAkC;AAClC,4CAAoD;AAA3C,yGAAA,eAAe,OAAA;AACxB,oCAA8C;AAArC,mGAAA,aAAa,OAAA;AACtB,wCAAqD;AAA5C,0GAAA,kBAAkB,OAAA;AAC3B,4CAA+C;AAAtC,oGAAA,UAAU,OAAA;AACnB,wCAA8C;AAArC,mGAAA,WAAW,OAAA"}

package/dist/templates/migration.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Migration template generator
+ */
+export declare function generateMigrationTemplate(version: string, name: string): string;
+//# sourceMappingURL=migration.d.ts.map

package/dist/templates/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/templates/migration.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAwF/E"}

package/dist/templates/migration.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateMigrationTemplate = generateMigrationTemplate;
+/**
+ * Migration template generator
+ */
+function generateMigrationTemplate(version, name) {
+    return `import { Migration } from "@ftschopp/dynatable-migrations";
+
+/**
+ * Migration: ${name}
+ * Version: ${version}
+ *
+ * Description:
+ * Add description of what this migration does here.
+ *
+ * Version type:
+ * - MAJOR (X.0.0): Breaking changes, incompatible schema changes
+ * - MINOR (0.X.0): New features, backwards-compatible changes
+ * - PATCH (0.0.X): Bug fixes, data corrections
+ */
+export const migration: Migration = {
+  version: "${version}",
+  name: "${name}",
+  description: "Add description here",
+
+  /**
+   * Schema snapshot (optional)
+   * Document your schema changes here for reference
+   */
+  schema: {
+    // Example:
+    // User: {
+    //   attributes: {
+    //     username: { type: String, required: true },
+    //     email: { type: String, required: false },
+    //   }
+    // }
+  },
+
+  /**
+   * Apply migration
+   */
+  async up({ client, tableName, dynamodb }) {
+    console.log("Running migration: ${name}");
+
+    // Example: Add a new attribute to existing items
+    // const { ScanCommand, UpdateCommand } = dynamodb;
+    //
+    // const result = await client.send(new ScanCommand({
+    //   TableName: tableName,
+    //   FilterExpression: "begins_with(PK, :pk)",
+    //   ExpressionAttributeValues: { ":pk": "USER#" }
+    // }));
+    //
+    // for (const item of result.Items || []) {
+    //   await client.send(new UpdateCommand({
+    //     TableName: tableName,
+    //     Key: { PK: item.PK, SK: item.SK },
+    //     UpdateExpression: "SET emailVerified = :value",
+    //     ExpressionAttributeValues: { ":value": false }
+    //   }));
+    // }
+
+    console.log("✅ Migration completed");
+  },
+
+  /**
+   * Rollback migration
+   */
+  async down({ client, tableName, dynamodb }) {
+    console.log("Rolling back migration: ${name}");
+
+    // Example: Remove the attribute added in up()
+    // const { ScanCommand, UpdateCommand } = dynamodb;
+    //
+    // const result = await client.send(new ScanCommand({
+    //   TableName: tableName,
+    //   FilterExpression: "begins_with(PK, :pk)",
+    //   ExpressionAttributeValues: { ":pk": "USER#" }
+    // }));
+    //
+    // for (const item of result.Items || []) {
+    //   await client.send(new UpdateCommand({
+    //     TableName: tableName,
+    //     Key: { PK: item.PK, SK: item.SK },
+    //     UpdateExpression: "REMOVE email, emailVerified"
+    //   }));
+    // }
+
+    console.log("✅ Rollback completed");
+  },
+};
+`;
+}
+//# sourceMappingURL=migration.js.map

package/dist/templates/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../../src/templates/migration.ts"],"names":[],"mappings":";;AAGA,8DAwFC;AA3FD;;GAEG;AACH,SAAgB,yBAAyB,CAAC,OAAe,EAAE,IAAY;IACrE,OAAO;;;gBAGO,IAAI;cACN,OAAO;;;;;;;;;;;cAWP,OAAO;WACV,IAAI;;;;;;;;;;;;;;;;;;;;;sCAqBuB,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;2CA2BC,IAAI;;;;;;;;;;;;;;;;;;;;;;CAsB9C,CAAC;AACF,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,159 @@
+import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
+import type { ScanCommand, QueryCommand, GetCommand, PutCommand, UpdateCommand, DeleteCommand, BatchGetCommand, BatchWriteCommand, TransactWriteCommand, TransactGetCommand } from '@aws-sdk/lib-dynamodb';
+/**
+ * DynamoDB commands available in migrations
+ */
+export interface DynamoDBCommands {
+    ScanCommand: typeof ScanCommand;
+    QueryCommand: typeof QueryCommand;
+    GetCommand: typeof GetCommand;
+    PutCommand: typeof PutCommand;
+    UpdateCommand: typeof UpdateCommand;
+    DeleteCommand: typeof DeleteCommand;
+    BatchGetCommand: typeof BatchGetCommand;
+    BatchWriteCommand: typeof BatchWriteCommand;
+    TransactWriteCommand: typeof TransactWriteCommand;
+    TransactGetCommand: typeof TransactGetCommand;
+}
+/**
+ * Migration context provided to up/down functions
+ */
+export interface MigrationContext {
+    client: DynamoDBDocumentClient;
+    tableName: string;
+    tracker: MigrationTracker;
+    config: MigrationConfig;
+    dynamodb: DynamoDBCommands;
+}
+/**
+ * Schema change record for tracking evolution
+ */
+export interface SchemaChange {
+    entity: string;
+    changes: {
+        added?: string[];
+        removed?: string[];
+        modified?: Array<{
+            field: string;
+            from: any;
+            to: any;
+        }>;
+    };
+}
+/**
+ * Migration definition
+ */
+export interface Migration {
+    version: string;
+    name: string;
+    description?: string;
+    schema?: Record<string, any>;
+    up: (context: MigrationContext) => Promise<void>;
+    down: (context: MigrationContext) => Promise<void>;
+}
+/**
+ * Migration record stored in DynamoDB
+ */
+export interface MigrationRecord {
+    PK: string;
+    SK: string;
+    version: string;
+    name: string;
+    description?: string;
+    timestamp: string;
+    appliedAt: string;
+    status: 'applied' | 'rolled_back' | 'failed';
+    schemaDefinition?: Record<string, any>;
+    schemaChanges?: SchemaChange[];
+    checksum?: string;
+    error?: string;
+}
+/**
+ * Current schema pointer record
+ */
+export interface CurrentSchemaRecord {
+    GSI1PK: string;
+    GSI1SK: string;
+    PK: string;
+    SK: string;
+    currentVersion: string;
+    updatedAt: string;
+}
+/**
+ * Migration configuration
+ */
+export interface MigrationConfig {
+    tableName: string;
+    client: {
+        endpoint?: string;
+        region: string;
+        credentials?: {
+            accessKeyId: string;
+            secretAccessKey: string;
+        };
+    };
+    migrationsDir?: string;
+    trackingPrefix?: string;
+    gsi1Name?: string;
+}
+/**
+ * Migration tracker interface
+ */
+export interface MigrationTracker {
+    /**
+     * Initialize migration tracking table/items if needed
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get all applied migrations
+     */
+    getAppliedMigrations(): Promise<MigrationRecord[]>;
+    /**
+     * Get current schema version
+     */
+    getCurrentVersion(): Promise<string | null>;
+    /**
+     * Mark migration as applied
+     */
+    markAsApplied(version: string, name: string, schemaDefinition?: Record<string, any>, schemaChanges?: SchemaChange[]): Promise<void>;
+    /**
+     * Mark migration as rolled back
+     */
+    markAsRolledBack(version: string): Promise<void>;
+    /**
+     * Mark migration as failed
+     */
+    markAsFailed(version: string, error: string): Promise<void>;
+    /**
+     * Record schema changes
+     */
+    recordSchemaChange(change: SchemaChange): Promise<void>;
+    /**
+     * Get migration by version
+     */
+    getMigration(version: string): Promise<MigrationRecord | null>;
+    /**
+     * Check if migration was applied
+     */
+    isApplied(version: string): Promise<boolean>;
+}
+/**
+ * Migration file info
+ */
+export interface MigrationFile {
+    version: string;
+    name: string;
+    filePath: string;
+    migration: Migration;
+}
+/**
+ * Migration status
+ */
+export interface MigrationStatus {
+    version: string;
+    name: string;
+    status: 'pending' | 'applied' | 'rolled_back' | 'failed';
+    appliedAt?: string;
+    error?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@ftschopp/dynatable-migrations",
+  "version": "1.0.0",
+  "description": "DynamoDB migration tool for single table design with schema versioning",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "dynatable-migrate": "./bin/dynatable-migrate.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
+    "test": "echo \"No tests yet!\""
+  },
+  "keywords": [
+    "dynamodb",
+    "migrations",
+    "single-table-design",
+    "schema-versioning",
+    "cli"
+  ],
+  "devDependencies": {
+    "@repo/eslint-config": "*",
+    "@repo/typescript-config": "*",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.3",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "5.9.3"
+  },
+  "dependencies": {
+    "@aws-sdk/client-dynamodb": "^3.965.0",
+    "@aws-sdk/lib-dynamodb": "^3.965.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "ora": "^9.0.0",
+    "ts-node": "^10.9.2"
+  }
+}