@famgia/omnify-atlas 0.0.97 → 0.0.99

package/dist/index.d.cts

@@ -26,6 +26,14 @@ interface PropertySnapshot {
     readonly onUpdate?: string | undefined;
     readonly mappedBy?: string | undefined;
     readonly joinTable?: string | undefined;
+    /** Pivot table fields for ManyToMany relationships */
+    readonly pivotFields?: Record<string, {
+        type: string;
+        nullable?: boolean;
+        default?: unknown;
+        length?: number;
+        unsigned?: boolean;
+    }> | undefined;
     readonly renamedFrom?: string | undefined;
     /** Laravel: hidden in serialization */
     readonly hidden?: boolean | undefined;
@@ -92,17 +100,42 @@ interface SchemaHash {
 }
 /**
  * Generated migration record.
+ * Enhanced for team development with file tracking and regeneration support.
+ * Note: timestamp, tableName, type are optional for backwards compatibility with v1 lock files.
  */
 interface GeneratedMigration {
-    /** Migration file name */
+    /** Migration file name (e.g., "2026_01_13_100000_create_users_table.php") */
     readonly fileName: string;
-    /** Timestamp when generated */
+    /** Migration timestamp prefix for regeneration (e.g., "2026_01_13_100000") - Optional for backwards compatibility */
+    readonly timestamp?: string | undefined;
+    /** Table name for lookup (e.g., "users") - Optional for backwards compatibility */
+    readonly tableName?: string | undefined;
+    /** Migration type - Optional for backwards compatibility */
+    readonly type?: 'create' | 'alter' | 'drop' | 'pivot' | undefined;
+    /** Timestamp when generated (ISO 8601) */
     readonly generatedAt: string;
     /** Schemas involved in this migration */
     readonly schemas: readonly string[];
-    /** Migration checksum for integrity */
+    /** Migration content checksum (SHA-256) for integrity verification */
     readonly checksum: string;
 }
+/**
+ * Migration validation result.
+ */
+interface MigrationValidation {
+    /** Whether all migrations are valid */
+    readonly valid: boolean;
+    /** List of missing migration files */
+    readonly missingFiles: readonly string[];
+    /** List of migrations with checksum mismatch (file modified) */
+    readonly modifiedFiles: readonly string[];
+    /** List of stale migrations (old timestamp, recently added to repo) */
+    readonly staleFiles: readonly string[];
+    /** Total migrations tracked */
+    readonly totalTracked: number;
+    /** Total migrations found on disk */
+    readonly totalOnDisk: number;
+}
 /**
  * Lock file structure for tracking schema state (v1 - legacy).
  */
@@ -213,12 +246,6 @@ interface LockFileComparison {
     readonly unchanged: readonly string[];
 }
 
-/**
- * @famgia/omnify-atlas - Lock File Management
- *
- * Manages the .omnify.lock file for tracking schema state.
- */
-
 /**
  * Default lock file name.
  */
@@ -297,6 +324,49 @@ declare function updateLockFileV1(existingLockFile: LockFile | null, currentHash
  * Adds a migration record to the lock file.
  */
 declare function addMigrationRecord(lockFile: LockFile, fileName: string, schemas: readonly string[], migrationContent: string): LockFile;
+/**
+ * Adds an enhanced migration record to the lock file.
+ * Includes timestamp and tableName for regeneration support.
+ */
+declare function addEnhancedMigrationRecord(lockFile: LockFile, options: {
+    fileName: string;
+    timestamp: string;
+    tableName: string;
+    type: 'create' | 'alter' | 'drop' | 'pivot';
+    schemas: readonly string[];
+    content: string;
+}): LockFile;
+/**
+ * Extracts timestamp from migration filename.
+ * @example "2026_01_13_100000_create_users_table.php" → "2026_01_13_100000"
+ */
+declare function extractTimestampFromFilename(fileName: string): string | null;
+/**
+ * Extracts table name from migration filename.
+ * @example "2026_01_13_100000_create_users_table.php" → "users"
+ */
+declare function extractTableNameFromFilename(fileName: string): string | null;
+/**
+ * Validates migration files against lock file records.
+ * Checks for missing files, modified files, and stale migrations.
+ */
+declare function validateMigrations(lockFile: LockFile, migrationsDir: string): Promise<MigrationValidation>;
+/**
+ * Finds migration record by table name.
+ * Useful for regenerating deleted migrations.
+ */
+declare function findMigrationByTable(lockFile: LockFile, tableName: string, type?: 'create' | 'alter' | 'drop' | 'pivot'): GeneratedMigration | undefined;
+/**
+ * Gets migrations that need to be regenerated (missing files).
+ * Returns migrations with their stored timestamps for consistent regeneration.
+ */
+declare function getMigrationsToRegenerate(lockFile: LockFile, missingFiles: readonly string[]): Array<{
+    fileName: string;
+    timestamp: string;
+    tableName: string;
+    type: 'create' | 'alter' | 'drop' | 'pivot';
+    schemas: readonly string[];
+}>;
 
 /**
  * @famgia/omnify-atlas - HCL Types
@@ -744,4 +814,4 @@ declare function formatPreview(preview: ChangePreview, format?: PreviewFormat):
  */
 declare function hasBlockingIssues(_preview: ChangePreview): boolean;
 
-export { type AtlasConfig, type AtlasDiffOptions, type AtlasDiffResult, type AtlasInspectResult, type AtlasResult, type AtlasVersion, type ChangePreview, type ChangeSeverity, type ChangeType, type ColumnChange, type DiffResult, type DiffSummary, type GeneratedMigration, type HclColumn, type HclEnum, type HclForeignKey, type HclGenerationOptions, type HclIndex, type HclSchema, type HclTable, type IndexChange, type IndexSnapshot, LOCK_FILE_NAME, LOCK_FILE_VERSION, type LockFile, type LockFileComparison, type LockFileV1, type LockFileV2, type ParsedStatement, type PreviewFormat, type PreviewOptions, type PropertySnapshot, type SchemaChange, type SchemaHash, type SchemaSnapshot, type SqlColumnType, type SqlOperationType, type TableChange, addMigrationRecord, applySchema, buildSchemaHashes, buildSchemaSnapshots, checkAtlasVersion, compareSchemas, compareSchemasDeep, computeHash, computeSchemaHash, createEmptyLockFile, diffHclSchemas, formatDiffSummary, formatPreview, generateHclSchema, generateHclTable, generatePreview, getPrimaryKeyType, getTimestampType, hasBlockingIssues, isLockFileV2, mapPropertyToSql, parseDiffOutput, previewSchemaChanges, propertyNameToColumnName, propertyToSnapshot, readLockFile, renderHcl, runAtlasDiff, schemaNameToTableName, schemaToSnapshot, updateLockFile, updateLockFileV1, validateHcl, writeLockFile };
+export { type AtlasConfig, type AtlasDiffOptions, type AtlasDiffResult, type AtlasInspectResult, type AtlasResult, type AtlasVersion, type ChangePreview, type ChangeSeverity, type ChangeType, type ColumnChange, type DiffResult, type DiffSummary, type GeneratedMigration, type HclColumn, type HclEnum, type HclForeignKey, type HclGenerationOptions, type HclIndex, type HclSchema, type HclTable, type IndexChange, type IndexSnapshot, LOCK_FILE_NAME, LOCK_FILE_VERSION, type LockFile, type LockFileComparison, type LockFileV1, type LockFileV2, type MigrationValidation, type ParsedStatement, type PreviewFormat, type PreviewOptions, type PropertySnapshot, type SchemaChange, type SchemaHash, type SchemaSnapshot, type SqlColumnType, type SqlOperationType, type TableChange, addEnhancedMigrationRecord, addMigrationRecord, applySchema, buildSchemaHashes, buildSchemaSnapshots, checkAtlasVersion, compareSchemas, compareSchemasDeep, computeHash, computeSchemaHash, createEmptyLockFile, diffHclSchemas, extractTableNameFromFilename, extractTimestampFromFilename, findMigrationByTable, formatDiffSummary, formatPreview, generateHclSchema, generateHclTable, generatePreview, getMigrationsToRegenerate, getPrimaryKeyType, getTimestampType, hasBlockingIssues, isLockFileV2, mapPropertyToSql, parseDiffOutput, previewSchemaChanges, propertyNameToColumnName, propertyToSnapshot, readLockFile, renderHcl, runAtlasDiff, schemaNameToTableName, schemaToSnapshot, updateLockFile, updateLockFileV1, validateHcl, validateMigrations, writeLockFile };

package/dist/index.d.ts

@@ -26,6 +26,14 @@ interface PropertySnapshot {
     readonly onUpdate?: string | undefined;
     readonly mappedBy?: string | undefined;
     readonly joinTable?: string | undefined;
+    /** Pivot table fields for ManyToMany relationships */
+    readonly pivotFields?: Record<string, {
+        type: string;
+        nullable?: boolean;
+        default?: unknown;
+        length?: number;
+        unsigned?: boolean;
+    }> | undefined;
     readonly renamedFrom?: string | undefined;
     /** Laravel: hidden in serialization */
     readonly hidden?: boolean | undefined;
@@ -92,17 +100,42 @@ interface SchemaHash {
 }
 /**
  * Generated migration record.
+ * Enhanced for team development with file tracking and regeneration support.
+ * Note: timestamp, tableName, type are optional for backwards compatibility with v1 lock files.
  */
 interface GeneratedMigration {
-    /** Migration file name */
+    /** Migration file name (e.g., "2026_01_13_100000_create_users_table.php") */
     readonly fileName: string;
-    /** Timestamp when generated */
+    /** Migration timestamp prefix for regeneration (e.g., "2026_01_13_100000") - Optional for backwards compatibility */
+    readonly timestamp?: string | undefined;
+    /** Table name for lookup (e.g., "users") - Optional for backwards compatibility */
+    readonly tableName?: string | undefined;
+    /** Migration type - Optional for backwards compatibility */
+    readonly type?: 'create' | 'alter' | 'drop' | 'pivot' | undefined;
+    /** Timestamp when generated (ISO 8601) */
     readonly generatedAt: string;
     /** Schemas involved in this migration */
     readonly schemas: readonly string[];
-    /** Migration checksum for integrity */
+    /** Migration content checksum (SHA-256) for integrity verification */
     readonly checksum: string;
 }
+/**
+ * Migration validation result.
+ */
+interface MigrationValidation {
+    /** Whether all migrations are valid */
+    readonly valid: boolean;
+    /** List of missing migration files */
+    readonly missingFiles: readonly string[];
+    /** List of migrations with checksum mismatch (file modified) */
+    readonly modifiedFiles: readonly string[];
+    /** List of stale migrations (old timestamp, recently added to repo) */
+    readonly staleFiles: readonly string[];
+    /** Total migrations tracked */
+    readonly totalTracked: number;
+    /** Total migrations found on disk */
+    readonly totalOnDisk: number;
+}
 /**
  * Lock file structure for tracking schema state (v1 - legacy).
  */
@@ -213,12 +246,6 @@ interface LockFileComparison {
     readonly unchanged: readonly string[];
 }
 
-/**
- * @famgia/omnify-atlas - Lock File Management
- *
- * Manages the .omnify.lock file for tracking schema state.
- */
-
 /**
  * Default lock file name.
  */
@@ -297,6 +324,49 @@ declare function updateLockFileV1(existingLockFile: LockFile | null, currentHash
  * Adds a migration record to the lock file.
  */
 declare function addMigrationRecord(lockFile: LockFile, fileName: string, schemas: readonly string[], migrationContent: string): LockFile;
+/**
+ * Adds an enhanced migration record to the lock file.
+ * Includes timestamp and tableName for regeneration support.
+ */
+declare function addEnhancedMigrationRecord(lockFile: LockFile, options: {
+    fileName: string;
+    timestamp: string;
+    tableName: string;
+    type: 'create' | 'alter' | 'drop' | 'pivot';
+    schemas: readonly string[];
+    content: string;
+}): LockFile;
+/**
+ * Extracts timestamp from migration filename.
+ * @example "2026_01_13_100000_create_users_table.php" → "2026_01_13_100000"
+ */
+declare function extractTimestampFromFilename(fileName: string): string | null;
+/**
+ * Extracts table name from migration filename.
+ * @example "2026_01_13_100000_create_users_table.php" → "users"
+ */
+declare function extractTableNameFromFilename(fileName: string): string | null;
+/**
+ * Validates migration files against lock file records.
+ * Checks for missing files, modified files, and stale migrations.
+ */
+declare function validateMigrations(lockFile: LockFile, migrationsDir: string): Promise<MigrationValidation>;
+/**
+ * Finds migration record by table name.
+ * Useful for regenerating deleted migrations.
+ */
+declare function findMigrationByTable(lockFile: LockFile, tableName: string, type?: 'create' | 'alter' | 'drop' | 'pivot'): GeneratedMigration | undefined;
+/**
+ * Gets migrations that need to be regenerated (missing files).
+ * Returns migrations with their stored timestamps for consistent regeneration.
+ */
+declare function getMigrationsToRegenerate(lockFile: LockFile, missingFiles: readonly string[]): Array<{
+    fileName: string;
+    timestamp: string;
+    tableName: string;
+    type: 'create' | 'alter' | 'drop' | 'pivot';
+    schemas: readonly string[];
+}>;
 
 /**
  * @famgia/omnify-atlas - HCL Types
@@ -744,4 +814,4 @@ declare function formatPreview(preview: ChangePreview, format?: PreviewFormat):
  */
 declare function hasBlockingIssues(_preview: ChangePreview): boolean;
 
-export { type AtlasConfig, type AtlasDiffOptions, type AtlasDiffResult, type AtlasInspectResult, type AtlasResult, type AtlasVersion, type ChangePreview, type ChangeSeverity, type ChangeType, type ColumnChange, type DiffResult, type DiffSummary, type GeneratedMigration, type HclColumn, type HclEnum, type HclForeignKey, type HclGenerationOptions, type HclIndex, type HclSchema, type HclTable, type IndexChange, type IndexSnapshot, LOCK_FILE_NAME, LOCK_FILE_VERSION, type LockFile, type LockFileComparison, type LockFileV1, type LockFileV2, type ParsedStatement, type PreviewFormat, type PreviewOptions, type PropertySnapshot, type SchemaChange, type SchemaHash, type SchemaSnapshot, type SqlColumnType, type SqlOperationType, type TableChange, addMigrationRecord, applySchema, buildSchemaHashes, buildSchemaSnapshots, checkAtlasVersion, compareSchemas, compareSchemasDeep, computeHash, computeSchemaHash, createEmptyLockFile, diffHclSchemas, formatDiffSummary, formatPreview, generateHclSchema, generateHclTable, generatePreview, getPrimaryKeyType, getTimestampType, hasBlockingIssues, isLockFileV2, mapPropertyToSql, parseDiffOutput, previewSchemaChanges, propertyNameToColumnName, propertyToSnapshot, readLockFile, renderHcl, runAtlasDiff, schemaNameToTableName, schemaToSnapshot, updateLockFile, updateLockFileV1, validateHcl, writeLockFile };
+export { type AtlasConfig, type AtlasDiffOptions, type AtlasDiffResult, type AtlasInspectResult, type AtlasResult, type AtlasVersion, type ChangePreview, type ChangeSeverity, type ChangeType, type ColumnChange, type DiffResult, type DiffSummary, type GeneratedMigration, type HclColumn, type HclEnum, type HclForeignKey, type HclGenerationOptions, type HclIndex, type HclSchema, type HclTable, type IndexChange, type IndexSnapshot, LOCK_FILE_NAME, LOCK_FILE_VERSION, type LockFile, type LockFileComparison, type LockFileV1, type LockFileV2, type MigrationValidation, type ParsedStatement, type PreviewFormat, type PreviewOptions, type PropertySnapshot, type SchemaChange, type SchemaHash, type SchemaSnapshot, type SqlColumnType, type SqlOperationType, type TableChange, addEnhancedMigrationRecord, addMigrationRecord, applySchema, buildSchemaHashes, buildSchemaSnapshots, checkAtlasVersion, compareSchemas, compareSchemasDeep, computeHash, computeSchemaHash, createEmptyLockFile, diffHclSchemas, extractTableNameFromFilename, extractTimestampFromFilename, findMigrationByTable, formatDiffSummary, formatPreview, generateHclSchema, generateHclTable, generatePreview, getMigrationsToRegenerate, getPrimaryKeyType, getTimestampType, hasBlockingIssues, isLockFileV2, mapPropertyToSql, parseDiffOutput, previewSchemaChanges, propertyNameToColumnName, propertyToSnapshot, readLockFile, renderHcl, runAtlasDiff, schemaNameToTableName, schemaToSnapshot, updateLockFile, updateLockFileV1, validateHcl, validateMigrations, writeLockFile };

package/dist/index.js

@@ -43,6 +43,7 @@ function propertyToSnapshot(property) {
     onUpdate: prop.onUpdate,
     mappedBy: prop.mappedBy,
     joinTable: prop.joinTable,
+    pivotFields: prop.pivotFields,
     // renamedFrom is kept in snapshot for comparison (rename detection),
     // but will be stripped when writing to lock file.
     renamedFrom: prop.renamedFrom,
@@ -430,6 +431,125 @@ function addMigrationRecord(lockFile, fileName, schemas, migrationContent) {
     migrations: [...lockFile.migrations, record]
   };
 }
+function addEnhancedMigrationRecord(lockFile, options) {
+  const record = {
+    fileName: options.fileName,
+    timestamp: options.timestamp,
+    tableName: options.tableName,
+    type: options.type,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    schemas: options.schemas,
+    checksum: computeHash(options.content)
+  };
+  return {
+    ...lockFile,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    migrations: [...lockFile.migrations, record]
+  };
+}
+function extractTimestampFromFilename(fileName) {
+  const match = fileName.match(/^(\d{4}_\d{2}_\d{2}_\d{6})_/);
+  return match ? match[1] : null;
+}
+function extractTableNameFromFilename(fileName) {
+  const createMatch = fileName.match(/_create_(.+)_table\.php$/);
+  if (createMatch) return createMatch[1];
+  const updateMatch = fileName.match(/_update_(.+)_table\.php$/);
+  if (updateMatch) return updateMatch[1];
+  const dropMatch = fileName.match(/_drop_(.+)_table\.php$/);
+  if (dropMatch) return dropMatch[1];
+  return null;
+}
+async function validateMigrations(lockFile, migrationsDir) {
+  const missingFiles = [];
+  const modifiedFiles = [];
+  const staleFiles = [];
+  let filesOnDisk = [];
+  try {
+    const { readdirSync } = await import("fs");
+    filesOnDisk = readdirSync(migrationsDir).filter((f) => f.endsWith(".php"));
+  } catch {
+  }
+  const filesOnDiskSet = new Set(filesOnDisk);
+  for (const migration of lockFile.migrations) {
+    const fileName = migration.fileName;
+    if (!filesOnDiskSet.has(fileName)) {
+      missingFiles.push(fileName);
+      continue;
+    }
+    if (migration.checksum) {
+      try {
+        const { readFileSync } = await import("fs");
+        const { join: join3 } = await import("path");
+        const content = readFileSync(join3(migrationsDir, fileName), "utf8");
+        const currentChecksum = computeHash(content);
+        if (currentChecksum !== migration.checksum) {
+          modifiedFiles.push(fileName);
+        }
+      } catch {
+      }
+    }
+  }
+  const trackedFileNames = new Set(lockFile.migrations.map((m) => m.fileName));
+  const now = /* @__PURE__ */ new Date();
+  for (const fileName of filesOnDisk) {
+    if (!trackedFileNames.has(fileName)) {
+      const timestamp = extractTimestampFromFilename(fileName);
+      if (timestamp) {
+        const [year, month, day] = timestamp.split("_").slice(0, 3).map(Number);
+        const fileDate = new Date(year, month - 1, day);
+        const daysDiff = (now.getTime() - fileDate.getTime()) / (1e3 * 60 * 60 * 24);
+        if (daysDiff > 7) {
+          staleFiles.push(fileName);
+        }
+      }
+    }
+  }
+  return {
+    valid: missingFiles.length === 0 && modifiedFiles.length === 0,
+    missingFiles,
+    modifiedFiles,
+    staleFiles,
+    totalTracked: lockFile.migrations.length,
+    totalOnDisk: filesOnDisk.length
+  };
+}
+function findMigrationByTable(lockFile, tableName, type) {
+  return lockFile.migrations.find((m) => {
+    const mig = m;
+    if (mig.tableName) {
+      return mig.tableName === tableName && (!type || mig.type === type);
+    }
+    const extractedTable = extractTableNameFromFilename(m.fileName);
+    return extractedTable === tableName;
+  });
+}
+function getMigrationsToRegenerate(lockFile, missingFiles) {
+  const missingSet = new Set(missingFiles);
+  const result = [];
+  for (const migration of lockFile.migrations) {
+    if (!missingSet.has(migration.fileName)) continue;
+    const mig = migration;
+    const timestamp = mig.timestamp ?? extractTimestampFromFilename(migration.fileName);
+    if (!timestamp) continue;
+    const tableName = mig.tableName ?? extractTableNameFromFilename(migration.fileName);
+    if (!tableName) continue;
+    let type = mig.type ?? "create";
+    if (!mig.type) {
+      if (migration.fileName.includes("_create_")) type = "create";
+      else if (migration.fileName.includes("_update_")) type = "alter";
+      else if (migration.fileName.includes("_drop_")) type = "drop";
+    }
+    result.push({
+      fileName: migration.fileName,
+      timestamp,
+      tableName,
+      type,
+      schemas: migration.schemas
+    });
+  }
+  return result;
+}
 
 // src/hcl/type-mapper.ts
 var MYSQL_TYPES = {
@@ -1590,6 +1710,7 @@ function hasBlockingIssues(_preview) {
 export {
   LOCK_FILE_NAME,
   LOCK_FILE_VERSION,
+  addEnhancedMigrationRecord,
   addMigrationRecord,
   applySchema,
   buildSchemaHashes,
@@ -1601,11 +1722,15 @@ export {
   computeSchemaHash,
   createEmptyLockFile,
   diffHclSchemas,
+  extractTableNameFromFilename,
+  extractTimestampFromFilename,
+  findMigrationByTable,
   formatDiffSummary,
   formatPreview,
   generateHclSchema,
   generateHclTable,
   generatePreview,
+  getMigrationsToRegenerate,
   getPrimaryKeyType,
   getTimestampType,
   hasBlockingIssues,
@@ -1623,6 +1748,7 @@ export {
   updateLockFile,
   updateLockFileV1,
   validateHcl,
+  validateMigrations,
   writeLockFile
 };
 //# sourceMappingURL=index.js.map