@memberjunction/generic-database-provider 0.0.1 → 5.5.0

package/README.md

@@ -1,45 +1,134 @@
 # @memberjunction/generic-database-provider
 
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/generic-database-provider`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+Intermediate abstract base class for MemberJunction database providers. Sits between the lightweight `DatabaseProviderBase` (in `@memberjunction/core`) and platform-specific providers (`SQLServerDataProvider`, `PostgreSQLDataProvider`).
+
+## Why This Package Exists
+
+`DatabaseProviderBase` in MJCore cannot depend on heavy packages like `@memberjunction/actions`, `@memberjunction/aiengine`, `@memberjunction/encryption`, or `@memberjunction/core-entities`. However, the entity action hooks, AI action processing, field-level encryption, and view WHERE clause rendering logic is shared between SQL Server and PostgreSQL providers.
+
+This package provides a single implementation of that shared logic, eliminating code duplication while keeping MJCore lightweight.
+
+## Inheritance Chain
+
+```
+DatabaseProviderBase (@memberjunction/core — no heavy deps, abstract)
+  └── GenericDatabaseProvider (this package — ActionEngine, AIEngine, EncryptionEngine)
+      ├── SQLServerDataProvider (@memberjunction/sqlserver-dataprovider)
+      └── PostgreSQLDataProvider (@memberjunction/postgresql-dataprovider)
+```
+
+## What It Provides
+
+| Method | Description |
+|--------|-------------|
+| `HandleEntityActions()` | Discovers and runs active entity actions for save/delete/validate via `EntityActionEngineServer` |
+| `HandleEntityAIActions()` | Runs AI-triggered entity actions (before save blocks, after save fires and forgets) |
+| `GetEntityAIActions()` | Filters `AIEngine.EntityAIActions` for the given entity and timing |
+| `EnqueueAfterSaveAIAction()` | Virtual hook for after-save AI task enqueueing (overridden by SQL Server for transaction deferral) |
+| `OnValidateBeforeSave()` | Runs validation entity actions and returns error messages |
+| `OnBeforeSaveExecute()` | Runs before-save entity actions and AI actions |
+| `OnAfterSaveExecute()` | Fires after-save entity/AI actions (no await) |
+| `OnBeforeDeleteExecute()` | Runs before-delete entity actions and AI actions |
+| `OnAfterDeleteExecute()` | Fires after-delete entity/AI actions (no await) |
+| `PostProcessRows()` | Platform-specific datetime adjustment (via `AdjustDatetimeFields` hook) + field-level decryption using `EncryptionEngine` |
+| `AdjustDatetimeFields()` | Virtual hook for platform-specific datetime corrections (no-op default; SQL Server overrides for DATETIMEOFFSET) |
+| `ExecuteSQLBatch()` | Executes multiple SQL queries; default runs in parallel via `Promise.all(ExecuteSQL(...))`, SQL Server overrides for true multi-result-set batching |
+| `GetDatasetStatusByName()` | Retrieves dataset item status (max date + row count) using `ExecuteSQLBatch` |
+| `CreateSqlLogger()` | Creates a SQL logging session that captures all SQL operations to a file |
+| `GetActiveSqlLoggingSessions()` | Lists all active SQL logging sessions |
+| `GetSqlLoggingSessionById()` | Retrieves a specific logging session by ID |
+| `DisposeAllSqlLoggingSessions()` | Disposes all active logging sessions (used on shutdown) |
+| `LogSQLStatement()` | Static method to log SQL from external sources (e.g., transaction groups) |
+| `RenderViewWhereClause()` | Resolves `{%UserView "id"%}` templates in saved view WHERE clauses |
+| `InternalRunView()` | Shared view execution engine: view resolution, permissions, field selection, WHERE clause, ORDER BY, pagination, aggregates, audit logging |
+| `InternalRunViews()` | Parallel wrapper for multiple InternalRunView calls |
+| `getRunTimeViewFieldString()` | Builds dialect-neutral field list string for view queries |
+| `getRunTimeViewFieldArray()` | Resolves EntityFieldInfo list from params/view/entity |
+| `createViewUserSearchSQL()` | Builds full-text search and LIKE-based user search SQL |
+| `BuildPaginationSQL()` | Abstract: platform-specific OFFSET/FETCH or LIMIT/OFFSET |
+| `BuildTopClause()` | Virtual: SQL Server TOP N, PG returns empty (default) |
+| `BuildNonPaginatedLimitSQL()` | Virtual: PG LIMIT N for non-paginated row limits (default: empty) |
+| `TransformExternalSQLClause()` | Virtual: PG overrides to quote mixed-case identifiers (default: no-op) |
+| `executeSQLForUserViewRunLogging()` | Virtual: SQL Server overrides for view run audit logging (default: null) |
+| `Load()` | Loads a single entity record by composite key with dialect-neutral quoting, char field trimming, relationship loading, and PostProcessRows |
+| `GetDatasetByName()` | Retrieves a dataset by name, executes item queries with dialect-neutral SQL, applies PostProcessRows |
+| `RunViewsWithCacheCheck()` | Smart cache validation for batch RunViews: compares MAX(__mj_UpdatedAt)/COUNT(*), supports differential updates |
+| `RunQueriesWithCacheCheck()` | Smart cache validation for batch RunQueries using CacheValidationSQL |
+| `isCacheCurrent()` | Compares client cache status with server status (date + row count) |
+| `buildWhereClauseForCacheCheck()` | Virtual: builds WHERE from ExtraFilter, UserSearch, and RLS |
+| `getBatchedServerCacheStatus()` | Virtual: batched server-side cache status check (default: parallel individual queries; SQL Server overrides for ExecuteSQLBatch) |
+| `getBatchedQueryCacheStatus()` | Virtual: batched query cache status check (default: parallel individual queries; SQL Server overrides for ExecuteSQLBatch) |
+| `runFullQueryAndReturn()` | Wraps InternalRunView with maxUpdatedAt extraction |
+| `runDifferentialQueryAndReturn()` | Returns only changed rows since client's cached state, with hidden-delete detection |
+| `getDeletedRecordIDsSince()` | Virtual: queries RecordChange table for deletions since a timestamp |
+| `getUpdatedRowsSince()` | Virtual: queries entity view for rows updated since a timestamp |
+| `resolveQueryInfo()` | Resolves QueryInfo from RunQueryParams (by ID or Name+CategoryPath) |
+| `findQueryInEngine()` | Searches QueryEngine for a fresh query entity |
+| `refreshQueryInfoFromEntity()` | Creates fresh QueryInfo from entity and patches ProviderBase cache |
+| `resolveCategoryPath()` | Resolves hierarchical category path to CategoryID |
+| `BuildParameterPlaceholder()` | Virtual: PG-style $1/$2 by default; SQL Server overrides to @p0/@p1 |
+| `getColumnsForDatasetItem()` | Validates and quotes column names for dataset item queries |
+
+## Usage
+
+Platform-specific providers should extend `GenericDatabaseProvider` instead of `DatabaseProviderBase`:
+
+```typescript
+import { GenericDatabaseProvider } from '@memberjunction/generic-database-provider';
+
+export class MyDatabaseProvider extends GenericDatabaseProvider {
+    // Implement remaining abstract methods from DatabaseProviderBase
+    // Override EnqueueAfterSaveAIAction if you need transaction-aware deferral
+    // Override PostProcessRows if you need platform-specific row processing (call super first)
+}
+```
+
+## SQL Logging
+
+The SQL logging subsystem lives in GenericDatabaseProvider so it is available to all platform-specific providers (SQL Server, PostgreSQL, etc.). Sessions capture executed SQL statements to files with filtering, formatting, and Flyway migration support.
+
+```typescript
+import { Metadata } from '@memberjunction/core';
+import type { GenericDatabaseProvider } from '@memberjunction/generic-database-provider';
+
+const provider = Metadata.Provider as GenericDatabaseProvider;
+
+// Create a logging session
+const session = await provider.CreateSqlLogger('./logs/operations.sql', {
+    statementTypes: 'mutations',
+    prettyPrint: true,
+    filterPatterns: [/spCreateAIPromptRun/i],
+    filterType: 'exclude',
+});
+
+try {
+    // All SQL operations are automatically captured
+    await provider.ExecuteSQL('INSERT INTO ...');
+} finally {
+    await session.dispose();
+}
+```
+
+Key types exported from this package:
+
+| Export | Type | Description |
+|--------|------|-------------|
+| `SqlLoggingOptions` | Interface | Configuration options for SQL logging sessions |
+| `SqlLoggingSession` | Interface | Public interface for an active logging session |
+| `SqlLoggingSessionImpl` | Class | Internal session implementation (file I/O, formatting, filtering) |
+
+## Switching Database Platforms (Developer Note)
+
+When developing against both SQL Server and PostgreSQL on the same URL/port, **clear your browser cache** after switching backends. The client-side `GraphQLDataProvider` caches entity metadata and query results in the browser. UUID casing differs between platforms (SQL Server: uppercase, PostgreSQL: lowercase), so stale cached data from one platform will cause subtle mismatches on the other. Clear browser cache or use an incognito window whenever you switch the backend database.
+
+## Dependencies
+
+- `@memberjunction/core` — Base class and entity types
+- `@memberjunction/core-entities` — `MJUserViewEntityExtended`, `ViewInfo` for view WHERE clause rendering
+- `@memberjunction/actions` / `@memberjunction/actions-base` — Entity action engine
+- `@memberjunction/aiengine` — AI action execution
+- `@memberjunction/encryption` — Field-level encryption/decryption
+- `@memberjunction/global` — Global object store, `ensureRegExps` for pattern filtering
+- `@memberjunction/queue` — Task queue for after-save AI actions
+- `sql-formatter` — SQL pretty-printing for log output
+- `uuid` — Session ID generation

package/dist/GenericDatabaseProvider.d.ts

@@ -0,0 +1,426 @@
+/**
+ * @fileoverview Generic Database Provider for MemberJunction
+ *
+ * This module provides an intermediate abstract base class between DatabaseProviderBase (MJCore)
+ * and platform-specific providers (SQLServerDataProvider, PostgreSQLDataProvider).
+ *
+ * It contains shared logic that requires heavy dependencies (ActionEngine, AIEngine,
+ * EncryptionEngine, MJCoreEntities) which cannot live in MJCore's lightweight base class.
+ *
+ * Inheritance chain:
+ *   DatabaseProviderBase (MJCore — no heavy deps)
+ *     └── GenericDatabaseProvider (this package — has ActionEngine, AIEngine, EncryptionEngine)
+ *         ├── SQLServerDataProvider (adds datetime handling, SQL logging, mssql-specific)
+ *         └── PostgreSQLDataProvider (adds pg-specific connection management)
+ *
+ * @module @memberjunction/generic-database-provider
+ */
+import { BaseEntity, DatabaseProviderBase, EntityInfo, EntityFieldInfo, EntitySaveOptions, EntityDeleteOptions, RunViewParams, RunViewResult, RunViewWithCacheCheckParams, RunViewsWithCacheCheckResponse, RunViewWithCacheCheckResult, RunQueryParams, RunQueryWithCacheCheckParams, RunQueriesWithCacheCheckResponse, RunQueryWithCacheCheckResult, QueryInfo, CompositeKey, DatasetItemFilterType, DatasetResultType, DatasetStatusResultType, IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { SqlLoggingOptions, SqlLoggingSession } from './types.js';
+import { MJEntityAIActionEntity, MJQueryEntity, MJUserViewEntityExtended } from '@memberjunction/core-entities';
+import { EntityAIActionParams } from '@memberjunction/aiengine';
+import { ActionResult } from '@memberjunction/actions-base';
+/**
+ * Configuration options for batch SQL execution.
+ * Shared between GenericDatabaseProvider and platform-specific providers.
+ */
+export interface ExecuteSQLBatchOptions {
+    /** Optional description for this batch operation */
+    description?: string;
+    /** If true, this batch will not be logged to any logging session */
+    ignoreLogging?: boolean;
+    /** Whether this batch contains data mutation operations */
+    isMutation?: boolean;
+}
+/**
+ * GenericDatabaseProvider is an intermediate abstract class that implements shared
+ * entity action, AI action, encryption, and view WHERE clause rendering logic.
+ *
+ * Platform-specific providers should extend this class instead of DatabaseProviderBase
+ * to inherit these shared behaviors.
+ */
+export declare abstract class GenericDatabaseProvider extends DatabaseProviderBase {
+    /**************************************************************************/
+    /**************************************************************************/
+    private static _sqlLoggingSessionsKey;
+    private get _sqlLoggingSessions();
+    /**
+     * Creates a new SQL logging session that will capture all SQL operations to a file.
+     * Returns a disposable session object that must be disposed to stop logging.
+     *
+     * @param filePath - Full path to the file where SQL statements will be logged
+     * @param options - Optional configuration for the logging session
+     * @returns Promise<SqlLoggingSession> - Disposable session object
+     *
+     * @example
+     * ```typescript
+     * // Basic usage
+     * const session = await provider.CreateSqlLogger('./logs/metadata-sync.sql');
+     * try {
+     *   // Perform operations that will be logged
+     *   await provider.ExecuteSQL('INSERT INTO ...');
+     * } finally {
+     *   await session.dispose(); // Stop logging
+     * }
+     *
+     * // With migration formatting
+     * const session = await provider.CreateSqlLogger('./migrations/changes.sql', {
+     *   formatAsMigration: true,
+     *   description: 'MetadataSync push operation'
+     * });
+     * ```
+     */
+    CreateSqlLogger(filePath: string, options?: SqlLoggingOptions): Promise<SqlLoggingSession>;
+    /**
+     * Gets information about all active SQL logging sessions.
+     * Useful for monitoring and debugging.
+     *
+     * @returns Array of session information objects
+     */
+    GetActiveSqlLoggingSessions(): Array<{
+        id: string;
+        filePath: string;
+        startTime: Date;
+        statementCount: number;
+        options: SqlLoggingOptions;
+    }>;
+    /**
+     * Gets a specific SQL logging session by its ID.
+     * Returns the session if found, or undefined if not found.
+     *
+     * @param sessionId - The unique identifier of the session to retrieve
+     * @returns The SqlLoggingSession if found, undefined otherwise
+     */
+    GetSqlLoggingSessionById(sessionId: string): SqlLoggingSession | undefined;
+    /**
+     * Disposes all active SQL logging sessions.
+     * Useful for cleanup on provider shutdown.
+     */
+    DisposeAllSqlLoggingSessions(): Promise<void>;
+    /**
+     * Internal method to log SQL statement to all active logging sessions.
+     * This is called automatically by ExecuteSQL methods.
+     * Protected so platform-specific providers can reference it (e.g., to bind as a callback).
+     *
+     * @param query - The SQL query being executed
+     * @param parameters - Parameters for the query
+     * @param description - Optional description for this operation
+     * @param ignoreLogging - If true, this statement will not be logged
+     * @param isMutation - Whether this is a data mutation operation
+     * @param simpleSQLFallback - Optional simple SQL to use for loggers with logRecordChangeMetadata=false
+     * @param contextUser - Optional user context for session filtering
+     */
+    protected _logSqlStatement(query: string, parameters?: unknown, description?: string, ignoreLogging?: boolean, isMutation?: boolean, simpleSQLFallback?: string, contextUser?: UserInfo): Promise<void>;
+    /**
+     * Static method to log SQL statements from external sources like transaction groups.
+     * Gets the current provider instance from Metadata.Provider and delegates to the
+     * instance _logSqlStatement method.
+     *
+     * @param query - The SQL query being executed
+     * @param parameters - Parameters for the query
+     * @param description - Optional description for this operation
+     * @param isMutation - Whether this is a data mutation operation
+     * @param simpleSQLFallback - Optional simple SQL to use for loggers with logRecordChangeMetadata=false
+     * @param contextUser - Optional user context for session filtering
+     */
+    static LogSQLStatement(query: string, parameters?: unknown, description?: string, isMutation?: boolean, simpleSQLFallback?: string, contextUser?: UserInfo): Promise<void>;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Returns AI actions configured for the given entity and timing.
+     * Uses AIEngine metadata to find matching EntityAIAction records.
+     */
+    protected GetEntityAIActions(entityInfo: EntityInfo, before: boolean): MJEntityAIActionEntity[];
+    /**
+     * Handles entity actions (non-AI) for save, delete, or validate operations.
+     * Uses EntityActionEngineServer to discover and run active actions.
+     */
+    protected HandleEntityActions(entity: BaseEntity, baseType: 'save' | 'delete' | 'validate', before: boolean, user: UserInfo): Promise<ActionResult[]>;
+    /**
+     * Handles Entity AI Actions for save or delete operations.
+     *
+     * For "before save" actions: blocks (awaits) until complete.
+     * For "after save" actions: fires and forgets via QueueManager.
+     *
+     * Subclasses that manage transactions can override to defer after-save tasks
+     * until after transaction commit (see SQLServerDataProvider).
+     */
+    protected HandleEntityAIActions(entity: BaseEntity, baseType: 'save' | 'delete', before: boolean, user: UserInfo): Promise<void>;
+    /**
+     * Enqueues an after-save AI action for execution. By default, immediately adds
+     * to QueueManager. Subclasses with transaction support can override to defer
+     * until after transaction commit.
+     */
+    protected EnqueueAfterSaveAIAction(params: EntityAIActionParams, user: UserInfo): void;
+    /**************************************************************************/
+    /**************************************************************************/
+    protected OnValidateBeforeSave(entity: BaseEntity, user: UserInfo): Promise<string | null>;
+    protected OnBeforeSaveExecute(entity: BaseEntity, user: UserInfo, options: EntitySaveOptions): Promise<void>;
+    protected OnAfterSaveExecute(entity: BaseEntity, user: UserInfo, options: EntitySaveOptions): void;
+    protected OnBeforeDeleteExecute(entity: BaseEntity, user: UserInfo, options: EntityDeleteOptions): Promise<void>;
+    protected OnAfterDeleteExecute(entity: BaseEntity, user: UserInfo, options: EntityDeleteOptions): void;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Post-processes rows: first applies platform-specific datetime adjustments
+     * via the virtual `AdjustDatetimeFields` hook, then handles field-level
+     * decryption for encrypted fields.
+     *
+     * Subclasses should NOT override this method. Instead, override
+     * `AdjustDatetimeFields` for platform-specific datetime corrections.
+     */
+    protected PostProcessRows(rows: Record<string, unknown>[], entityInfo: EntityInfo, user: UserInfo): Promise<Record<string, unknown>[]>;
+    /**
+     * Virtual hook for platform-specific datetime field adjustments.
+     * Default implementation is a no-op (returns rows unchanged).
+     *
+     * SQL Server overrides this to correct datetime2/datetimeoffset/datetime
+     * timezone interpretation issues in the mssql driver.
+     * PostgreSQL does NOT need to override — PG timestamp types are timezone-aware natively.
+     *
+     * @param rows The data rows to process
+     * @param datetimeFields Entity fields with TSType === Date
+     * @param entityInfo The entity metadata
+     * @returns The rows with datetime fields adjusted (or unchanged for default)
+     */
+    protected AdjustDatetimeFields(rows: Record<string, unknown>[], datetimeFields: EntityFieldInfo[], entityInfo: EntityInfo): Promise<Record<string, unknown>[]>;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Executes multiple SQL queries and returns an array of result arrays, one per query.
+     *
+     * The default implementation runs queries in parallel using `Promise.all(ExecuteSQL(...))`.
+     * Platform-specific providers can override for true multi-result-set batching:
+     * - SQL Server: concatenates queries and uses a single mssql request with multiple recordsets
+     * - PostgreSQL: could use pg pipeline or simple parallel execution
+     *
+     * @param queries Array of SQL query strings to execute
+     * @param parameters Optional array of parameter arrays, one per query
+     * @param options Optional batch execution options
+     * @param contextUser Optional user context for logging/filtering
+     * @returns Array of result arrays, one for each query
+     */
+    ExecuteSQLBatch(queries: string[], parameters?: unknown[][], options?: ExecuteSQLBatchOptions, contextUser?: UserInfo): Promise<Record<string, unknown>[][]>;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Builds a platform-specific pagination clause.
+     * SQL Server: `OFFSET X ROWS FETCH NEXT Y ROWS ONLY`
+     * PostgreSQL: `LIMIT Y OFFSET X`
+     */
+    protected abstract BuildPaginationSQL(maxRows: number, startRow: number): string;
+    /**
+     * Builds a platform-specific TOP/LIMIT clause for non-paginated row limits.
+     * SQL Server: `TOP N`; PostgreSQL returns empty (uses LIMIT via BuildPaginationSQL).
+     * Default: returns empty string. SQL Server overrides.
+     */
+    protected BuildTopClause(_maxRows: number): string;
+    /**
+     * Builds a platform-specific non-paginated row limit clause appended at end of query.
+     * SQL Server: returns '' (already handled by TOP in SELECT clause).
+     * PostgreSQL: returns `LIMIT N`.
+     * Default: returns empty string. PG overrides.
+     */
+    protected BuildNonPaginatedLimitSQL(_maxRows: number): string;
+    /**
+     * Transforms a user-provided SQL clause (ExtraFilter, OrderBy, etc.) for platform compatibility.
+     * PostgreSQL overrides to quote mixed-case identifiers and convert bracket notation.
+     * Default: returns the clause unchanged.
+     */
+    protected TransformExternalSQLClause(clause: string, _entityInfo: EntityInfo): string;
+    /**
+     * Optionally wraps a view query with user view run logging.
+     * SQL Server overrides to use spCreateUserViewRunWithDetail.
+     * Default: returns null (no view run logging).
+     */
+    protected executeSQLForUserViewRunLogging(_viewId: number, _entityBaseView: string, _whereSQL: string, _orderBySQL: string, _user: UserInfo): Promise<{
+        executeViewSQL: string;
+        runID: string;
+    } | null>;
+    /**
+     * Shared InternalRunView implementation.
+     * Handles: view resolution, permissions, field selection, WHERE clause building
+     * (view + extra filter + user search + exclude + RLS), ORDER BY, pagination,
+     * aggregates, parallel query execution, post-processing, and audit logging.
+     */
+    protected InternalRunView<T = unknown>(params: RunViewParams, contextUser?: UserInfo): Promise<RunViewResult<T>>;
+    protected InternalRunViews<T = unknown>(params: RunViewParams[], contextUser?: UserInfo): Promise<RunViewResult<T>[]>;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Builds the SQL field list string for a view query, using dialect-neutral quoting.
+     * Returns '*' if no specific fields are resolved.
+     */
+    protected getRunTimeViewFieldString(params: RunViewParams, viewEntity: MJUserViewEntityExtended | null): string;
+    /**
+     * Resolves the list of EntityFieldInfo objects for a view query.
+     * Priority: params.Fields > view columns > all entity fields (wildcard).
+     */
+    protected getRunTimeViewFieldArray(params: RunViewParams, viewEntity: MJUserViewEntityExtended | null): EntityFieldInfo[];
+    /**
+     * Builds user search SQL for the given entity and search string.
+     * Supports full-text search (if enabled) and field-by-field LIKE searching.
+     */
+    protected createViewUserSearchSQL(entityInfo: EntityInfo, userSearchString: string): string;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Renders the WHERE clause for a saved view, replacing template variables
+     * like {%UserView "viewId"%} with subquery SQL. Handles nested/recursive
+     * templates with circular reference detection.
+     *
+     * Uses QuoteIdentifier/QuoteSchemaAndView for dialect-neutral SQL generation.
+     */
+    protected RenderViewWhereClause(viewEntity: MJUserViewEntityExtended, user: UserInfo, stack?: string[]): Promise<string>;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Compares client cache status with server status to determine if cache is current.
+     * Checks both row count and maxUpdatedAt timestamp.
+     */
+    protected isCacheCurrent(clientStatus: {
+        maxUpdatedAt: string;
+        rowCount: number;
+    }, serverStatus: {
+        maxUpdatedAt?: string;
+        rowCount?: number;
+    }): boolean;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Smart cache validation for batch RunViews.
+     * For each view request, if cacheStatus is provided, checks if the cache is current
+     * by comparing MAX(__mj_UpdatedAt) and COUNT(*) with client's values.
+     * Returns 'current' if cache is valid (no data), 'stale' with fresh data, or 'differential'
+     * with only changed rows for entities that track record changes.
+     */
+    RunViewsWithCacheCheck<T = unknown>(params: RunViewWithCacheCheckParams[], contextUser?: UserInfo): Promise<RunViewsWithCacheCheckResponse<T>>;
+    /**
+     * Builds the WHERE clause for cache status check, using same logic as InternalRunView.
+     * Handles ExtraFilter, UserSearch, and Row-Level Security.
+     * Subclasses can override to add platform-specific SQL transformations (e.g., identifier quoting).
+     */
+    protected buildWhereClauseForCacheCheck(params: RunViewParams, entityInfo: EntityInfo, user: UserInfo): Promise<string>;
+    /**
+     * Executes cache status checks for multiple views.
+     * Default: parallel individual queries (works on all platforms).
+     * SQL Server overrides to use ExecuteSQLBatch for multi-result-set efficiency.
+     */
+    protected getBatchedServerCacheStatus(items: Array<{
+        index: number;
+        item: RunViewWithCacheCheckParams;
+        entityInfo: EntityInfo;
+        whereSQL: string;
+    }>, contextUser?: UserInfo): Promise<Map<number, {
+        success: boolean;
+        maxUpdatedAt?: string;
+        rowCount?: number;
+        errorMessage?: string;
+    }>>;
+    /**
+     * Runs a full view query and returns results with cache metadata.
+     */
+    protected runFullQueryAndReturn<T = unknown>(params: RunViewParams, viewIndex: number, contextUser?: UserInfo): Promise<RunViewWithCacheCheckResult<T>>;
+    /**
+     * Runs a differential query and returns only changes since the client's cached state.
+     * Includes updated/created rows and deleted record IDs.
+     * Falls back to full query if hidden deletes are detected.
+     */
+    protected runDifferentialQueryAndReturn<T = unknown>(params: RunViewParams, entityInfo: EntityInfo, clientMaxUpdatedAt: string, clientRowCount: number, serverStatus: {
+        maxUpdatedAt?: string;
+        rowCount?: number;
+    }, whereSQL: string, viewIndex: number, contextUser?: UserInfo): Promise<RunViewWithCacheCheckResult<T>>;
+    /**
+     * Gets IDs of records deleted since a given timestamp.
+     * Uses dialect-neutral quoting. Subclasses can override for parameterized queries.
+     */
+    protected getDeletedRecordIDsSince(entityID: string, sinceTimestamp: string, contextUser?: UserInfo): Promise<string[]>;
+    /**
+     * Gets rows updated/created since a given timestamp.
+     * Uses dialect-neutral quoting and TransformExternalSQLClause for OrderBy.
+     */
+    protected getUpdatedRowsSince<T = unknown>(params: RunViewParams, entityInfo: EntityInfo, sinceTimestamp: string, whereSQL: string, contextUser?: UserInfo): Promise<T[]>;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Smart cache validation for batch RunQueries.
+     * For each query, if cacheStatus is provided, checks CacheValidationSQL to determine staleness.
+     * Returns 'current' if cache is valid, 'stale' with fresh data, or 'no_validation' if
+     * the query has no CacheValidationSQL configured.
+     */
+    RunQueriesWithCacheCheck<T = unknown>(params: RunQueryWithCacheCheckParams[], contextUser?: UserInfo): Promise<RunQueriesWithCacheCheckResponse<T>>;
+    /**
+     * Resolves QueryInfo from RunQueryParams (by ID or Name+CategoryPath).
+     * Tries QueryEngine first for fresh data, falls back to ProviderBase cache.
+     */
+    protected resolveQueryInfo(params: RunQueryParams): QueryInfo | undefined;
+    /**
+     * Searches QueryEngine for a fresh query entity.
+     */
+    protected findQueryInEngine(QueryID: string | undefined, QueryName: string | undefined, CategoryID: string | undefined, CategoryPath: string | undefined): MJQueryEntity | null;
+    /**
+     * Creates a fresh QueryInfo from a MJQueryEntity and patches the ProviderBase cache.
+     */
+    protected refreshQueryInfoFromEntity(entity: MJQueryEntity): QueryInfo;
+    /**
+     * Resolves a category path string to a QueryCategoryInfo ID.
+     */
+    protected resolveCategoryPath(categoryPath: string): string | null;
+    /**
+     * Executes cache status checks for multiple queries using their CacheValidationSQL.
+     * Default: parallel individual queries. SQL Server overrides for batch execution.
+     */
+    protected getBatchedQueryCacheStatus(items: Array<{
+        index: number;
+        item: RunQueryWithCacheCheckParams;
+        queryInfo: QueryInfo;
+    }>, contextUser?: UserInfo): Promise<Map<number, {
+        success: boolean;
+        maxUpdatedAt?: string;
+        rowCount?: number;
+        errorMessage?: string;
+    }>>;
+    /**
+     * Runs a full query and returns results with cache metadata.
+     */
+    protected runFullQueryAndReturnForQuery<T = unknown>(params: RunQueryParams, queryIndex: number, status: 'stale' | 'no_validation', contextUser?: UserInfo, queryId?: string): Promise<RunQueryWithCacheCheckResult<T>>;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Loads a single entity record by composite key, with optional relationship loading.
+     * Uses dialect-neutral quoting for all SQL construction.
+     */
+    Load(entity: BaseEntity, compositeKey: CompositeKey, entityRelationshipsToLoad: string[] | null | undefined, user: UserInfo): Promise<Record<string, unknown> | null>;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Builds a parameter placeholder for parameterized queries.
+     * Default: PG-style ($1, $2, ...). SQL Server overrides to @p0, @p1, etc.
+     */
+    protected BuildParameterPlaceholder(index: number): string;
+    /**
+     * Retrieves a dataset by name, executing all item queries via ExecuteSQLBatch
+     * and aggregating results. Uses dialect-neutral quoting for all SQL construction.
+     *
+     * ExecuteSQLBatch gives SQL Server true multi-result-set batching automatically,
+     * while PG (and the default) use parallel individual queries.
+     */
+    GetDatasetByName(datasetName: string, itemFilters?: DatasetItemFilterType[], contextUser?: UserInfo, providerToUse?: IMetadataProvider): Promise<DatasetResultType>;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Retrieves status information for a dataset by name: per-entity row count and
+     * latest update date. Uses ExecuteSQLBatch for per-item status queries.
+     */
+    GetDatasetStatusByName(datasetName: string, itemFilters?: DatasetItemFilterType[], contextUser?: UserInfo, providerToUse?: IMetadataProvider): Promise<DatasetStatusResultType>;
+    /**************************************************************************/
+    /**************************************************************************/
+    /**
+     * Validates columns for a dataset item and returns the column list string.
+     * Returns null if columns are invalid.
+     */
+    protected getColumnsForDatasetItem(item: Record<string, unknown>, datasetName: string): string | null;
+}
+//# sourceMappingURL=GenericDatabaseProvider.d.ts.map

package/dist/GenericDatabaseProvider.d.ts.map

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