@uql/core 3.7.8 → 3.7.10

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.10](https://github.com/rogerpadilla/uql/compare/@uql/core@3.7.9...@uql/core@3.7.10) (2026-01-05)
 
 
 ### Features
 
-* Enhance `autoSync` safety by logging warnings for skipped column alterations and drops in safe mode. ([0f61662](https://github.com/rogerpadilla/uql/commit/0f61662f5b82a9947c5e3e7651789ee4e731259c))
+* Integrate jiti for robust TypeScript configuration loading and update migration tool paths to `@uql/core/migrate`. ([8bc4971](https://github.com/rogerpadilla/uql/commit/8bc497128d4bc35c8dfdf01a48d7b1e3ac2d08d6))
 
 
 
@@ -20,9 +20,15 @@ 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.10] - 2026-01-04
+### Improvements
+- **Robust Config Loading**: Integrated `jiti` into the CLI configuration loader. This allows `uql-migrate` to natively support TypeScript configuration files (`uql.config.ts`) and properly resolve ESM/CJS interop logic across all node environments (Node.js, Bun, etc.) without requiring custom runtime flags.
+
+## [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
@@ -119,7 +125,7 @@ Reflect major changes in the package structure and dependencies.
 - **Package Unification**: Unified all database adapters (`mysql`, `postgres`, `maria`, `sqlite`, `mongo`) and `express` middleware into a single core package: `@uql/core`.
 - **Scoped Naming**:
   - `@uql/core`: The main ORM engine and all database adapters.
-  - `@uql/migrate`: The database migration system (formerly `nukak-migrate`).
+  - `@uql/core/migrate`: The database migration system (formerly `nukak-migrate`).
 - **Improved API Surface**:
   - Database-specific logic is now accessible via sub-paths (e.g., `import { ... } from '@uql/core/postgres'`).
   - Unified `NamingStrategy` and `QueryContext` across all unified adapters.

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/migrate/cli-config.js

@@ -1,7 +1,8 @@
 import { stat } from 'node:fs/promises';
 import { resolve } from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { createJiti } from 'jiti';
 export async function loadConfig(customPath) {
+    const jiti = createJiti(process.cwd());
     if (customPath) {
         const fullPath = resolve(process.cwd(), customPath);
         const exists = await stat(fullPath)
@@ -10,10 +11,9 @@ export async function loadConfig(customPath) {
         if (!exists) {
             throw new Error(`Could not find uql configuration file at ${customPath}`);
         }
-        const fileUrl = pathToFileURL(fullPath).href;
         try {
-            const config = await import(fileUrl);
-            return config.default ?? config;
+            const config = await jiti.import(fullPath, { default: true });
+            return config;
         }
         catch (error) {
             throw new Error(`Could not load configuration file at ${customPath}: ${error.message}`);
@@ -26,9 +26,8 @@ export async function loadConfig(customPath) {
             .then(() => true)
             .catch(() => false);
         if (exists) {
-            const fileUrl = pathToFileURL(fullPath).href;
-            const config = await import(fileUrl);
-            return config.default ?? config;
+            const config = await jiti.import(fullPath, { default: true });
+            return config;
         }
     }
     throw new Error('Could not find uql configuration file. Create a uql.config.ts or uql.config.js file in your project root.');

package/dist/migrate/cli-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-config.js","sourceRoot":"","sources":["../../src/migrate/cli-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAmB;IAClD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;aAChC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;aAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAEtB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4CAA4C,UAAU,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,wCAAwC,UAAU,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IAEnG,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;aAChC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;aAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAEtB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;YAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,2GAA2G,CAC5G,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cli-config.js","sourceRoot":"","sources":["../../src/migrate/cli-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAGlC,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAmB;IAClD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEvC,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;aAChC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;aAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAEtB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4CAA4C,UAAU,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,OAAO,MAAgB,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,wCAAwC,UAAU,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IAEnG,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;aAChC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;aAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAEtB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,OAAO,MAAgB,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,2GAA2G,CAC5G,CAAC;AACJ,CAAC"}

package/dist/migrate/cli.js

@@ -195,9 +195,9 @@ export async function runSync(migrator, args) {
 }
 export function printHelp() {
     console.log(`
-@uql/migrate - Database migration tool for uql ORM
+@uql/core/migrate - Database migration tool for uql ORM
 
-Usage: @uql/migrate <command> [options]
+Usage: @uql/core/migrate <command> [options]
 
 Commands:
   up                    Run all pending migrations
@@ -235,13 +235,13 @@ Configuration:
   };
 
 Examples:
-  @uql/migrate up
-  @uql/migrate up --step 1
-  @uql/migrate down
-  @uql/migrate down --step 3
-  @uql/migrate status
-  @uql/migrate generate add_users_table
-  @uql/migrate generate:entities initial_schema
+  @uql/core/migrate up
+  @uql/core/migrate up --step 1
+  @uql/core/migrate down
+  @uql/core/migrate down --step 3
+  @uql/core/migrate status
+  @uql/core/migrate generate add_users_table
+  @uql/core/migrate generate:entities initial_schema
 `);
 }
 //# sourceMappingURL=cli.js.map

package/dist/migrate/migrator.js

@@ -554,7 +554,7 @@ export class Migrator {
      * Generate migration file content
      */
     generateMigrationContent(name) {
-        return /*ts*/ `import type { SqlQuerier } from '@uql/migrate';
+        return /*ts*/ `import type { SqlQuerier } from '@uql/core/migrate';
 
 /**
  * Migration: ${name}
@@ -588,7 +588,7 @@ export default {
     generateMigrationContentWithStatements(name, upStatements, downStatements) {
         const upSql = upStatements.map((s) => /*ts*/ `    await querier.run(\`${s}\`);`).join('\n');
         const downSql = downStatements.map((s) => /*ts*/ `    await querier.run(\`${s}\`);`).join('\n');
-        return /*ts*/ `import type { SqlQuerier } from '@uql/migrate';
+        return /*ts*/ `import type { SqlQuerier } from '@uql/core/migrate';
 
 /**
  * Migration: ${name}

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.10",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -51,6 +51,7 @@
     "clean": "rimraf dist *.tsbuildinfo"
   },
   "dependencies": {
+    "jiti": "^2.6.1",
     "reflect-metadata": "^0.2.2",
     "sqlstring": "^2.3.3",
     "sqlstring-sqlite": "^0.1.1",
@@ -143,5 +144,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "15a12993333878861d0594b8d93746caacf2d6e5"
+  "gitHead": "53a8ef0e2eb62d6e236262a4552f998d77dbd5bb"
 }