@carno.js/cli 0.1.61

package/README.md

@@ -0,0 +1,109 @@
+## Carno.js CLI
+The CLI (Command Line Interface) for Carno.js.
+
+### Instalação
+To install, you can use npm or bun:
+```bash
+bun install @carnojs/cli
+```
+
+### Uso
+Você pode usar a CLI com npx ou bunx.
+
+### Gerar uma nova migração
+Para gerar uma nova migração, use o comando 
+```bash
+bunx cli migration:generate
+```
+Isso irá gerar um novo arquivo de migração com apenas as diferenças desde a última migration.
+
+Partial indexes (Postgres) definidos nas entidades também são gerados automaticamente no SQL de migration. Em MySQL, predicates em índices não são suportados.
+
+#### Sistema de Snapshot
+O CLI mantém um arquivo `schema-snapshot.json` no diretório de migrations que armazena o estado atual do schema. Isso garante que:
+- Apenas as mudanças desde a última migration sejam geradas
+- Não há regeneração de queries já executadas
+- O histórico de mudanças é mantido de forma incremental
+
+O snapshot é atualizado automaticamente após cada migration gerada.
+
+### Executar todas as migrações pendentes
+Para executar todas as migrações pendentes, use o comando 
+```bash
+bunx cli migration:run
+```
+
+### Exemplo de Fluxo de Trabalho
+
+```bash
+# 1. Defina suas entidades
+# src/entities/user.entity.ts
+@Entity()
+class User extends BaseEntity {
+  @PrimaryKey()
+  id: number;
+  
+  @Property()
+  email: string;
+}
+
+# 2. Gere a primeira migration
+bunx cli migration:generate
+# Cria: database/migrations/migration_20231021120000.sql
+# Cria: database/migrations/schema-snapshot.json
+
+# 3. Execute a migration
+bunx cli migration:run
+
+# 4. Adicione uma nova coluna
+@Entity()
+class User extends BaseEntity {
+  @PrimaryKey()
+  id: number;
+  
+  @Property()
+  email: string;
+  
+  @Property()
+  password: string;  // Nova coluna
+}
+
+# 5. Gere apenas o diff
+bunx cli migration:generate
+# Cria: database/migrations/migration_20231021120100.sql
+# Atualiza: database/migrations/schema-snapshot.json
+# Contém apenas: ALTER TABLE user ADD COLUMN password...
+
+# 6. Execute a nova migration
+bunx cli migration:run
+```
+
+### Troubleshooting
+
+#### Erro: "undefined is not an object (evaluating 'bdCol.type.includes')"
+Este erro ocorre quando o snapshot está corrompido ou incompleto. O CLI agora detecta e limpa automaticamente snapshots corrompidos. Se o problema persistir:
+
+1. Delete o arquivo `schema-snapshot.json` do diretório de migrations
+2. Execute `bunx carno migration:generate` novamente
+3. O snapshot será recriado do zero
+
+#### Snapshot Corrompido
+Se você suspeita que o snapshot está corrompido (colunas duplicadas, colunas sem type, etc.):
+
+```bash
+# Opção 1: Deixe o CLI limpar automaticamente
+bunx carno migration:generate
+
+# Opção 2: Delete e recrie manualmente
+rm src/migrations/schema-snapshot.json
+bunx carno migration:generate
+```
+
+O CLI agora gera snapshots corretamente:
+- ✅ Cada tabela tem apenas suas próprias colunas
+- ✅ Não há duplicação de colunas entre tabelas
+- ✅ Não há warnings desnecessários
+- ✅ Migrations são geradas apenas quando há mudanças reais
+
+### Contribuição
+Contribuições são bem-vindas. Por favor, abra um problema ou faça um pull request com suas mudanças.

package/dist/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env bun
+
+// Load the compiled CLI (CommonJS)
+require('./src/cli.js');

package/dist/cli.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+import 'reflect-metadata';
+import { Command } from 'commander';
+import { Migrator } from './migrator/migrator';
+
+const program = new Command();
+
+program.name('[npx|bunx] cli').description('CLI to Carno.js ORM ');
+
+program
+  .command('migration:generate')
+  .description('generate a new migration file with a diff')
+  .action(async (str, options) => {
+    const migrator = new Migrator();
+    await migrator.generateMigration();
+    process.exit(0);
+  });
+
+program
+  .command('migration:run')
+  .description('run all pending migrations')
+  .action(async (str, options) => {
+    const migrator = new Migrator();
+    await migrator.migrate();
+    process.exit(0);
+  });
+
+program.parse();

package/dist/index.ts

@@ -0,0 +1,5 @@
+import 'reflect-metadata';
+
+export * from './migrator/migrator';
+export * from './migrator/snapshot-manager';
+export * from './migrator/snapshot-cleaner';

package/dist/run-cli.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+node --experimental-modules ./node_modules/@carno.js/cli/dist/cli.js "$@"

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import 'reflect-metadata';

package/dist/src/cli.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const commander_1 = require("commander");
+const migrator_1 = require("./migrator/migrator");
+const program = new commander_1.Command();
+program.name('[npx|bunx] cli').description('CLI to Carno.js ORM ');
+program
+    .command('migration:generate')
+    .description('generate a new migration file with a diff')
+    .action(async (str, options) => {
+    const migrator = new migrator_1.Migrator();
+    await migrator.generateMigration();
+    process.exit(0);
+});
+program
+    .command('migration:run')
+    .description('run all pending migrations')
+    .action(async (str, options) => {
+    const migrator = new migrator_1.Migrator();
+    await migrator.migrate();
+    process.exit(0);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";;;AAEA,4BAA0B;AAC1B,yCAAoC;AACpC,kDAA+C;AAE/C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAEnE,OAAO;KACJ,OAAO,CAAC,oBAAoB,CAAC;KAC7B,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;IAC7B,MAAM,QAAQ,GAAG,IAAI,mBAAQ,EAAE,CAAC;IAChC,MAAM,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,4BAA4B,CAAC;KACzC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;IAC7B,MAAM,QAAQ,GAAG,IAAI,mBAAQ,EAAE,CAAC;IAChC,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+import 'reflect-metadata';
+export * from './migrator/migrator';
+export * from './migrator/snapshot-manager';
+export * from './migrator/snapshot-cleaner';

package/dist/src/index.js

@@ -0,0 +1,21 @@
+"use strict";
+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 });
+require("reflect-metadata");
+__exportStar(require("./migrator/migrator"), exports);
+__exportStar(require("./migrator/snapshot-manager"), exports);
+__exportStar(require("./migrator/snapshot-cleaner"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4BAA0B;AAE1B,sDAAoC;AACpC,8DAA4C;AAC5C,8DAA4C"}

package/dist/src/migrator/diff-calculator.d.ts

@@ -0,0 +1,33 @@
+import { DriverInterface, EntityStorage } from '@carno.js/orm';
+import { ColDiff, ColumnsInfo, SnapshotTable, TableDiff } from './migrator';
+export declare class DiffCalculator {
+    private driver;
+    private entities;
+    constructor(entities: EntityStorage, driver: DriverInterface);
+    diff(snapshotBd: SnapshotTable[], snapshotEntities: SnapshotTable[]): TableDiff[];
+    private checkIndexes;
+    private checkUniques;
+    private buildUniqueTable;
+    private uniqueChanged;
+    private normalizeUniqueColumns;
+    private formatUniqueName;
+    private buildIndexTable;
+    private buildIndexChangeDiff;
+    private indexChanged;
+    private normalizeIndexColumns;
+    private normalizeIndexWhere;
+    private cleanIndexToken;
+    private formatIndexName;
+    private createNewColumn;
+    private diffColumnType;
+    private normalizeType;
+    private diffColumnDefault;
+    private diffColumnPrimary;
+    private diffColumnUnique;
+    private diffForeignKey;
+    private diffColumnSql;
+    diffColumnPrecisionAndScale(bdCol: ColumnsInfo, entityCol: ColumnsInfo, colDiffs: ColDiff[]): void;
+    private diffColumnNullable;
+    private convertEntityTypeToSqlType;
+    private diffEnum;
+}