@uql/core 3.7.8 → 3.7.9

package/CHANGELOG.md

@@ -3,12 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
-## [3.7.8](https://github.com/rogerpadilla/uql/compare/@uql/core@3.7.7...@uql/core@3.7.8) (2026-01-04)
+## [3.7.9](https://github.com/rogerpadilla/uql/compare/@uql/core@3.7.8...@uql/core@3.7.9) (2026-01-04)
 
 
 ### Features
 
-* Enhance `autoSync` safety by logging warnings for skipped column alterations and drops in safe mode. ([0f61662](https://github.com/rogerpadilla/uql/commit/0f61662f5b82a9947c5e3e7651789ee4e731259c))
+* Disable chat input and show loading state during message send and update operations. ([06b824b](https://github.com/rogerpadilla/uql/commit/06b824b79e2ab1f771ec79481e8d9cb1db159982))
 
 
 
@@ -20,9 +20,11 @@ All notable changes to this project will be documented in this file. Please add
 
 date format is [yyyy-mm-dd]
 
-## [3.7.8] - 2026-01-04
-### Refined AutoSync Safety
-- **Transparent Safety Feedback**: In safe mode, `autoSync` now explicitly logs detailed messages via the new `skippedMigration` log level for skipped column alterations and drops, providing developers with clear visibility into pending schema changes that require manual intervention or migration.
+## [3.7.9] - 2026-01-04
+- **Manual Migrations**: Updated the root README to explicitly document the `generate` command for creating manual incremental migrations (`npx uql-migrate generate <name>`), ensuring developers know how to create empty migration files efficiently.
+
+### Bug Fixes
+- **CLI Entry Point**: Fixed a critical issue where the `uql-migrate` command would silently fail in certain environments (e.g., when run via `npx` or symlinks) due to brittle entry point detection. The CLI now reliably executes regardless of how it is invoked.
 
  ## [3.7.7] - 2026-01-04
  ### Refined Foreign Key Handling & Control

package/README.md

@@ -243,7 +243,7 @@ export const pool = new PgQuerierPool(
 
 export default {
   pool,
-  // entities: [User, Profile, Post], // Optional: inferred from @Entity() decorators
+  entities: [User, Profile, Post],
   migrationsPath: './migrations',
 } satisfies Config;
 ```
@@ -355,7 +355,7 @@ import type { Config } from '@uql/core';
 
 export default {
   pool: new PgQuerierPool({ /* ... */ }),
-  // entities: [User, Post], // Optional: inferred from @Entity() decorators
+  entities: [User, Profile, Post],
   migrationsPath: './migrations',
 } satisfies Config;
 ```
@@ -364,14 +364,33 @@ export default {
 
 ### 2. Manage via CLI
 
+
+Use the CLI to manage your database schema evolution.
+
+| Command | Description |
+| :--- | :--- |
+| `generate <name>` | Creates an empty timestamped file for **manual** SQL migrations (e.g., data backfills). |
+| `generate:entities <name>` | **Auto-generates** a migration by diffing your entities against the current DB schema. |
+| `up` | Applies all pending migrations. |
+| `down` | Rolls back the last applied migration batch. |
+| `status` | Shows which migrations have been executed and which are pending. |
+
+#### Usage Examples
+
 ```bash
-# Generate from entities
-npx uql-migrate generate:entities initial_schema
-# Run pending
+# 1. Create a manual migration
+npx uql-migrate generate seed_default_roles
+
+# 2. Auto-generate schema changes from your code
+npx uql-migrate generate:entities add_profile_table
+
+# 3. Apply changes
 npx uql-migrate up
-# Rollback last migration
+
+# 4. Revert changes if needed
 npx uql-migrate down
-# Using a custom config path
+
+# 5. Run with custom config
 npx uql-migrate up --config ./configs/uql.config.ts
 ```
 

package/dist/migrate/bin.d.ts

@@ -1,5 +1,3 @@
 #!/usr/bin/env node
-export declare const _scriptLogic: {
-    isMain: boolean;
-};
+export {};
 //# sourceMappingURL=bin.d.ts.map

package/dist/migrate/bin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/migrate/bin.ts"],"names":[],"mappings":";AAkBA,eAAO,MAAM,YAAY;;CAAa,CAAC"}
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/migrate/bin.ts"],"names":[],"mappings":""}

package/dist/migrate/bin.js

@@ -1,17 +1,7 @@
 #!/usr/bin/env node
-import { pathToFileURL } from 'node:url';
 import { main } from './cli.js';
-/**
- * Check if the current module is being run as the main script (entry point).
- * This allows the file to be both imported as a library and executed as a standalone CLI tool.
- */
-const isMain = import.meta.url === pathToFileURL(process.argv[1]).href;
-if (isMain) {
-    main(process.argv.slice(2)).catch((err) => {
-        console.error(err);
-        process.exit(1);
-    });
-}
-// Export for testing
-export const _scriptLogic = { isMain };
+main(process.argv.slice(2)).catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
 //# sourceMappingURL=bin.js.map

package/dist/migrate/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/migrate/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAEvE,IAAI,MAAM,EAAE,CAAC;IACX,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACxC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qBAAqB;AACrB,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/migrate/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/type/config.d.ts

@@ -2,12 +2,39 @@ import type { NamingStrategy } from './namingStrategy.js';
 import type { Dialect } from './querier.js';
 import type { QuerierPool } from './querierPool.js';
 import type { Type } from './utility.js';
+/**
+ * Configuration options for the UQL ORM and Migrator.
+ */
 export interface Config {
-    pool?: QuerierPool;
+    /**
+     * The connection pool used to interact with the database.
+     * This is required for both the application and the migrations CLI.
+     */
+    pool: QuerierPool;
+    /**
+     * List of entity classes to be managed by the ORM.
+     * If not provided, UQL will attempt to infer them from the `@Entity` decorators if `emitDecoratorMetadata` is enabled.
+     */
+    entities?: Type<unknown>[];
+    /**
+     * The directory where migration files are stored.
+     * @default './migrations'
+     */
     migrationsPath?: string;
+    /**
+     * The name of the table used to track executed migrations in the database.
+     * @default 'uql_migrations'
+     */
     tableName?: string;
+    /**
+     * The SQL dialect to be used (e.g., 'postgres', 'mysql', 'sqlite').
+     * If not provided, it is inferred from the `pool` instance.
+     */
     dialect?: Dialect;
-    entities?: Type<unknown>[];
+    /**
+     * The naming strategy for mapping class/property names to database table/column names.
+     * @default DefaultNamingStrategy (camelCase -> camelCase)
+     */
     namingStrategy?: NamingStrategy;
 }
 //# sourceMappingURL=config.d.ts.map

package/dist/type/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/type/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/type/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC"}

package/package.json

@@ -3,7 +3,7 @@
   "homepage": "https://uql.app",
   "description": "One Language. Frontend to Backend.",
   "license": "MIT",
-  "version": "3.7.8",
+  "version": "3.7.9",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -143,5 +143,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "15a12993333878861d0594b8d93746caacf2d6e5"
+  "gitHead": "7008a9dd2dcaaac969d077c4d8030b0b6d1354d3"
 }