@noormdev/sdk 1.0.0-alpha.28 → 1.0.0-alpha.29

package/dist/{engine-27DNMF4T.js → engine-GMQXUPNB.js}

@@ -1,11 +1,11 @@
 import { createRequire } from 'module';
-export { eta, isTemplate, processFile, processFiles, renderTemplate } from './chunk-3UDETNWW.js';
+export { eta, isTemplate, processFile, processFiles, renderTemplate } from './chunk-5AYPF5D5.js';
 import './chunk-UOFJT5PY.js';
-import './chunk-UDUDHOIB.js';
+import './chunk-DLQES4PM.js';
 import './chunk-TBRUDUBQ.js';
 import './chunk-YJBKNUTP.js';
 import './chunk-D2XW2UOP.js';
 
 createRequire(import.meta.url);
-//# sourceMappingURL=engine-27DNMF4T.js.map
-//# sourceMappingURL=engine-27DNMF4T.js.map
+//# sourceMappingURL=engine-GMQXUPNB.js.map
+//# sourceMappingURL=engine-GMQXUPNB.js.map

package/dist/{engine-27DNMF4T.js.map → engine-GMQXUPNB.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"engine-27DNMF4T.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"engine-GMQXUPNB.js"}

package/dist/index.d.ts

@@ -53,6 +53,23 @@ export interface ConnectionResult {
 	dialect: Dialect;
 	destroy: () => Promise<void>;
 }
+/**
+ * Logger Types
+ *
+ * Type definitions for the noorm logging system.
+ * The logger captures observer events and streams them
+ * to a log file with configurable verbosity.
+ */
+/**
+ * Log verbosity levels.
+ *
+ * - silent: No logging
+ * - error: Errors only
+ * - warn: Errors + warnings
+ * - info: Errors + warnings + info (default)
+ * - verbose: All events including debug
+ */
+export type LogLevel = "silent" | "error" | "warn" | "info" | "verbose";
 /**
  * Full configuration object.
  *
@@ -2128,6 +2145,16 @@ export declare class ChangesNamespace {
 	 * ```
 	 */
 	ff(): Promise<BatchChangeResult>;
+	/**
+	 * Apply the next N pending changes (default 1).
+	 *
+	 * @example
+	 * ```typescript
+	 * const result = await ctx.noorm.changes.next()
+	 * const result = await ctx.noorm.changes.next(3)
+	 * ```
+	 */
+	next(count?: number): Promise<BatchChangeResult>;
 	/**
 	 * Get status of all changes (merged disk + DB).
 	 *
@@ -2155,6 +2182,43 @@ export declare class ChangesNamespace {
 	 * ```
 	 */
 	history(limit?: number): Promise<ChangeHistoryRecord[]>;
+	/**
+	 * Get execution history for a specific change by name.
+	 *
+	 * Returns all operation records for the given change, most recent first.
+	 *
+	 * @example
+	 * ```typescript
+	 * const records = await ctx.noorm.changes.historyForChange('2024-01-15-add-users')
+	 * ```
+	 */
+	historyForChange(name: string, limit?: number): Promise<ChangeHistoryRecord[]>;
+	/**
+	 * Rewind applied changes in reverse order back to (and including) the named change.
+	 *
+	 * When a string is passed, reverts until and including that change.
+	 * When a number is passed, reverts that many recent changes.
+	 *
+	 * @example
+	 * ```typescript
+	 * const result = await ctx.noorm.changes.rewind('2024-01-15-add-users')
+	 * const result = await ctx.noorm.changes.rewind(3)
+	 * ```
+	 */
+	rewind(target: number | string): Promise<BatchChangeResult>;
+	/**
+	 * Get per-file execution records for a specific operation ID.
+	 *
+	 * Use the `id` from a `ChangeHistoryRecord` to drill into individual
+	 * file-level results for that operation.
+	 *
+	 * @example
+	 * ```typescript
+	 * const records = await ctx.noorm.changes.historyForChange('2024-01-15-add-users')
+	 * const files = await ctx.noorm.changes.getFileHistory(records[0].id)
+	 * ```
+	 */
+	getFileHistory(operationId: number): Promise<FileHistoryRecord[]>;
 }
 export declare class RunNamespace {
 	#private;
@@ -2238,6 +2302,41 @@ export interface TableSummary {
 	columnCount: number;
 	rowCountEstimate?: number;
 }
+/**
+ * View summary for list display.
+ */
+export interface ViewSummary {
+	name: string;
+	schema?: string;
+	columnCount: number;
+	isUpdatable: boolean;
+}
+/**
+ * Stored procedure summary for list display.
+ */
+export interface ProcedureSummary {
+	name: string;
+	schema?: string;
+	parameterCount: number;
+}
+/**
+ * Function summary for list display.
+ */
+export interface FunctionSummary {
+	name: string;
+	schema?: string;
+	parameterCount: number;
+	returnType: string;
+}
+/**
+ * Type/Enum summary for list display.
+ */
+export interface TypeSummary {
+	name: string;
+	schema?: string;
+	kind: "enum" | "composite" | "domain" | "other";
+	valueCount?: number;
+}
 /**
  * Index summary for list display.
  */
@@ -2276,6 +2375,16 @@ export interface ColumnDetail {
 	isPrimaryKey: boolean;
 	ordinalPosition: number;
 }
+/**
+ * Parameter detail for procedures/functions.
+ */
+export interface ParameterDetail {
+	name: string;
+	dataType: string;
+	mode: "IN" | "OUT" | "INOUT";
+	defaultValue?: string;
+	ordinalPosition: number;
+}
 /**
  * Full table detail.
  */
@@ -2287,6 +2396,48 @@ export interface TableDetail {
 	foreignKeys: ForeignKeySummary[];
 	rowCountEstimate?: number;
 }
+/**
+ * Full view detail.
+ */
+export interface ViewDetail {
+	name: string;
+	schema?: string;
+	columns: ColumnDetail[];
+	definition?: string;
+	isUpdatable: boolean;
+}
+/**
+ * Full procedure detail.
+ */
+export interface ProcedureDetail {
+	name: string;
+	schema?: string;
+	parameters: ParameterDetail[];
+	definition?: string;
+}
+/**
+ * Full function detail.
+ */
+export interface FunctionDetail {
+	name: string;
+	schema?: string;
+	parameters: ParameterDetail[];
+	returnType: string;
+	definition?: string;
+	language?: string;
+}
+/**
+ * Full type detail.
+ */
+export interface TypeDetail {
+	name: string;
+	schema?: string;
+	kind: "enum" | "composite" | "domain" | "other";
+	values?: string[];
+	attributes?: ColumnDetail[];
+	baseType?: string;
+	definition?: string;
+}
 /**
  * Teardown Types
  *
@@ -2401,6 +2552,96 @@ export declare class DbNamespace {
 	 * ```
 	 */
 	describeTable(name: string, schema?: string): Promise<TableDetail | null>;
+	/**
+	 * List all views in the database.
+	 *
+	 * @example
+	 * ```typescript
+	 * const views = await ctx.noorm.db.listViews()
+	 * ```
+	 */
+	listViews(): Promise<ViewSummary[]>;
+	/**
+	 * Get detailed information about a view.
+	 *
+	 * @example
+	 * ```typescript
+	 * const detail = await ctx.noorm.db.describeView('active_users')
+	 * ```
+	 */
+	describeView(name: string, schema?: string): Promise<ViewDetail | null>;
+	/**
+	 * List all stored procedures in the database.
+	 *
+	 * @example
+	 * ```typescript
+	 * const procs = await ctx.noorm.db.listProcedures()
+	 * ```
+	 */
+	listProcedures(): Promise<ProcedureSummary[]>;
+	/**
+	 * Get detailed information about a stored procedure.
+	 *
+	 * @example
+	 * ```typescript
+	 * const detail = await ctx.noorm.db.describeProcedure('sp_update_user')
+	 * ```
+	 */
+	describeProcedure(name: string, schema?: string): Promise<ProcedureDetail | null>;
+	/**
+	 * List all functions in the database.
+	 *
+	 * @example
+	 * ```typescript
+	 * const fns = await ctx.noorm.db.listFunctions()
+	 * ```
+	 */
+	listFunctions(): Promise<FunctionSummary[]>;
+	/**
+	 * Get detailed information about a function.
+	 *
+	 * @example
+	 * ```typescript
+	 * const detail = await ctx.noorm.db.describeFunction('fn_get_user')
+	 * ```
+	 */
+	describeFunction(name: string, schema?: string): Promise<FunctionDetail | null>;
+	/**
+	 * List all custom types in the database.
+	 *
+	 * @example
+	 * ```typescript
+	 * const types = await ctx.noorm.db.listTypes()
+	 * ```
+	 */
+	listTypes(): Promise<TypeSummary[]>;
+	/**
+	 * Get detailed information about a custom type.
+	 *
+	 * @example
+	 * ```typescript
+	 * const detail = await ctx.noorm.db.describeType('user_status')
+	 * ```
+	 */
+	describeType(name: string, schema?: string): Promise<TypeDetail | null>;
+	/**
+	 * List all indexes in the database.
+	 *
+	 * @example
+	 * ```typescript
+	 * const indexes = await ctx.noorm.db.listIndexes()
+	 * ```
+	 */
+	listIndexes(): Promise<IndexSummary[]>;
+	/**
+	 * List all foreign keys in the database.
+	 *
+	 * @example
+	 * ```typescript
+	 * const fks = await ctx.noorm.db.listForeignKeys()
+	 * ```
+	 */
+	listForeignKeys(): Promise<ForeignKeySummary[]>;
 	/**
 	 * Get database overview with counts of all object types.
 	 *
@@ -3143,6 +3384,10 @@ export type ShutdownReason = "signal" | "user" | "error" | "programmatic";
  * Application mode.
  */
 export type AppMode = "tui" | "headless";
+/**
+ * Signal types we handle.
+ */
+export type Signal = "SIGINT" | "SIGTERM" | "SIGHUP";
 /**
  * Type definitions for auto-update feature.
  *
@@ -3445,6 +3690,11 @@ export interface DtEvents {
  * - `vault:*` - Vault operations
  * - `transfer:*` - Data transfer operations
  * - `dt:*` - .dt format export/import/stream operations
+ * - `version:*` - Version checking and migration
+ * - `logger:*` - Logger lifecycle
+ * - `teardown:*` - Database teardown/truncate operations
+ * - `sql-terminal:*` - SQL terminal query execution
+ * - `init:*` - Project initialization
  * - `error` - Catch-all errors
  */
 export interface NoormEvents extends SettingsEvents, UpdateEvents, VaultEvents, TransferEvents, DtEvents {
@@ -3515,6 +3765,10 @@ export interface NoormEvents extends SettingsEvents, UpdateEvents, VaultEvents,
 		fileCount: number;
 		configName: string;
 	};
+	"run:files": {
+		fileCount: number;
+		configName: string;
+	};
 	"lock:acquiring": {
 		configName: string;
 		identity: string;
@@ -3602,6 +3856,25 @@ export interface NoormEvents extends SettingsEvents, UpdateEvents, VaultEvents,
 		configName: string;
 		tables: string[];
 	};
+	"db:dual:connecting": {
+		source: string;
+		destination: string;
+	};
+	"db:dual:connected": {
+		source: string;
+		destination: string;
+	};
+	"db:dual:disconnecting": {
+		source: string;
+		destination: string;
+	};
+	"db:dual:disconnected": {
+		source: string;
+		destination: string;
+	};
+	"db:dual:cleanup-warning": {
+		errors: string[];
+	};
 	"template:render": {
 		filepath: string;
 		durationMs: number;
@@ -3671,6 +3944,13 @@ export interface NoormEvents extends SettingsEvents, UpdateEvents, VaultEvents,
 		error: Error;
 		type?: "exception" | "rejection";
 	};
+	"app:signal": {
+		signal: Signal;
+	};
+	"app:exception": {
+		error: Error;
+		type: "exception" | "rejection";
+	};
 	"router:navigated": {
 		from: string;
 		to: string;
@@ -3680,6 +3960,84 @@ export interface NoormEvents extends SettingsEvents, UpdateEvents, VaultEvents,
 		popped: string;
 		to: string;
 	};
+	"init:complete": {
+		projectRoot: string;
+		hasIdentity: boolean;
+	};
+	"version:schema:checking": {
+		current: number;
+	};
+	"version:schema:migrating": {
+		from: number;
+		to: number;
+	};
+	"version:schema:migrated": {
+		from: number;
+		to: number;
+		durationMs: number;
+	};
+	"version:state:migrating": {
+		from: number;
+		to: number;
+	};
+	"version:state:migrated": {
+		from: number;
+		to: number;
+	};
+	"version:settings:migrating": {
+		from: number;
+		to: number;
+	};
+	"version:settings:migrated": {
+		from: number;
+		to: number;
+	};
+	"version:mismatch": {
+		layer: "schema" | "state" | "settings";
+		current: number;
+		expected: number;
+	};
+	"logger:started": {
+		file: string;
+		level: LogLevel;
+	};
+	"logger:rotated": {
+		oldFile: string;
+		newFile: string;
+	};
+	"teardown:start": {
+		type: "truncate" | "schema";
+	};
+	"teardown:progress": {
+		category: string;
+		object: string | null;
+		action: string;
+	};
+	"teardown:error": {
+		error: Error;
+		object: string | null;
+	};
+	"teardown:complete": {
+		result: TruncateResult | TeardownResult;
+	};
+	"sql-terminal:execute:before": {
+		query: string;
+		configName: string;
+	};
+	"sql-terminal:execute:after": {
+		query: string;
+		configName: string;
+		success: true;
+		durationMs: number;
+		rowCount: number;
+		rowsAffected: number | undefined;
+	} | {
+		query: string;
+		configName: string;
+		success: false;
+		durationMs: number;
+		error: string;
+	};
 	error: {
 		source: string;
 		error: Error;

package/dist/index.js

@@ -1,8 +1,8 @@
 import { createRequire } from 'module';
-import { processFile, DtReader, isTemplate, FORMAT_VERSION, DT_EXTENSIONS, encryptWithPassphrase, ENCODED_TYPES } from './chunk-3UDETNWW.js';
+import { processFile, DtReader, isTemplate, FORMAT_VERSION, DT_EXTENSIONS, encryptWithPassphrase, ENCODED_TYPES } from './chunk-5AYPF5D5.js';
 import './chunk-UOFJT5PY.js';
-import { initializeVault, getVaultStatus, setVaultSecret, getVaultSecret, getAllVaultSecrets, listVaultSecretKeys, deleteVaultSecret, vaultSecretExists, getVaultKey, noormDb, getNoormTables, encryptVaultKey } from './chunk-ZKYTJJIF.js';
-import { makeNestedConfig, gigabytes, observer, attempt, retry, clone, merge, attemptSync, ObserverRelay } from './chunk-UDUDHOIB.js';
+import { initializeVault, getVaultStatus, setVaultSecret, getVaultSecret, getAllVaultSecrets, listVaultSecretKeys, deleteVaultSecret, vaultSecretExists, getVaultKey, noormDb, getNoormTables, encryptVaultKey } from './chunk-DE3NJ22A.js';
+import { makeNestedConfig, gigabytes, observer, attempt, retry, clone, merge, attemptSync, ObserverRelay } from './chunk-DLQES4PM.js';
 import { dist_default } from './chunk-TBRUDUBQ.js';
 import { require_dist } from './chunk-YJBKNUTP.js';
 import { __commonJS, __export, __toESM } from './chunk-D2XW2UOP.js';
@@ -17747,7 +17747,8 @@ var ChangeHistory = class {
       direction: data2.direction,
       status: "pending",
       config_name: this.#configName,
-      executed_by: data2.executedBy
+      executed_by: data2.executedBy,
+      cli_version: getCurrentVersion()
     });
     let id;
     if (this.#dialect === "mssql") {
@@ -17943,6 +17944,7 @@ var ChangeHistory = class {
       status: "success",
       config_name: this.#configName,
       executed_by: executedBy,
+      cli_version: getCurrentVersion(),
       error_message: reason ?? "",
       duration_ms: 0,
       checksum: ""
@@ -20109,6 +20111,18 @@ var ChangesNamespace = class {
   async ff() {
     return this.#getManager().ff();
   }
+  /**
+   * Apply the next N pending changes (default 1).
+   *
+   * @example
+   * ```typescript
+   * const result = await ctx.noorm.changes.next()
+   * const result = await ctx.noorm.changes.next(3)
+   * ```
+   */
+  async next(count = 1) {
+    return this.#getManager().next(count);
+  }
   // ─────────────────────────────────────────────────────
   // Status & history (connected)
   // ─────────────────────────────────────────────────────
@@ -20148,6 +20162,49 @@ var ChangesNamespace = class {
   async history(limit) {
     return this.#getManager().getHistory(void 0, limit);
   }
+  /**
+   * Get execution history for a specific change by name.
+   *
+   * Returns all operation records for the given change, most recent first.
+   *
+   * @example
+   * ```typescript
+   * const records = await ctx.noorm.changes.historyForChange('2024-01-15-add-users')
+   * ```
+   */
+  async historyForChange(name, limit) {
+    return this.#getManager().getHistory(name, limit);
+  }
+  /**
+   * Rewind applied changes in reverse order back to (and including) the named change.
+   *
+   * When a string is passed, reverts until and including that change.
+   * When a number is passed, reverts that many recent changes.
+   *
+   * @example
+   * ```typescript
+   * const result = await ctx.noorm.changes.rewind('2024-01-15-add-users')
+   * const result = await ctx.noorm.changes.rewind(3)
+   * ```
+   */
+  async rewind(target) {
+    return this.#getManager().rewind(target);
+  }
+  /**
+   * Get per-file execution records for a specific operation ID.
+   *
+   * Use the `id` from a `ChangeHistoryRecord` to drill into individual
+   * file-level results for that operation.
+   *
+   * @example
+   * ```typescript
+   * const records = await ctx.noorm.changes.historyForChange('2024-01-15-add-users')
+   * const files = await ctx.noorm.changes.getFileHistory(records[0].id)
+   * ```
+   */
+  async getFileHistory(operationId) {
+    return this.#getManager().getFileHistory(operationId);
+  }
   // ─────────────────────────────────────────────────────
   // Private
   // ─────────────────────────────────────────────────────
@@ -23679,6 +23736,116 @@ var DbNamespace = class {
   async describeTable(name, schema) {
     return fetchDetail(this.#kysely, this.#dialect, "tables", name, schema);
   }
+  /**
+   * List all views in the database.
+   *
+   * @example
+   * ```typescript
+   * const views = await ctx.noorm.db.listViews()
+   * ```
+   */
+  async listViews() {
+    return fetchList(this.#kysely, this.#dialect, "views");
+  }
+  /**
+   * Get detailed information about a view.
+   *
+   * @example
+   * ```typescript
+   * const detail = await ctx.noorm.db.describeView('active_users')
+   * ```
+   */
+  async describeView(name, schema) {
+    return fetchDetail(this.#kysely, this.#dialect, "views", name, schema);
+  }
+  /**
+   * List all stored procedures in the database.
+   *
+   * @example
+   * ```typescript
+   * const procs = await ctx.noorm.db.listProcedures()
+   * ```
+   */
+  async listProcedures() {
+    return fetchList(this.#kysely, this.#dialect, "procedures");
+  }
+  /**
+   * Get detailed information about a stored procedure.
+   *
+   * @example
+   * ```typescript
+   * const detail = await ctx.noorm.db.describeProcedure('sp_update_user')
+   * ```
+   */
+  async describeProcedure(name, schema) {
+    return fetchDetail(this.#kysely, this.#dialect, "procedures", name, schema);
+  }
+  /**
+   * List all functions in the database.
+   *
+   * @example
+   * ```typescript
+   * const fns = await ctx.noorm.db.listFunctions()
+   * ```
+   */
+  async listFunctions() {
+    return fetchList(this.#kysely, this.#dialect, "functions");
+  }
+  /**
+   * Get detailed information about a function.
+   *
+   * @example
+   * ```typescript
+   * const detail = await ctx.noorm.db.describeFunction('fn_get_user')
+   * ```
+   */
+  async describeFunction(name, schema) {
+    return fetchDetail(this.#kysely, this.#dialect, "functions", name, schema);
+  }
+  /**
+   * List all custom types in the database.
+   *
+   * @example
+   * ```typescript
+   * const types = await ctx.noorm.db.listTypes()
+   * ```
+   */
+  async listTypes() {
+    return fetchList(this.#kysely, this.#dialect, "types");
+  }
+  /**
+   * Get detailed information about a custom type.
+   *
+   * @example
+   * ```typescript
+   * const detail = await ctx.noorm.db.describeType('user_status')
+   * ```
+   */
+  async describeType(name, schema) {
+    return fetchDetail(this.#kysely, this.#dialect, "types", name, schema);
+  }
+  /**
+   * List all indexes in the database.
+   *
+   * @example
+   * ```typescript
+   * const indexes = await ctx.noorm.db.listIndexes()
+   * ```
+   */
+  async listIndexes() {
+    return fetchList(this.#kysely, this.#dialect, "indexes");
+  }
+  /**
+   * List all foreign keys in the database.
+   *
+   * @example
+   * ```typescript
+   * const fks = await ctx.noorm.db.listForeignKeys()
+   * ```
+   */
+  async listForeignKeys() {
+    return fetchList(this.#kysely, this.#dialect, "foreignKeys");
+  }
   /**
    * Get database overview with counts of all object types.
    *