chkit 0.1.0-beta.21 → 0.1.0-beta.22

package/dist/runtime/migration-store.js

@@ -0,0 +1,60 @@
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import fg from 'fast-glob';
+import { canonicalizeDefinitions } from '@chkit/core';
+function parseJSONOrThrow(raw, filePath, kind) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Invalid ${kind} JSON at ${filePath}. Fix or remove the file and retry.`);
+    }
+}
+export async function readSnapshot(metaDir) {
+    const file = join(metaDir, 'snapshot.json');
+    if (!existsSync(file))
+        return null;
+    const raw = await readFile(file, 'utf8');
+    const parsed = parseJSONOrThrow(raw, file, 'snapshot');
+    return {
+        version: 1,
+        generatedAt: parsed.generatedAt ?? '',
+        definitions: canonicalizeDefinitions(parsed.definitions ?? []),
+    };
+}
+export function summarizePlan(operations) {
+    return operations.map((op) => `${op.type} [${op.risk}] ${op.key}`);
+}
+export async function listMigrations(migrationsDir) {
+    const files = await fg('*.sql', { cwd: migrationsDir, onlyFiles: true });
+    return files.sort();
+}
+function checksum(value) {
+    return createHash('sha256').update(value, 'utf8').digest('hex');
+}
+export async function findChecksumMismatches(migrationsDir, journal) {
+    const mismatches = [];
+    for (const entry of journal.applied) {
+        if (!entry.checksum)
+            continue;
+        const fullPath = join(migrationsDir, entry.name);
+        if (!existsSync(fullPath))
+            continue;
+        const sql = await readFile(fullPath, 'utf8');
+        const actual = checksum(sql);
+        if (actual !== entry.checksum) {
+            mismatches.push({
+                name: entry.name,
+                expected: entry.checksum,
+                actual,
+            });
+        }
+    }
+    return mismatches;
+}
+export function checksumSQL(value) {
+    return checksum(value);
+}
+//# sourceMappingURL=migration-store.js.map

package/dist/runtime/migration-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-store.js","sourceRoot":"","sources":["../../src/runtime/migration-store.ts"],"names":[],"mappings":"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"}

package/dist/runtime/plugin-runtime/errors.d.ts

@@ -0,0 +1,3 @@
+export declare function formatPluginError(pluginName: string, hook: string, error: unknown): Error;
+export declare function guardHook<T>(pluginName: string, hookName: string, fn: () => Promise<T> | T): Promise<T>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/runtime/plugin-runtime/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/errors.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,KAAK,CAGP;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAMZ"}

package/dist/runtime/plugin-runtime/errors.js

@@ -0,0 +1,13 @@
+export function formatPluginError(pluginName, hook, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return new Error(`Plugin "${pluginName}" failed in ${hook}: ${message}`);
+}
+export async function guardHook(pluginName, hookName, fn) {
+    try {
+        return await fn();
+    }
+    catch (error) {
+        throw formatPluginError(pluginName, hookName, error);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/runtime/plugin-runtime/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/errors.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,IAAY,EACZ,KAAc;IAEd,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,OAAO,IAAI,KAAK,CAAC,WAAW,UAAU,eAAe,IAAI,KAAK,OAAO,EAAE,CAAC,CAAA;AAC1E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,UAAkB,EAClB,QAAgB,EAChB,EAAwB;IAExB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAA;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,iBAAiB,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAA;IACtD,CAAC;AACH,CAAC"}

package/dist/runtime/plugin-runtime/executor-debug.d.ts

@@ -0,0 +1,3 @@
+import type { ClickHouseExecutor } from '@chkit/clickhouse';
+export declare function wrapExecutorWithDebug(executor: ClickHouseExecutor): ClickHouseExecutor;
+//# sourceMappingURL=executor-debug.d.ts.map

package/dist/runtime/plugin-runtime/executor-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-debug.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/executor-debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AA6B3D,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,kBAAkB,GAC3B,kBAAkB,CAwEpB"}

package/dist/runtime/plugin-runtime/executor-debug.js

@@ -0,0 +1,65 @@
+import { debug, isDebugEnabled } from '../debug.js';
+function truncate(sql) {
+    return sql.length > 200 ? `${sql.slice(0, 200)}...` : sql;
+}
+async function trace(label, describeOk, fn) {
+    const start = performance.now();
+    try {
+        const result = await fn();
+        const detail = describeOk ? ` — ${describeOk(result)}` : '';
+        debug('clickhouse', `${label} OK${detail} (${Math.round(performance.now() - start)}ms)`);
+        return result;
+    }
+    catch (error) {
+        debug('clickhouse', `${label} FAILED (${Math.round(performance.now() - start)}ms)`, error instanceof Error ? error.message : error);
+        throw error;
+    }
+}
+export function wrapExecutorWithDebug(executor) {
+    if (!isDebugEnabled())
+        return executor;
+    const queryJson = executor.queryJson?.bind(executor);
+    return {
+        command(sql) {
+            debug('clickhouse', `command: ${truncate(sql)}`);
+            return trace('command', null, () => executor.command(sql));
+        },
+        query(sql) {
+            debug('clickhouse', `query: ${truncate(sql)}`);
+            return trace('query', (rows) => `${rows.length} rows`, () => executor.query(sql));
+        },
+        ...(queryJson
+            ? {
+                queryJson(sql) {
+                    debug('clickhouse', `queryJson: ${truncate(sql)}`);
+                    return trace('queryJson', (payload) => `${payload.rows} rows`, () => queryJson(sql));
+                },
+            }
+            : {}),
+        insert(params) {
+            debug('clickhouse', `insert into ${params.table} — ${params.values.length} rows`);
+            return trace('insert', null, () => executor.insert(params));
+        },
+        submit(sql, queryId) {
+            debug('clickhouse', `submit${queryId ? ` (id: ${queryId})` : ''}: ${truncate(sql)}`);
+            return trace('submit', (id) => `id: ${id}`, () => executor.submit(sql, queryId));
+        },
+        queryStatus(queryId, options) {
+            debug('clickhouse', `queryStatus for ${queryId}`);
+            return trace('queryStatus', (status) => status.status, () => executor.queryStatus(queryId, options));
+        },
+        listSchemaObjects() {
+            debug('clickhouse', 'listSchemaObjects');
+            return trace('listSchemaObjects', (objects) => `${objects.length} objects`, () => executor.listSchemaObjects());
+        },
+        listTableDetails(databases) {
+            debug('clickhouse', `listTableDetails for databases: [${databases.join(', ')}]`);
+            return trace('listTableDetails', (tables) => `${tables.length} tables`, () => executor.listTableDetails(databases));
+        },
+        async close() {
+            debug('clickhouse', 'closing connections');
+            await executor.close();
+        },
+    };
+}
+//# sourceMappingURL=executor-debug.js.map

package/dist/runtime/plugin-runtime/executor-debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-debug.js","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/executor-debug.ts"],"names":[],"mappings":"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"}

package/dist/runtime/plugin-runtime/hooks.d.ts

@@ -0,0 +1,23 @@
+import { type MigrationPlan } from '@chkit/core';
+import type { ChxOnAfterApplyContext, ChxOnBeforeApplyContext, ChxOnBeforePluginCommandContext, ChxOnBeforePluginCommandResult, ChxOnCheckContext, ChxOnCheckResult, ChxOnCompleteContext, ChxOnConfigLoadedContext, ChxOnInitContext, ChxOnPlanCreatedContext, ChxOnSchemaLoadedContext, LoadedPlugin, TableScope } from '../../plugins.js';
+declare const UNFILTERED_TABLE_SCOPE: TableScope;
+export declare function runOnInit(loaded: LoadedPlugin[], context: Omit<ChxOnInitContext, 'options'>): Promise<void>;
+export declare function runOnComplete(loaded: LoadedPlugin[], context: Omit<ChxOnCompleteContext, 'options' | 'exitCode'> & {
+    exitCode?: number;
+}): Promise<void>;
+export declare function runOnConfigLoaded(loaded: LoadedPlugin[], context: Omit<ChxOnConfigLoadedContext, 'options' | 'tableScope'> & {
+    tableScope?: TableScope;
+}): Promise<void>;
+export declare function runOnSchemaLoaded(loaded: LoadedPlugin[], context: ChxOnSchemaLoadedContext): Promise<import("@chkit/core").SchemaDefinition[]>;
+export declare function runOnPlanCreated(loaded: LoadedPlugin[], context: Omit<ChxOnPlanCreatedContext, 'plan' | 'tableScope'> & {
+    tableScope?: TableScope;
+}, initialPlan: MigrationPlan): Promise<MigrationPlan>;
+export declare function runOnBeforeApply(loaded: LoadedPlugin[], context: ChxOnBeforeApplyContext): Promise<string[]>;
+export declare function runOnAfterApply(loaded: LoadedPlugin[], context: ChxOnAfterApplyContext): Promise<void>;
+export declare function runOnCheck(loaded: LoadedPlugin[], context: Omit<ChxOnCheckContext, 'options' | 'tableScope'> & {
+    tableScope?: TableScope;
+}): Promise<ChxOnCheckResult[]>;
+export declare function runOnCheckReport(byName: Map<string, LoadedPlugin>, results: ChxOnCheckResult[], print: (line: string) => void): Promise<void>;
+export declare function runOnBeforePluginCommand(loaded: LoadedPlugin[], pluginName: string, commandName: string, context: Omit<ChxOnBeforePluginCommandContext, 'targetPlugin' | 'command' | 'options'>): Promise<ChxOnBeforePluginCommandResult>;
+export { UNFILTERED_TABLE_SCOPE };
+//# sourceMappingURL=hooks.d.ts.map

package/dist/runtime/plugin-runtime/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAEzE,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,8BAA8B,EAC9B,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,YAAY,EACZ,UAAU,EACX,MAAM,kBAAkB,CAAA;AAIzB,QAAA,MAAM,sBAAsB,EAAE,UAI7B,CAAA;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAClF,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,YAAY,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GAC9F,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,wBAAwB,qDAsBlC;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,GAAG,YAAY,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,EAC3F,WAAW,EAAE,aAAa,GACzB,OAAO,CAAC,aAAa,CAAC,CAsBxB;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBnB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,YAAY,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,GACvF,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAwB7B;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACjC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC5B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,YAAY,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,IAAI,CAAC,+BAA+B,EAAE,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC,GACrF,OAAO,CAAC,8BAA8B,CAAC,CA6BzC;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAA"}

package/dist/runtime/plugin-runtime/hooks.js

@@ -0,0 +1,148 @@
+import { canonicalizeDefinitions } from '@chkit/core';
+import { debug } from '../debug.js';
+import { guardHook } from './errors.js';
+const UNFILTERED_TABLE_SCOPE = {
+    enabled: false,
+    matchedTables: [],
+    matchCount: 0,
+};
+export async function runOnInit(loaded, context) {
+    for (const item of loaded) {
+        const hook = item.plugin.hooks?.onInit;
+        if (!hook)
+            continue;
+        debug('hook', `onInit → ${item.plugin.manifest.name}`);
+        await guardHook(item.plugin.manifest.name, 'onInit', () => hook({ ...context, options: item.options }));
+    }
+}
+export async function runOnComplete(loaded, context) {
+    const exitCode = context.exitCode ?? 0;
+    for (const item of loaded) {
+        const hook = item.plugin.hooks?.onComplete;
+        if (!hook)
+            continue;
+        debug('hook', `onComplete → ${item.plugin.manifest.name} (exitCode: ${exitCode})`);
+        await guardHook(item.plugin.manifest.name, 'onComplete', () => hook({ ...context, exitCode, options: item.options }));
+    }
+}
+export async function runOnConfigLoaded(loaded, context) {
+    const tableScope = context.tableScope ?? UNFILTERED_TABLE_SCOPE;
+    for (const item of loaded) {
+        const hook = item.plugin.hooks?.onConfigLoaded;
+        if (!hook)
+            continue;
+        debug('hook', `onConfigLoaded → ${item.plugin.manifest.name}`);
+        await guardHook(item.plugin.manifest.name, 'onConfigLoaded', () => hook({ ...context, options: item.options, tableScope }));
+    }
+}
+export async function runOnSchemaLoaded(loaded, context) {
+    let definitions = context.definitions;
+    for (const item of loaded) {
+        const hook = item.plugin.hooks?.onSchemaLoaded;
+        if (!hook)
+            continue;
+        debug('hook', `onSchemaLoaded → ${item.plugin.manifest.name} (${definitions.length} definitions)`);
+        const next = await guardHook(item.plugin.manifest.name, 'onSchemaLoaded', () => hook({ ...context, definitions }));
+        if (Array.isArray(next)) {
+            debug('hook', `onSchemaLoaded ← ${item.plugin.manifest.name} returned ${next.length} definitions`);
+            definitions = canonicalizeDefinitions(next);
+        }
+    }
+    return definitions;
+}
+export async function runOnPlanCreated(loaded, context, initialPlan) {
+    const tableScope = context.tableScope ?? UNFILTERED_TABLE_SCOPE;
+    let plan = initialPlan;
+    for (const item of loaded) {
+        const hook = item.plugin.hooks?.onPlanCreated;
+        if (!hook)
+            continue;
+        debug('hook', `onPlanCreated → ${item.plugin.manifest.name} (${plan.operations.length} operations)`);
+        const next = await guardHook(item.plugin.manifest.name, 'onPlanCreated', () => hook({ ...context, tableScope, plan }));
+        if (next) {
+            debug('hook', `onPlanCreated ← ${item.plugin.manifest.name} modified plan (${next.operations.length} operations)`);
+            plan = next;
+        }
+    }
+    return plan;
+}
+export async function runOnBeforeApply(loaded, context) {
+    let statements = context.statements;
+    for (const item of loaded) {
+        const hook = item.plugin.hooks?.onBeforeApply;
+        if (!hook)
+            continue;
+        debug('hook', `onBeforeApply → ${item.plugin.manifest.name} (${context.migration}, ${statements.length} statements)`);
+        const result = await guardHook(item.plugin.manifest.name, 'onBeforeApply', () => hook({ ...context, statements }));
+        if (result?.statements) {
+            debug('hook', `onBeforeApply ← ${item.plugin.manifest.name} modified statements (${result.statements.length})`);
+            statements = result.statements;
+        }
+    }
+    return statements;
+}
+export async function runOnAfterApply(loaded, context) {
+    for (const item of loaded) {
+        const hook = item.plugin.hooks?.onAfterApply;
+        if (!hook)
+            continue;
+        debug('hook', `onAfterApply → ${item.plugin.manifest.name} (${context.migration})`);
+        await guardHook(item.plugin.manifest.name, 'onAfterApply', () => hook(context));
+    }
+}
+export async function runOnCheck(loaded, context) {
+    const tableScope = context.tableScope ?? UNFILTERED_TABLE_SCOPE;
+    const results = [];
+    for (const item of loaded) {
+        const hook = item.plugin.hooks?.onCheck;
+        if (!hook)
+            continue;
+        debug('hook', `onCheck → ${item.plugin.manifest.name}`);
+        const result = await guardHook(item.plugin.manifest.name, 'onCheck', () => hook({ ...context, options: item.options, tableScope }));
+        if (!result)
+            continue;
+        debug('hook', `onCheck ← ${item.plugin.manifest.name}: ok=${result.ok}, findings=${result.findings.length}`);
+        results.push({
+            plugin: result.plugin || item.plugin.manifest.name,
+            evaluated: result.evaluated,
+            ok: result.ok,
+            findings: result.findings,
+            metadata: result.metadata,
+        });
+    }
+    return results;
+}
+export async function runOnCheckReport(byName, results, print) {
+    for (const result of results) {
+        const item = byName.get(result.plugin);
+        if (!item)
+            continue;
+        const hook = item.plugin.hooks?.onCheckReport;
+        if (!hook)
+            continue;
+        await guardHook(item.plugin.manifest.name, 'onCheckReport', () => hook({ result, print }));
+    }
+}
+export async function runOnBeforePluginCommand(loaded, pluginName, commandName, context) {
+    for (const item of loaded) {
+        if (item.plugin.manifest.name === pluginName)
+            continue;
+        const hook = item.plugin.hooks?.onBeforePluginCommand;
+        if (!hook)
+            continue;
+        debug('hook', `onBeforePluginCommand → ${item.plugin.manifest.name} (target: ${pluginName}:${commandName})`);
+        const result = await guardHook(item.plugin.manifest.name, 'onBeforePluginCommand', () => hook({
+            ...context,
+            targetPlugin: pluginName,
+            command: commandName,
+            options: item.options,
+        }));
+        if (result.handled) {
+            debug('hook', `onBeforePluginCommand ← ${item.plugin.manifest.name} handled command (exitCode: ${result.exitCode})`);
+            return result;
+        }
+    }
+    return { handled: false };
+}
+export { UNFILTERED_TABLE_SCOPE };
+//# sourceMappingURL=hooks.js.map

package/dist/runtime/plugin-runtime/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/hooks.ts"],"names":[],"mappings":"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"}

package/dist/runtime/plugin-runtime/index.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedChxConfig } from '@chkit/core';
+import type { ChxPlugin, PluginRuntime } from '../../plugins.js';
+export declare function loadPluginRuntime(input: {
+    config: ResolvedChxConfig;
+    configPath: string;
+    cliVersion: string;
+    internalPlugins?: ChxPlugin[];
+}): Promise<PluginRuntime>;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/plugin-runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,OAAO,KAAK,EACV,SAAS,EAGT,aAAa,EACd,MAAM,kBAAkB,CAAA;AAwBzB,wBAAsB,iBAAiB,CAAC,KAAK,EAAE;IAC7C,MAAM,EAAE,iBAAiB,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,SAAS,EAAE,CAAA;CAC9B,GAAG,OAAO,CAAC,aAAa,CAAC,CAoKzB"}

package/dist/runtime/plugin-runtime/index.js

@@ -0,0 +1,144 @@
+import { resolve } from 'node:path';
+import { createClickHouseExecutor } from '@chkit/clickhouse';
+import { debug } from '../debug.js';
+import { formatPluginError } from './errors.js';
+import { wrapExecutorWithDebug } from './executor-debug.js';
+import { importPluginModule, normalizePluginRegistration, validatePlugin, } from './loader.js';
+import { NULL_EXECUTOR } from './null-executor.js';
+import { UNFILTERED_TABLE_SCOPE, runOnAfterApply, runOnBeforeApply, runOnBeforePluginCommand, runOnCheck, runOnCheckReport, runOnComplete, runOnConfigLoaded, runOnInit, runOnPlanCreated, runOnSchemaLoaded, } from './hooks.js';
+export async function loadPluginRuntime(input) {
+    const registrations = input.config.plugins ?? [];
+    const loaded = [];
+    const byName = new Map();
+    const configDir = resolve(input.configPath, '..');
+    for (const registration of registrations) {
+        const normalized = normalizePluginRegistration(registration);
+        if (!normalized.enabled)
+            continue;
+        const plugin = normalized.kind === 'inline'
+            ? normalized.inlinePlugin
+            : await importPluginModule(resolve(configDir, normalized.resolvePath));
+        if (!plugin)
+            continue;
+        const sourceLabel = normalized.kind === 'inline'
+            ? `inline registration${normalized.nameHint ? ` (${normalized.nameHint})` : ''}`
+            : resolve(configDir, normalized.resolvePath);
+        validatePlugin(input.cliVersion, plugin, sourceLabel);
+        if (normalized.nameHint && normalized.nameHint !== plugin.manifest.name) {
+            throw new Error(`Plugin name mismatch for ${sourceLabel}: configured "${normalized.nameHint}" but manifest is "${plugin.manifest.name}".`);
+        }
+        if (byName.has(plugin.manifest.name)) {
+            throw new Error(`Duplicate plugin name "${plugin.manifest.name}" in config.plugins.`);
+        }
+        debug('plugin', `loaded "${plugin.manifest.name}" v${plugin.manifest.version ?? '?'}`, {
+            hooks: Object.keys(plugin.hooks ?? {}),
+            commands: (plugin.commands ?? []).map((c) => c.name),
+        });
+        const item = { plugin, options: normalized.options };
+        loaded.push(item);
+        byName.set(plugin.manifest.name, item);
+    }
+    for (const plugin of input.internalPlugins ?? []) {
+        if (byName.has(plugin.manifest.name))
+            continue;
+        const item = { plugin, options: {} };
+        loaded.push(item);
+        byName.set(plugin.manifest.name, item);
+    }
+    return {
+        plugins: loaded,
+        async resolveContext(input) {
+            const hasClickhouseConfig = !!input.config.clickhouse;
+            debug('context', `resolving executor — clickhouse config: ${hasClickhouseConfig ? 'yes' : 'no'}`);
+            const rawExecutor = hasClickhouseConfig
+                ? createClickHouseExecutor(input.config.clickhouse)
+                : NULL_EXECUTOR;
+            const defaults = {
+                executor: wrapExecutorWithDebug(rawExecutor),
+                hasExecutor: hasClickhouseConfig,
+            };
+            let ctx = defaults;
+            for (const item of loaded) {
+                const hook = item.plugin.hooks?.getContext;
+                if (!hook)
+                    continue;
+                try {
+                    const result = await hook({ ...input, defaults });
+                    if (result &&
+                        typeof result === 'object' &&
+                        'executor' in result &&
+                        result.executor) {
+                        debug('context', `plugin "${item.plugin.manifest.name}" provided executor override`);
+                        if (ctx.executor !== defaults.executor) {
+                            await ctx.executor.close();
+                        }
+                        else if (ctx === defaults && defaults.executor !== NULL_EXECUTOR) {
+                            await defaults.executor.close();
+                        }
+                        ctx = { ...ctx, ...result, hasExecutor: true };
+                    }
+                }
+                catch (error) {
+                    await ctx.executor.close();
+                    throw formatPluginError(item.plugin.manifest.name, 'getContext', error);
+                }
+            }
+            return ctx;
+        },
+        async disposeContext(ctx) {
+            await ctx.executor.close();
+        },
+        getCommand(pluginName, commandName) {
+            const item = byName.get(pluginName);
+            if (!item)
+                return null;
+            const command = (item.plugin.commands ?? []).find((entry) => entry.name === commandName);
+            if (!command)
+                return null;
+            return { plugin: item, command };
+        },
+        runOnInit: (context) => runOnInit(loaded, context),
+        runOnComplete: (context) => runOnComplete(loaded, context),
+        runOnConfigLoaded: (context) => runOnConfigLoaded(loaded, context),
+        runOnSchemaLoaded: (context) => runOnSchemaLoaded(loaded, context),
+        runOnPlanCreated: (context, plan) => runOnPlanCreated(loaded, context, plan),
+        runOnBeforeApply: (context) => runOnBeforeApply(loaded, context),
+        runOnAfterApply: (context) => runOnAfterApply(loaded, context),
+        runOnCheck: (context) => runOnCheck(loaded, context),
+        runOnCheckReport: (results, print) => runOnCheckReport(byName, results, print),
+        runOnBeforePluginCommand: (pluginName, commandName, context) => runOnBeforePluginCommand(loaded, pluginName, commandName, context),
+        async runPluginCommand(pluginName, commandName, context) {
+            debug('command', `running plugin command "${pluginName}:${commandName}"`);
+            const item = byName.get(pluginName);
+            if (!item)
+                return 1;
+            const command = (item.plugin.commands ?? []).find((entry) => entry.name === commandName);
+            if (!command)
+                return 1;
+            const beforeResult = await runOnBeforePluginCommand(loaded, pluginName, commandName, {
+                config: context.config,
+                configPath: context.configPath,
+                jsonMode: context.jsonMode,
+                args: context.args,
+                flags: context.flags,
+                tableScope: context.tableScope ?? UNFILTERED_TABLE_SCOPE,
+                print: context.print,
+            });
+            if (beforeResult.handled)
+                return beforeResult.exitCode;
+            try {
+                const code = await command.run({
+                    ...context,
+                    pluginName,
+                    options: item.options,
+                    tableScope: context.tableScope ?? UNFILTERED_TABLE_SCOPE,
+                });
+                return typeof code === 'number' ? code : 0;
+            }
+            catch (error) {
+                throw formatPluginError(item.plugin.manifest.name, `command:${commandName}`, error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/plugin-runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/index.ts"],"names":[],"mappings":"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"}

package/dist/runtime/plugin-runtime/loader.d.ts

@@ -0,0 +1,14 @@
+import type { ChxPluginRegistration } from '@chkit/core';
+import type { ChxPlugin } from '../../plugins.js';
+export interface NormalizedRegistration {
+    kind: 'legacy' | 'inline';
+    resolvePath: string;
+    inlinePlugin?: ChxPlugin;
+    nameHint?: string;
+    enabled: boolean;
+    options: Record<string, unknown>;
+}
+export declare function normalizePluginRegistration(entry: ChxPluginRegistration): NormalizedRegistration;
+export declare function validatePlugin(cliVersion: string, plugin: ChxPlugin, sourcePath: string): void;
+export declare function importPluginModule(absolutePath: string): Promise<ChxPlugin>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/runtime/plugin-runtime/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/runtime/plugin-runtime/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAGjD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;IACzB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,qBAAqB,GAC3B,sBAAsB,CA6BxB;AAUD,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,MAAM,GACjB,IAAI,CAgCN;AAED,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAejF"}

package/dist/runtime/plugin-runtime/loader.js

@@ -0,0 +1,70 @@
+import { pathToFileURL } from 'node:url';
+import { isInlinePluginRegistration } from '../../plugins.js';
+export function normalizePluginRegistration(entry) {
+    if (typeof entry === 'string') {
+        return {
+            kind: 'legacy',
+            resolvePath: entry,
+            enabled: true,
+            options: {},
+        };
+    }
+    if (isInlinePluginRegistration(entry)) {
+        return {
+            kind: 'inline',
+            resolvePath: '',
+            inlinePlugin: entry.plugin,
+            nameHint: entry.name,
+            enabled: entry.enabled !== false,
+            options: entry.options ?? {},
+        };
+    }
+    const legacy = entry;
+    return {
+        kind: 'legacy',
+        resolvePath: legacy.resolve,
+        nameHint: legacy.name,
+        enabled: legacy.enabled !== false,
+        options: legacy.options ?? {},
+    };
+}
+function parseCliMajor(version) {
+    const major = Number(version.split('.')[0] ?? Number.NaN);
+    if (!Number.isInteger(major) || major < 0) {
+        throw new Error(`Invalid CLI version "${version}" while loading plugins.`);
+    }
+    return major;
+}
+export function validatePlugin(cliVersion, plugin, sourcePath) {
+    const name = plugin.manifest.name;
+    if (!name || name.trim().length === 0) {
+        throw new Error(`Plugin at ${sourcePath} has an empty manifest.name.`);
+    }
+    if (plugin.manifest.apiVersion !== 1) {
+        throw new Error(`Plugin "${name}" requires apiVersion=${String(plugin.manifest.apiVersion)} but CLI supports apiVersion=1.`);
+    }
+    const compatibility = plugin.manifest.compatibility?.cli;
+    if (!compatibility)
+        return;
+    const cliMajor = parseCliMajor(cliVersion);
+    if (compatibility.minMajor !== undefined &&
+        cliMajor < compatibility.minMajor) {
+        throw new Error(`Plugin "${name}" is incompatible with CLI ${cliVersion}. Requires cli major >= ${compatibility.minMajor}.`);
+    }
+    if (compatibility.maxMajor !== undefined &&
+        cliMajor > compatibility.maxMajor) {
+        throw new Error(`Plugin "${name}" is incompatible with CLI ${cliVersion}. Requires cli major <= ${compatibility.maxMajor}.`);
+    }
+}
+export async function importPluginModule(absolutePath) {
+    const mod = (await import(pathToFileURL(absolutePath).href));
+    const candidate = (mod.default ?? mod.plugin);
+    if (!candidate || typeof candidate !== 'object') {
+        throw new Error(`Plugin module ${absolutePath} must export default definePlugin(...)`);
+    }
+    if (!candidate.manifest || typeof candidate.manifest !== 'object') {
+        throw new Error(`Plugin module ${absolutePath} is missing manifest.`);
+    }
+    return candidate;
+}
+//# sourceMappingURL=loader.js.map