@holo-js/kernel 0.3.23 → 0.3.25

package/dist/index.d.ts

@@ -123,6 +123,78 @@ declare function loadHoloPluginDefinitions(projectRoot: string, packageNames: re
 declare function loadHoloPluginContributionModules(projectRoot: string, plugins: readonly LoadedHoloPluginDefinition[], scope: string, key: string, options?: PluginLoadOptions): Promise<readonly HoloPluginRuntimeModule[]>;
 declare function loadHoloPluginBootModules(projectRoot: string, plugins: readonly LoadedHoloPluginDefinition[], options?: PluginLoadOptions): Promise<readonly HoloPluginRuntimeModule[]>;
 
+type TransactionScopeKind = 'root' | 'transaction' | 'savepoint';
+interface ConcurrencyOptions {
+    maxConcurrentQueries?: number;
+    queueLimit?: number;
+    workerThreads?: boolean;
+}
+interface QueryStartLog {
+    kind: 'query' | 'execute';
+    connectionName: string;
+    sql: string;
+    bindings: unknown[];
+    source?: string;
+    scope: TransactionScopeKind;
+    schedulingMode?: 'concurrent' | 'serialized' | 'worker';
+}
+interface QuerySuccessLog extends QueryStartLog {
+    durationMs: number;
+    rowCount?: number;
+    affectedRows?: number;
+}
+interface QueryErrorLog extends QueryStartLog {
+    durationMs: number;
+    error: unknown;
+}
+interface TransactionLog {
+    scope: Exclude<TransactionScopeKind, 'root'>;
+    depth: number;
+    savepointName?: string;
+}
+interface MigrationStartLog {
+    connectionName: string;
+    migrationName: string;
+    action: 'up' | 'down';
+    batch?: number;
+}
+interface MigrationSuccessLog extends MigrationStartLog {
+    durationMs: number;
+}
+interface MigrationErrorLog extends MigrationStartLog {
+    durationMs: number;
+    error: unknown;
+}
+interface SeederStartLog {
+    connectionName: string;
+    seederName: string;
+    quietly: boolean;
+    environment?: string;
+}
+interface SeederSuccessLog extends SeederStartLog {
+    durationMs: number;
+}
+interface SeederErrorLog extends SeederStartLog {
+    durationMs: number;
+    error: unknown;
+}
+interface DatabaseLogger {
+    onQueryStart?(entry: QueryStartLog): void | Promise<void>;
+    onQuerySuccess?(entry: QuerySuccessLog): void | Promise<void>;
+    onQueryError?(entry: QueryErrorLog): void | Promise<void>;
+    onTransactionStart?(entry: TransactionLog): void | Promise<void>;
+    onTransactionCommit?(entry: TransactionLog): void | Promise<void>;
+    onTransactionRollback?(entry: TransactionLog & {
+        error?: unknown;
+    }): void | Promise<void>;
+    onMigrationStart?(entry: MigrationStartLog): void | Promise<void>;
+    onMigrationSuccess?(entry: MigrationSuccessLog): void | Promise<void>;
+    onMigrationError?(entry: MigrationErrorLog): void | Promise<void>;
+    onSeederStart?(entry: SeederStartLog): void | Promise<void>;
+    onSeederSuccess?(entry: SeederSuccessLog): void | Promise<void>;
+    onSeederError?(entry: SeederErrorLog): void | Promise<void>;
+}
+
 type HoloDatabaseDriver = 'sqlite' | 'postgres' | 'mysql';
 interface HoloProjectPaths {
     models: string;
@@ -149,9 +221,16 @@ interface HoloProjectConnectionConfig {
     filename?: string;
     schema?: string;
     ssl?: boolean | Record<string, unknown>;
+    max?: number;
+    connectionTimeoutMillis?: number;
+    idleTimeoutMillis?: number;
+    application_name?: string;
+    concurrency?: ConcurrencyOptions;
+    logger?: DatabaseLogger;
     logging?: boolean;
     security?: {
         allowUnsafeRawSql?: boolean;
+        debugSqlInLogs?: boolean;
     };
 }
 interface HoloProjectDatabaseConfig {
@@ -330,4 +409,4 @@ declare function resolveNormalizedRedisConnection(config: NormalizedHoloRedisCon
 declare function normalizeRedisConfig(config?: HoloRedisConfig): NormalizedHoloRedisConfig;
 declare function defineRedisConfig<TConfig extends HoloRedisConfig>(config: TConfig): Readonly<TConfig>;
 
-export { DEFAULT_HOLO_PROJECT_PATHS, DEFAULT_REDIS_CONNECTION, DEFAULT_REDIS_DB, DEFAULT_REDIS_HOST, DEFAULT_REDIS_PORT, HOLO_PROJECT_PREPARE_API_VERSION, type HoloDatabaseDriver, type HoloGeneratedProjectArtifact, type HoloManagedProjectArtifact, type HoloPluginBroadcastContributions, type HoloPluginCacheContributions, type HoloPluginCliContributions, type HoloPluginConfigContributions, type HoloPluginContributions, type HoloPluginDefinition, type HoloPluginDependencyContributions, type HoloPluginFrameworkContribution, type HoloPluginFrameworkTsconfigKind, type HoloPluginMailContributions, type HoloPluginMigrationContributions, type HoloPluginNotificationContributions, type HoloPluginPackageManager, type HoloPluginProjectContributions, type HoloPluginQueueContributions, type HoloPluginRuntimeContributions, type HoloPluginRuntimeMapContributions, type HoloPluginRuntimeModule, type HoloProjectArtifactContents, type HoloProjectConfig, type HoloProjectConnectionConfig, type HoloProjectDatabaseConfig, type HoloProjectPaths, type HoloProjectPrepareChange, type HoloProjectPrepareChangeKind, type HoloProjectPrepareCommand, type HoloProjectPrepareContext, type HoloProjectPrepareDiagnostic, HoloProjectPrepareError, type HoloProjectPrepareFailure, type HoloProjectPrepareFramework, type HoloProjectPrepareFullRetry, type HoloProjectPrepareLogger, type HoloProjectPrepareModule, type HoloProjectPreparePlugin, type HoloProjectPrepareResult, type HoloProjectPrepareRun, type HoloProjectPrepareSource, type HoloProjectPrepareWatch, type HoloProjectPreparedResult, type HoloProjectPreparer, type HoloRedisClusterNodeConfig, type HoloRedisConfig, type HoloRedisConnectionConfig, type LoadedHoloPluginDefinition, type NormalizedHoloProjectConfig, type NormalizedHoloRedisClusterNodeConfig, type NormalizedHoloRedisConfig, type NormalizedHoloRedisConnectionConfig, type PluginLoadOptions, type RuntimeContribution, RuntimeLifecycle, type RuntimeLifecycleContext, createRuntimeLifecycle, defineHoloPlugin, defineHoloProject, defineHoloProjectPreparer, defineRedisConfig, holoRedisDefaults, loadHoloPluginBootModules, loadHoloPluginContributionModules, loadHoloPluginDefinitions, normalizeHoloPluginDefinition, normalizeHoloProjectConfig, normalizeRedisConfig, resolveHoloPluginModulePath, resolveNormalizedRedisConnection };
+export { type ConcurrencyOptions, DEFAULT_HOLO_PROJECT_PATHS, DEFAULT_REDIS_CONNECTION, DEFAULT_REDIS_DB, DEFAULT_REDIS_HOST, DEFAULT_REDIS_PORT, type DatabaseLogger, HOLO_PROJECT_PREPARE_API_VERSION, type HoloDatabaseDriver, type HoloGeneratedProjectArtifact, type HoloManagedProjectArtifact, type HoloPluginBroadcastContributions, type HoloPluginCacheContributions, type HoloPluginCliContributions, type HoloPluginConfigContributions, type HoloPluginContributions, type HoloPluginDefinition, type HoloPluginDependencyContributions, type HoloPluginFrameworkContribution, type HoloPluginFrameworkTsconfigKind, type HoloPluginMailContributions, type HoloPluginMigrationContributions, type HoloPluginNotificationContributions, type HoloPluginPackageManager, type HoloPluginProjectContributions, type HoloPluginQueueContributions, type HoloPluginRuntimeContributions, type HoloPluginRuntimeMapContributions, type HoloPluginRuntimeModule, type HoloProjectArtifactContents, type HoloProjectConfig, type HoloProjectConnectionConfig, type HoloProjectDatabaseConfig, type HoloProjectPaths, type HoloProjectPrepareChange, type HoloProjectPrepareChangeKind, type HoloProjectPrepareCommand, type HoloProjectPrepareContext, type HoloProjectPrepareDiagnostic, HoloProjectPrepareError, type HoloProjectPrepareFailure, type HoloProjectPrepareFramework, type HoloProjectPrepareFullRetry, type HoloProjectPrepareLogger, type HoloProjectPrepareModule, type HoloProjectPreparePlugin, type HoloProjectPrepareResult, type HoloProjectPrepareRun, type HoloProjectPrepareSource, type HoloProjectPrepareWatch, type HoloProjectPreparedResult, type HoloProjectPreparer, type HoloRedisClusterNodeConfig, type HoloRedisConfig, type HoloRedisConnectionConfig, type LoadedHoloPluginDefinition, type MigrationErrorLog, type MigrationStartLog, type MigrationSuccessLog, type NormalizedHoloProjectConfig, type NormalizedHoloRedisClusterNodeConfig, type NormalizedHoloRedisConfig, type NormalizedHoloRedisConnectionConfig, type PluginLoadOptions, type QueryErrorLog, type QueryStartLog, type QuerySuccessLog, type RuntimeContribution, RuntimeLifecycle, type RuntimeLifecycleContext, type SeederErrorLog, type SeederStartLog, type SeederSuccessLog, type TransactionLog, type TransactionScopeKind, createRuntimeLifecycle, defineHoloPlugin, defineHoloProject, defineHoloProjectPreparer, defineRedisConfig, holoRedisDefaults, loadHoloPluginBootModules, loadHoloPluginContributionModules, loadHoloPluginDefinitions, normalizeHoloPluginDefinition, normalizeHoloProjectConfig, normalizeRedisConfig, resolveHoloPluginModulePath, resolveNormalizedRedisConnection };

package/dist/index.mjs

@@ -81,7 +81,7 @@ function createRuntimeLifecycle(contributions) {
 
 // src/plugins.ts
 import { createRequire } from "module";
-import { readFile } from "fs/promises";
+import { readFile, realpath } from "fs/promises";
 import { dirname, isAbsolute, join, relative, resolve } from "path";
 import { pathToFileURL } from "url";
 function isRecord(value) {
@@ -176,7 +176,7 @@ async function loadHoloPluginDefinitions(projectRoot, packageNames, options = {}
     }
     const entry = normalizeString(manifest.holo.plugin);
     assertPackageRelativePath(packageName, entry);
-    const packageRoot = dirname(packageJsonPath);
+    const packageRoot = await realpath(dirname(packageJsonPath));
     const entryPath = resolve(packageRoot, entry);
     const relativeEntry = relative(packageRoot, entryPath);
     if (relativeEntry.startsWith("..") || isAbsolute(relativeEntry)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holo-js/kernel",
-  "version": "0.3.23",
+  "version": "0.3.25",
   "description": "Holo-JS Framework - dependency-free contracts, plugins, and runtime lifecycle",
   "type": "module",
   "license": "MIT",