@contember/cli 2.1.0-beta.1 → 2.2.0-alpha.1

package/package.json

@@ -1,17 +1,34 @@
 {
   "name": "@contember/cli",
-  "version": "2.1.0-beta.1",
+  "version": "2.2.0-alpha.1",
   "license": "Apache-2.0",
   "bin": {
     "contember": "./dist/production/run.js"
   },
   "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "development": "./dist/development/index.js",
+        "production": "./dist/production/index.js",
+        "typescript": "./src/index.ts",
+        "default": "./dist/production/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "development": "./dist/development/index.cjs",
+        "production": "./dist/production/index.cjs",
+        "typescript": "./src/index.ts",
+        "default": "./dist/production/index.cjs"
+      }
+    }
+  },
   "scripts": {
     "build": "tailwindcss -i src/lib/project/docs/resources/style.css -o ./dist/resources/out.css"
   },
   "devDependencies": {
     "@tailwindcss/cli": "^4.2.1",
-    "@types/fs-extra": "^11.0.4",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.12.0",
     "@types/prompts": "^2.4.9",
@@ -19,25 +36,26 @@
     "tailwindcss": "^4.2.1"
   },
   "dependencies": {
-    "@contember/cli-common": "2.1.0-beta.1",
-    "@contember/config-loader": "2.1.0-beta.1",
-    "@contember/database": "2.1.0-beta.1",
-    "@contember/dic": "2.1.0-beta.1",
-    "@contember/engine-common": "2.1.0-beta.1",
-    "@contember/engine-content-api": "2.1.0-beta.1",
-    "@contember/graphql-client": "2.1.0-beta.1",
-    "@contember/migrations-client": "2.1.0-beta.1",
-    "@contember/schema": "2.1.0-beta.1",
-    "@contember/schema-migrations": "2.1.0-beta.1",
-    "@contember/schema-utils": "2.1.0-beta.1",
-    "@contember/typesafe": "2.1.0-beta.1",
+    "@contember/cli-common": "2.1.0-beta.2",
+    "@contember/config-loader": "2.1.0-beta.2",
+    "@contember/database": "2.1.0-beta.2",
+    "@contember/dic": "2.1.0-beta.2",
+    "@contember/engine-common": "2.1.0-beta.2",
+    "@contember/engine-content-api": "2.1.0-beta.2",
+    "@contember/graphql-client": "2.1.0-beta.2",
+    "@contember/graphql-client-tenant": "2.1.0-beta.2",
+    "@contember/migrations-client": "2.1.0-beta.2",
+    "@contember/schema": "2.1.0-beta.2",
+    "@contember/schema-migrations": "2.1.0-beta.2",
+    "@contember/schema-utils": "2.1.0-beta.2",
+    "@contember/typesafe": "2.1.0-beta.2",
     "@graphql-tools/schema": "^10.0.31",
     "chalk": "^5.6.2",
     "chalk-table": "^1.0.2",
     "fast-glob": "^3.3.3",
     "graphql": "^16.13.1",
+    "graphql-ts-client-api": "^3.1.17",
     "js-yaml": "^4.1.1",
-    "lodash-es": "^4.17.23",
     "pg": "^8.20.0",
     "preact": "^10.28.4",
     "preact-render-to-string": "^6.6.6",

package/src/commands/actions/ActionsGetEventCommand.ts

@@ -1,6 +1,6 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
-import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver'
-import { ActionsClient } from '../../lib/actions/ActionsClient'
+import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver.js'
+import { ActionsClient } from '../../lib/actions/ActionsClient.js'
 
 type Args = {
 	eventId: string

package/src/commands/actions/ActionsListFailedEventsCommand.ts

@@ -1,6 +1,6 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
-import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver'
-import { ActionsClient } from '../../lib/actions/ActionsClient'
+import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver.js'
+import { ActionsClient } from '../../lib/actions/ActionsClient.js'
 import chalkTable from 'chalk-table'
 type Args = {}
 

package/src/commands/actions/ActionsListVariablesCommand.ts

@@ -1,6 +1,6 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
-import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver'
-import { ActionsClient } from '../../lib/actions/ActionsClient'
+import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver.js'
+import { ActionsClient } from '../../lib/actions/ActionsClient.js'
 import chalkTable from 'chalk-table'
 
 type Args = {}

package/src/commands/actions/ActionsRetryEventCommand.ts

@@ -1,6 +1,6 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
-import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver'
-import { ActionsClient } from '../../lib/actions/ActionsClient'
+import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver.js'
+import { ActionsClient } from '../../lib/actions/ActionsClient.js'
 import chalkTable from 'chalk-table'
 type Args = {
 	eventId: string

package/src/commands/actions/ActionsSetVariablesCommand.ts

@@ -1,6 +1,6 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
-import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver'
-import { ActionsClient } from '../../lib/actions/ActionsClient'
+import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver.js'
+import { ActionsClient } from '../../lib/actions/ActionsClient.js'
 
 type Args = {
 	variables: string[]

package/src/commands/actions/ActionsStopEventCommand.ts

@@ -1,6 +1,6 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
-import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver'
-import { ActionsClient } from '../../lib/actions/ActionsClient'
+import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver.js'
+import { ActionsClient } from '../../lib/actions/ActionsClient.js'
 import chalkTable from 'chalk-table'
 type Args = {
 	eventId: string

package/src/commands/deploy/DeployCommand.ts

@@ -1,13 +1,13 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
 import prompts from 'prompts'
-import { maskToken } from '../../lib/maskToken'
-import { MigrationExecutionFacade } from '../../lib/migrations/MigrationExecutionFacade'
-import { AdminDeployer } from '../../lib/admin/AdminDeployer'
-import { FileSystem } from '../../lib/fs/FileSystem'
-import { RemoteProject } from '../../lib/project/RemoteProject'
-import { Workspace } from '../../lib/workspace/Workspace'
-import { RemoteProjectProvider } from '../../lib/project/RemoteProjectProvider'
-import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver'
+import { maskToken } from '../../lib/maskToken.js'
+import { MigrationExecutionFacade } from '../../lib/migrations/MigrationExecutionFacade.js'
+import { AdminDeployer } from '../../lib/admin/AdminDeployer.js'
+import { FileSystem } from '../../lib/fs/FileSystem.js'
+import { RemoteProject } from '../../lib/project/RemoteProject.js'
+import { Workspace } from '../../lib/workspace/Workspace.js'
+import { RemoteProjectProvider } from '../../lib/project/RemoteProjectProvider.js'
+import { RemoteProjectResolver } from '../../lib/project/RemoteProjectResolver.js'
 
 type Args = {
 	dsn?: string
@@ -19,6 +19,7 @@ type Options = {
 	['no-migrations']?: boolean
 	root?: boolean
 	yes?: boolean
+	snapshot?: boolean
 }
 
 export class DeployCommand extends Command<Args, Options> {
@@ -41,6 +42,9 @@ export class DeployCommand extends Command<Args, Options> {
 		configuration.option('root').valueNone()
 		configuration.option('no-admin').valueNone()
 		configuration.option('no-migrations').valueNone()
+		configuration.option('snapshot')
+			.valueNone()
+			.description('Bootstrap an empty target database from snapshot.json instead of replaying every migration')
 		configuration //
 			.option('yes')
 			.valueNone()
@@ -79,6 +83,7 @@ export class DeployCommand extends Command<Args, Options> {
 				force: false,
 				requireConfirmation: !yes,
 				additionalMessage: deployAdmin ? 'Admin will be deployed.' : 'Admin will NOT be deployed.',
+				useSnapshot: input.getOption('snapshot') === true,
 			})
 			if (!result) {
 				return

package/src/commands/deploy/index.ts

@@ -1 +1 @@
-export * from './DeployCommand'
+export * from './DeployCommand.js'

package/src/commands/index.ts

@@ -1,5 +1,6 @@
-export * from './deploy'
-export * from './migrations'
-export * from './misc'
-export * from './project'
-export * from './workspace'
+export * from './deploy/index.js'
+export * from './migrations/index.js'
+export * from './misc/index.js'
+export * from './project/index.js'
+export * from './tenant/index.js'
+export * from './workspace/index.js'

package/src/commands/migrations/MigrationAmendCommand.ts

@@ -2,13 +2,13 @@ import { Command, CommandConfiguration, Input } from '@contember/cli-common'
 import { InvalidSchemaException, SchemaMigrator } from '@contember/schema-migrations'
 import prompts from 'prompts'
 import { emptySchema } from '@contember/schema-utils'
-import { MigrationCreator, MigrationsResolver, SchemaVersionBuilder, SystemClient } from '@contember/migrations-client'
-import { MigrationsStatusFacade } from '../../lib/migrations/MigrationsStatusFacade'
-import { SchemaLoader } from '../../lib/schema/SchemaLoader'
-import { MigrationsValidator } from '../../lib/migrations/MigrationsValidator'
-import { MigrationPrinter } from '../../lib/migrations/MigrationPrinter'
-import { printValidationErrors } from '../../lib/schema/SchemaValidationPrinter'
-import { SystemClientProvider } from '../../lib/SystemClientProvider'
+import { MigrationCreator, MigrationsResolver, SchemaStateManager, SchemaVersionBuilder } from '@contember/migrations-client'
+import { MigrationsStatusFacade } from '../../lib/migrations/MigrationsStatusFacade.js'
+import { SchemaLoader } from '../../lib/schema/SchemaLoader.js'
+import { MigrationsValidator } from '../../lib/migrations/MigrationsValidator.js'
+import { MigrationPrinter } from '../../lib/migrations/MigrationPrinter.js'
+import { printValidationErrors } from '../../lib/schema/SchemaValidationPrinter.js'
+import { SystemClientProvider } from '../../lib/SystemClientProvider.js'
 
 type Args = {
 	migration?: string
@@ -30,6 +30,7 @@ export class MigrationAmendCommand extends Command<Args, Options> {
 		private readonly migrationsValidator: MigrationsValidator,
 		private readonly migrationPrinter: MigrationPrinter,
 		private readonly schemaMigrator: SchemaMigrator,
+		private readonly schemaStateManager: SchemaStateManager,
 	) {
 		super()
 	}
@@ -59,11 +60,23 @@ export class MigrationAmendCommand extends Command<Args, Options> {
 		}
 
 		const schema = await this.schemaLoader.loadSchema()
+		const stateMode = await this.schemaStateManager.isStateMode()
 		try {
 			const initialSchema = await this.schemaVersionBuilder.buildSchema()
-			const intermediateResult = await this.migrationCreator.prepareMigration(initialSchema, schema, '')
+			const intermediateResult = await this.migrationCreator.prepareMigration(initialSchema, schema, '', {
+				skipNonModelDiffers: stateMode,
+			})
+
+			const schemaState = stateMode ? SchemaStateManager.schemaStateFromSchema(schema) : undefined
+			const stateChanged = schemaState ? await this.schemaStateManager.writeState(schemaState, { dryRun: true }) : false
+
 			if (intermediateResult === null) {
-				console.log('Nothing to do')
+				if (stateChanged) {
+					await this.schemaStateManager.writeState(schemaState!)
+					console.log('Schema state updated (no model changes)')
+				} else {
+					console.log('Nothing to do')
+				}
 				return 0
 			}
 			if (amendMigration.formatVersion !== intermediateResult.migration.formatVersion) {
@@ -78,7 +91,9 @@ export class MigrationAmendCommand extends Command<Args, Options> {
 				[...amendMigration.modifications, ...intermediateResult.migration.modifications],
 				amendMigration.formatVersion,
 			)
-			const newMigrationResult = await this.migrationCreator.prepareMigration(prevSchema, newSchema, '')
+			const newMigrationResult = await this.migrationCreator.prepareMigration(prevSchema, newSchema, '', {
+				skipNonModelDiffers: stateMode,
+			})
 			const followingMigrations = (await this.migrationsResolver.getSchemaMigrations()).filter(
 				it => it.version > amendMigration.version,
 			)
@@ -108,6 +123,12 @@ export class MigrationAmendCommand extends Command<Args, Options> {
 			if (!newMigrationResult && await this.shouldRemove()) {
 				await this.migrationCreator.removeMigration(amendMigration.name)
 				await systemClient.migrationDelete(amendMigration.version)
+				if (schemaState) {
+					await this.schemaStateManager.writeState(schemaState)
+					// migrationDelete rebuilds the server schema from migrations, dropping the
+					// non-model state; re-apply it so the server stays in sync with the state files.
+					await systemClient.migrate([], force, schemaState)
+				}
 				console.log('Latest migration was removed')
 				return 0
 			}
@@ -120,6 +141,13 @@ export class MigrationAmendCommand extends Command<Args, Options> {
 			await this.migrationCreator.saveMigration(newMigration)
 			await systemClient.migrationModify(amendMigration.version, newMigration)
 
+			if (schemaState) {
+				await this.schemaStateManager.writeState(schemaState)
+				// migrationModify rebuilds the server schema from migrations, dropping the
+				// non-model state; re-apply it so the server stays in sync with the state files.
+				await systemClient.migrate([], force, schemaState)
+			}
+
 			return 0
 		} catch (e) {
 			if (e instanceof InvalidSchemaException) {

package/src/commands/migrations/MigrationDescribeCommand.ts

@@ -1,5 +1,5 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
-import { MigrationPrinter } from '../../lib/migrations/MigrationPrinter'
+import { MigrationPrinter } from '../../lib/migrations/MigrationPrinter.js'
 import { MigrationsResolver, SchemaVersionBuilder } from '@contember/migrations-client'
 
 type Args = {

package/src/commands/migrations/MigrationDiffCommand.ts

@@ -1,11 +1,11 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
 import { InvalidSchemaException } from '@contember/schema-migrations'
 import prompts from 'prompts'
-import { MigrationCreator, SchemaVersionBuilder } from '@contember/migrations-client'
-import { SchemaLoader } from '../../lib/schema/SchemaLoader'
-import { MigrationPrinter } from '../../lib/migrations/MigrationPrinter'
-import { MigrationExecutionFacade } from '../../lib/migrations/MigrationExecutionFacade'
-import { printValidationErrors } from '../../lib/schema/SchemaValidationPrinter'
+import { MigrationCreator, MigrationsResolver, SchemaStateManager, SchemaVersionBuilder } from '@contember/migrations-client'
+import { SchemaLoader } from '../../lib/schema/SchemaLoader.js'
+import { MigrationPrinter } from '../../lib/migrations/MigrationPrinter.js'
+import { MigrationExecutionFacade } from '../../lib/migrations/MigrationExecutionFacade.js'
+import { printValidationErrors } from '../../lib/schema/SchemaValidationPrinter.js'
 
 type Args = {
 	migrationName: string
@@ -15,6 +15,7 @@ type Options = {
 	execute?: true
 	yes?: true
 	'skip-initial-schema-validation'?: true
+	'recreate-views'?: true
 }
 
 export class MigrationDiffCommand extends Command<Args, Options> {
@@ -24,6 +25,8 @@ export class MigrationDiffCommand extends Command<Args, Options> {
 		private readonly migrationCreator: MigrationCreator,
 		private readonly migrationPrinter: MigrationPrinter,
 		private readonly migrationExecutorFacade: MigrationExecutionFacade,
+		private readonly schemaStateManager: SchemaStateManager,
+		private readonly migrationsResolver: MigrationsResolver,
 	) {
 		super()
 	}
@@ -38,6 +41,12 @@ export class MigrationDiffCommand extends Command<Args, Options> {
 			.description('Do not ask for confirmation.')
 
 		configuration.option('skip-initial-schema-validation')
+		configuration //
+			.option('recreate-views')
+			.valueNone()
+			.description(
+				'Drop & recreate changed views instead of updating them in-place (CREATE OR REPLACE VIEW). Use when an in-place view update fails with SQLSTATE 42P16.',
+			)
 	}
 
 	protected async execute(input: Input<Args, Options>): Promise<void> {
@@ -45,15 +54,44 @@ export class MigrationDiffCommand extends Command<Args, Options> {
 		let shouldExecute = input.getOption('execute')
 		const yes = input.getOption('yes')
 		const skipInitialSchemaValidation = input.getOption('skip-initial-schema-validation') === true
+		const recreateViews = input.getOption('recreate-views') === true
 
 		const schema = await this.schemaLoader.loadSchema()
+		let stateMode = await this.schemaStateManager.isStateMode()
+
+		// New project (no migrations yet) defaults to schema state mode. To opt out, create a migration first (e.g. `migrations:blank`).
+		if (!stateMode && (await this.migrationsResolver.getSchemaMigrations()).length === 0) {
+			console.log('No migrations found — enabling schema state mode for this project.')
+			console.log('ACL, validation, actions and settings will be managed in the state/ directory instead of migrations.')
+			await this.schemaStateManager.extractState(schema)
+			stateMode = true
+		}
+
 		try {
 			const initialSchema = await this.schemaVersionBuilder.buildSchema()
 			const result = await this.migrationCreator.prepareMigration(initialSchema, schema, migrationName, {
 				skipInitialSchemaValidation: skipInitialSchemaValidation,
+				skipNonModelDiffers: stateMode,
+				recreateViews,
 			})
+
+			const schemaState = stateMode ? SchemaStateManager.schemaStateFromSchema(schema) : undefined
+			const stateChanged = schemaState ? await this.schemaStateManager.writeState(schemaState, { dryRun: true }) : false
+
 			if (result === null) {
-				console.log('Nothing to do')
+				if (stateChanged) {
+					console.log('Schema state updated (no model changes)')
+					await this.schemaStateManager.writeState(schemaState!)
+				} else {
+					console.log('Nothing to do')
+				}
+				if (stateChanged && shouldExecute) {
+					console.log('Syncing schema state to server...')
+					await this.migrationExecutorFacade.execute({
+						force: false,
+						requireConfirmation: false,
+					})
+				}
 				return
 			}
 			this.migrationPrinter.printMigrationDescription(result.initialSchema, result.migration, { noSql: true })
@@ -79,8 +117,14 @@ export class MigrationDiffCommand extends Command<Args, Options> {
 			}
 
 			const filename = await this.migrationCreator.saveMigration(result.migration)
+			if (stateChanged) {
+				await this.schemaStateManager.writeState(schemaState!)
+			}
 
 			console.log(`${filename} created`)
+			if (stateChanged) {
+				console.log('Schema state files updated')
+			}
 		} catch (e) {
 			if (e instanceof InvalidSchemaException) {
 				printValidationErrors(e.validationErrors, e.message)

package/src/commands/migrations/MigrationExecuteCommand.ts

@@ -1,5 +1,5 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
-import { MigrationExecutionFacade } from '../../lib/migrations/MigrationExecutionFacade'
+import { MigrationExecutionFacade } from '../../lib/migrations/MigrationExecutionFacade.js'
 
 type Args = {}
 
@@ -7,6 +7,7 @@ type Options = {
 	until?: string
 	force: boolean
 	yes?: boolean
+	['no-snapshot']?: boolean
 }
 
 export class MigrationExecuteCommand extends Command<Args, Options> {
@@ -23,6 +24,9 @@ export class MigrationExecuteCommand extends Command<Args, Options> {
 		configuration.option('until')
 			.valueRequired()
 			.description('Execute all migrations leading up to, and inclusive of, a specified migration')
+		configuration.option('no-snapshot')
+			.valueNone()
+			.description('Do not bootstrap a fresh database from snapshot.json; replay every migration instead')
 		configuration //
 			.option('yes')
 			.valueNone()
@@ -37,6 +41,7 @@ export class MigrationExecuteCommand extends Command<Args, Options> {
 			force,
 			until,
 			requireConfirmation: !input.getOption('yes'),
+			useSnapshot: input.getOption('no-snapshot') !== true,
 		})
 	}
 }

package/src/commands/migrations/MigrationInitStateCommand.ts

@@ -0,0 +1,34 @@
+import { Command, CommandConfiguration, Input } from '@contember/cli-common'
+import { SchemaStateManager } from '@contember/migrations-client'
+import { SchemaLoader } from '../../lib/schema/SchemaLoader.js'
+
+type Args = {}
+
+type Options = {}
+
+export class MigrationInitStateCommand extends Command<Args, Options> {
+	constructor(
+		private readonly schemaLoader: SchemaLoader,
+		private readonly schemaStateManager: SchemaStateManager,
+	) {
+		super()
+	}
+
+	protected configure(configuration: CommandConfiguration<Args, Options>): void {
+		configuration.description('Enables schema state mode by extracting ACL, validation, actions and settings into the state/ directory')
+	}
+
+	protected async execute(): Promise<number> {
+		if (await this.schemaStateManager.isStateMode()) {
+			console.log('Schema state mode is already enabled')
+			return 0
+		}
+
+		const schema = await this.schemaLoader.loadSchema()
+		await this.schemaStateManager.extractState(schema)
+
+		console.log('Schema state mode enabled. ACL, validation, actions and settings are now managed in the state/ directory.')
+		console.log('These parts of the schema will no longer be written into migrations.')
+		return 0
+	}
+}

package/src/commands/migrations/MigrationRebaseCommand.ts

@@ -1,6 +1,6 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
 import { Migration, MigrationsResolver } from '@contember/migrations-client'
-import { MigrationRebaseFacade } from '../../lib/migrations/MigrationRebaseFacade'
+import { MigrationRebaseFacade } from '../../lib/migrations/MigrationRebaseFacade.js'
 
 type Args = {
 	migration: string[]

package/src/commands/migrations/MigrationSnapshotCommand.ts

@@ -0,0 +1,34 @@
+import { Command, CommandConfiguration, Input } from '@contember/cli-common'
+import { MigrationSnapshotFacade } from '../../lib/migrations/MigrationSnapshotFacade.js'
+
+type Args = {}
+
+type Options = {}
+
+export class MigrationSnapshotCommand extends Command<Args, Options> {
+	constructor(
+		private readonly migrationSnapshotFacade: MigrationSnapshotFacade,
+	) {
+		super()
+	}
+
+	protected configure(configuration: CommandConfiguration<Args, Options>): void {
+		configuration.description(
+			'Creates a schema snapshot (snapshot.json) that bootstraps a fresh database in one step instead of replaying every migration',
+		)
+	}
+
+	protected async execute(input: Input<Args, Options>): Promise<number> {
+		const snapshot = await this.migrationSnapshotFacade.create()
+		console.log(`Snapshot created: ${snapshot.covers.length} migrations collapsed up to ${snapshot.version}.`)
+
+		if (snapshot.contentMigrations.length > 0) {
+			console.warn('')
+			console.warn(`Warning: ${snapshot.contentMigrations.length} content (data) migration(s) are covered by this snapshot:`)
+			snapshot.contentMigrations.forEach(version => console.warn(`  - ${version}`))
+			console.warn('Their data effects are NOT reproduced when bootstrapping from the snapshot.')
+			console.warn('Seed any required data manually for local development.')
+		}
+		return 0
+	}
+}

package/src/commands/migrations/MigrationStatusCommand.ts

@@ -1,9 +1,9 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
 import { MigrationFilesManager, MigrationState, sortMigrations, SystemClient } from '@contember/migrations-client'
 import chalk from 'chalk'
-import { MigrationsStatusFacade } from '../../lib/migrations/MigrationsStatusFacade'
-import { MigrationPrinter } from '../../lib/migrations/MigrationPrinter'
-import { SystemClientProvider } from '../../lib/SystemClientProvider'
+import { MigrationsStatusFacade } from '../../lib/migrations/MigrationsStatusFacade.js'
+import { MigrationPrinter } from '../../lib/migrations/MigrationPrinter.js'
+import { SystemClientProvider } from '../../lib/SystemClientProvider.js'
 
 type Args = {}
 

package/src/commands/migrations/MigrationVerifySnapshotCommand.ts

@@ -0,0 +1,28 @@
+import { Command, CommandConfiguration, Input } from '@contember/cli-common'
+import { MigrationSnapshotFacade } from '../../lib/migrations/MigrationSnapshotFacade.js'
+
+type Args = {}
+
+type Options = {}
+
+export class MigrationVerifySnapshotCommand extends Command<Args, Options> {
+	constructor(
+		private readonly migrationSnapshotFacade: MigrationSnapshotFacade,
+	) {
+		super()
+	}
+
+	protected configure(configuration: CommandConfiguration<Args, Options>): void {
+		configuration.description('Verifies that snapshot.json still matches a full replay of all migrations')
+	}
+
+	protected async execute(input: Input<Args, Options>): Promise<number> {
+		const result = await this.migrationSnapshotFacade.verify()
+		if (result.ok) {
+			console.log(result.message)
+			return 0
+		}
+		console.error(result.message)
+		return 1
+	}
+}

package/src/commands/migrations/index.ts

@@ -1,7 +1,10 @@
-export * from './MigrationAmendCommand'
-export * from './MigrationBlankCommand'
-export * from './MigrationDescribeCommand'
-export * from './MigrationDiffCommand'
-export * from './MigrationExecuteCommand'
-export * from './MigrationStatusCommand'
-export * from './MigrationRebaseCommand'
+export * from './MigrationAmendCommand.js'
+export * from './MigrationBlankCommand.js'
+export * from './MigrationDescribeCommand.js'
+export * from './MigrationDiffCommand.js'
+export * from './MigrationExecuteCommand.js'
+export * from './MigrationInitStateCommand.js'
+export * from './MigrationStatusCommand.js'
+export * from './MigrationRebaseCommand.js'
+export * from './MigrationSnapshotCommand.js'
+export * from './MigrationVerifySnapshotCommand.js'

package/src/commands/misc/index.ts

@@ -1 +1 @@
-export * from './VersionCommand'
+export * from './VersionCommand.js'

package/src/commands/project/ProjectGenerateDocumentationCommand.ts

@@ -1,9 +1,9 @@
 import { Command, CommandConfiguration, Input } from '@contember/cli-common'
-import { renderProjectInfoHtml } from '../../lib/project/docs/projectDescribe'
+import { renderProjectInfoHtml } from '../../lib/project/docs/projectDescribe.js'
 import { writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
-import { SchemaLoader } from '../../lib/schema/SchemaLoader'
-import { validateSchemaAndPrintErrors } from '../../lib/schema/SchemaValidationHelper'
+import { SchemaLoader } from '../../lib/schema/SchemaLoader.js'
+import { validateSchemaAndPrintErrors } from '../../lib/schema/SchemaValidationHelper.js'
 import { SchemaVersionBuilder } from '@contember/migrations-client'
 
 type Args = {}

package/src/commands/project/ProjectPrintSchemaCommand.ts

@@ -10,9 +10,9 @@ import {
 import { printSchema } from 'graphql'
 import { mergeSchemas } from '@graphql-tools/schema'
 import { emptySchema, normalizeSchema } from '@contember/schema-utils'
-import { SchemaLoader } from '../../lib/schema/SchemaLoader'
+import { SchemaLoader } from '../../lib/schema/SchemaLoader.js'
 import { SchemaVersionBuilder } from '@contember/migrations-client'
-import { validateSchemaAndPrintErrors } from '../../lib/schema/SchemaValidationHelper'
+import { validateSchemaAndPrintErrors } from '../../lib/schema/SchemaValidationHelper.js'
 
 type Args = {}
 

package/src/commands/project/ProjectValidateCommand.ts

@@ -1,8 +1,8 @@
 import { Command, CommandConfiguration } from '@contember/cli-common'
 import { emptySchema } from '@contember/schema-utils'
-import { SchemaLoader } from '../../lib/schema/SchemaLoader'
-import { validateSchemaAndPrintErrors } from '../../lib/schema/SchemaValidationHelper'
-import { MigrationsValidator } from '../../lib/migrations/MigrationsValidator'
+import { SchemaLoader } from '../../lib/schema/SchemaLoader.js'
+import { validateSchemaAndPrintErrors } from '../../lib/schema/SchemaValidationHelper.js'
+import { MigrationsValidator } from '../../lib/migrations/MigrationsValidator.js'
 import { MigrationsResolver, SchemaVersionBuilder } from '@contember/migrations-client'
 import { SchemaDiffer } from '@contember/schema-migrations'
 

package/src/commands/project/index.ts

@@ -1,3 +1,3 @@
-export * from './ProjectGenerateDocumentationCommand'
-export * from './ProjectPrintSchemaCommand'
-export * from './ProjectValidateCommand'
+export * from './ProjectGenerateDocumentationCommand.js'
+export * from './ProjectPrintSchemaCommand.js'
+export * from './ProjectValidateCommand.js'