@memberjunction/graphql-dataprovider 2.128.0 → 2.130.0

package/dist/index.d.cts

@@ -1,11 +1,12 @@
 import { GraphQLClient } from 'graphql-request';
 export { gql } from 'graphql-request';
-import { ProviderConfigDataBase, ProviderBase, IEntityDataProvider, IMetadataProvider, IRunViewProvider, IRunReportProvider, IRunQueryProvider, EntityInfo, UserInfo, RunReportParams, RunReportResult, RunQueryParams, RunQueryResult, RunViewParams, RunViewResult, ProviderType, CompositeKey, RecordChange, RecordDependency, KeyValuePair, PotentialDuplicateRequest, PotentialDuplicateResponse, RecordMergeRequest, EntityMergeOptions, RecordMergeResult, BaseEntity, EntitySaveOptions, EntityDeleteOptions, DatasetItemFilterType, DatasetResultType, DatasetStatusResultType, TransactionGroupBase, EntityRecordNameInput, EntityRecordNameResult, ILocalStorageProvider, TransactionResult } from '@memberjunction/core';
+import { ProviderConfigDataBase, ProviderBase, IEntityDataProvider, IMetadataProvider, IRunReportProvider, UserInfo, RunReportParams, RunReportResult, RunQueryParams, RunQueryResult, RunQueryWithCacheCheckParams, RunQueriesWithCacheCheckResponse, RunViewParams, RunViewResult, RunViewWithCacheCheckParams, RunViewsWithCacheCheckResponse, EntityInfo, ProviderType, CompositeKey, RecordChange, RecordDependency, KeyValuePair, PotentialDuplicateRequest, PotentialDuplicateResponse, RecordMergeRequest, EntityMergeOptions, RecordMergeResult, BaseEntity, EntitySaveOptions, EntityDeleteOptions, DatasetItemFilterType, DatasetResultType, DatasetStatusResultType, TransactionGroupBase, EntityRecordNameInput, EntityRecordNameResult, ILocalStorageProvider, TransactionResult } from '@memberjunction/core';
 import { UserViewEntityExtended } from '@memberjunction/core-entities';
 import { Observable } from 'rxjs';
 import { ExecuteAgentParams, ExecuteAgentResult } from '@memberjunction/ai-core-plus';
 import { ActionParam, ActionResult, EntityActionInvocationParams, EntityActionResult } from '@memberjunction/actions-base';
 import { ComponentSpec } from '@memberjunction/interactive-component-types';
+import { DBSchema } from '@tempfix/idb';
 
 /**
  * Client for executing AI operations through GraphQL.
@@ -151,6 +152,33 @@ declare class GraphQLAIClient {
      * @private
      */
     private handleAgentError;
+    /**
+     * Run an AI agent using an existing conversation detail ID.
+     * This is an optimized method that loads conversation history server-side,
+     * avoiding the need to send large attachment data from client to server.
+     *
+     * Use this method when:
+     * - The user's message has already been saved as a ConversationDetail
+     * - The conversation may have attachments (images, documents, etc.)
+     * - You want optimal performance by loading history on the server
+     *
+     * @param params The parameters for running the AI agent from conversation detail
+     * @returns A Promise that resolves to an ExecuteAgentResult object
+     *
+     * @example
+     * ```typescript
+     * const result = await aiClient.RunAIAgentFromConversationDetail({
+     *   conversationDetailId: "detail-id-123",
+     *   agentId: "agent-id",
+     *   maxHistoryMessages: 20,
+     *   createArtifacts: true,
+     *   onProgress: (progress) => {
+     *     console.log(`Progress: ${progress.message}`);
+     *   }
+     * });
+     * ```
+     */
+    RunAIAgentFromConversationDetail(params: RunAIAgentFromConversationDetailParams): Promise<ExecuteAgentResult>;
     /**
      * Execute a simple prompt without requiring a stored AI Prompt entity.
      * This method is designed for interactive components that need quick AI responses.
@@ -426,6 +454,69 @@ interface RunAIPromptResult {
      */
     chatResult?: any;
 }
+/**
+ * Parameters for running an AI agent from an existing conversation detail.
+ * This is the optimized method that loads conversation history server-side.
+ */
+interface RunAIAgentFromConversationDetailParams {
+    /**
+     * The ID of the conversation detail (user's message) to use as context
+     */
+    conversationDetailId: string;
+    /**
+     * The ID of the AI agent to run
+     */
+    agentId: string;
+    /**
+     * Maximum number of history messages to include (default: 20)
+     */
+    maxHistoryMessages?: number;
+    /**
+     * Data context to pass to the agent (will be JSON serialized)
+     */
+    data?: Record<string, unknown>;
+    /**
+     * Payload to pass to the agent (will be JSON serialized)
+     */
+    payload?: Record<string, unknown> | string;
+    /**
+     * ID of the last agent run for continuity
+     */
+    lastRunId?: string;
+    /**
+     * Whether to auto-populate payload from last run
+     */
+    autoPopulateLastRunPayload?: boolean;
+    /**
+     * Configuration ID to use
+     */
+    configurationId?: string;
+    /**
+     * Whether to create artifacts from the agent's payload
+     */
+    createArtifacts?: boolean;
+    /**
+     * Whether to create a user notification on completion
+     */
+    createNotification?: boolean;
+    /**
+     * Source artifact ID for versioning
+     */
+    sourceArtifactId?: string;
+    /**
+     * Source artifact version ID for versioning
+     */
+    sourceArtifactVersionId?: string;
+    /**
+     * Optional callback for progress updates
+     */
+    onProgress?: (progress: {
+        currentStep: string;
+        percentage?: number;
+        message: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+}
 
 /**************************************************************************************************************
  * The graphQLDataProvider provides a data provider for the entities framework that uses GraphQL to communicate
@@ -482,7 +573,7 @@ declare class GraphQLProviderConfigData extends ProviderConfigDataBase {
  * The GraphQLDataProvider class is a data provider for MemberJunction that implements the IEntityDataProvider, IMetadataProvider, IRunViewProvider, IRunReportProvider, IRunQueryProvider interfaces and connects to the
  * MJAPI server using GraphQL. This class is used to interact with the server to get and save data, as well as to get metadata about the entities and fields in the system.
  */
-declare class GraphQLDataProvider extends ProviderBase implements IEntityDataProvider, IMetadataProvider, IRunViewProvider, IRunReportProvider, IRunQueryProvider {
+declare class GraphQLDataProvider extends ProviderBase implements IEntityDataProvider, IMetadataProvider, IRunReportProvider {
     private static _instance;
     static get Instance(): GraphQLDataProvider;
     constructor();
@@ -492,36 +583,6 @@ declare class GraphQLDataProvider extends ProviderBase implements IEntityDataPro
     private _aiClient;
     private _refreshPromise;
     get ConfigData(): GraphQLProviderConfigData;
-    /**
-     * The core schema name constant. This should match the mjCoreSchema config value.
-     * TODO: Move this to @memberjunction/core once npm registration issues are resolved
-     * @see https://github.com/MemberJunction/MJ/issues/1452
-     */
-    protected static readonly MJ_CORE_SCHEMA = "__mj";
-    /**
-     * Sanitizes a string to be a valid GraphQL name component, preserving original capitalization.
-     * GraphQL names must match the pattern [_A-Za-z][_0-9A-Za-z]* and cannot start with double underscore
-     *
-     * TODO: Move this to @memberjunction/core once npm registration issues are resolved
-     * @see https://github.com/MemberJunction/MJ/issues/1452
-     *
-     * Copied from @memberjunction/codegen-lib GraphQLServerGeneratorBase.sanitizeGraphQLName()
-     */
-    protected sanitizeGraphQLName(input: string): string;
-    /**
-     * Generates the base GraphQL type name for an entity using SchemaBaseTable pattern.
-     * Preserves original capitalization. Special case: MJ core schema uses "MJ" prefix.
-     * This ensures unique type names across different schemas.
-     *
-     * TODO: Move this to @memberjunction/core once npm registration issues are resolved
-     * @see https://github.com/MemberJunction/MJ/issues/1452
-     *
-     * Copied from @memberjunction/codegen-lib GraphQLServerGeneratorBase.getServerGraphQLTypeNameBase()
-     *
-     * @param entity - The entity to generate the type name for
-     * @returns The base GraphQL type name (without suffix like ViewByID, DynamicView, etc.)
-     */
-    protected getGraphQLTypeNameBase(entity: EntityInfo): string;
     /**
      * Gets the AI client for executing AI operations through GraphQL.
      * The client is lazily initialized on first access.
@@ -584,17 +645,39 @@ declare class GraphQLDataProvider extends ProviderBase implements IEntityDataPro
     /**************************************************************************/
     /**************************************************************************/
     /**************************************************************************/
-    RunQuery(params: RunQueryParams, contextUser?: UserInfo): Promise<RunQueryResult>;
+    protected InternalRunQuery(params: RunQueryParams, contextUser?: UserInfo): Promise<RunQueryResult>;
+    protected InternalRunQueries(params: RunQueryParams[], contextUser?: UserInfo): Promise<RunQueryResult[]>;
     RunQueryByID(QueryID: string, CategoryID?: string, CategoryPath?: string, contextUser?: UserInfo, Parameters?: Record<string, any>, MaxRows?: number, StartRow?: number): Promise<RunQueryResult>;
     RunQueryByName(QueryName: string, CategoryID?: string, CategoryPath?: string, contextUser?: UserInfo, Parameters?: Record<string, any>, MaxRows?: number, StartRow?: number): Promise<RunQueryResult>;
     protected get QueryReturnFieldList(): string;
     protected TransformQueryPayload(data: any): RunQueryResult;
+    /**
+     * RunQueriesWithCacheCheck - Smart cache validation for batch RunQueries.
+     * For each query, if cacheStatus is provided, the server checks if the cache is current
+     * using the Query's CacheValidationSQL. If current, returns status='current' with no data.
+     * If stale, returns status='stale' with fresh data.
+     *
+     * @param params - Array of RunQuery requests with optional cache status
+     * @param contextUser - Optional user context
+     * @returns Response containing results for each query in the batch
+     */
+    RunQueriesWithCacheCheck<T = unknown>(params: RunQueryWithCacheCheckParams[], contextUser?: UserInfo): Promise<RunQueriesWithCacheCheckResponse<T>>;
     /**************************************************************************/
     /**************************************************************************/
     /**************************************************************************/
     /**************************************************************************/
-    RunView<T = any>(params: RunViewParams, contextUser?: UserInfo): Promise<RunViewResult<T>>;
-    RunViews<T = any>(params: RunViewParams[], contextUser?: UserInfo): Promise<RunViewResult<T>[]>;
+    protected InternalRunView<T = any>(params: RunViewParams, contextUser?: UserInfo): Promise<RunViewResult<T>>;
+    protected InternalRunViews<T = any>(params: RunViewParams[], contextUser?: UserInfo): Promise<RunViewResult<T>[]>;
+    /**
+     * RunViewsWithCacheCheck - Smart cache validation for batch RunViews.
+     * For each view, if cacheStatus is provided, the server checks if the cache is current.
+     * If current, returns status='current' with no data. If stale, returns status='stale' with fresh data.
+     *
+     * @param params - Array of RunView requests with optional cache status
+     * @param contextUser - Optional user context
+     * @returns Response containing results for each view in the batch
+     */
+    RunViewsWithCacheCheck<T = unknown>(params: RunViewWithCacheCheckParams[], contextUser?: UserInfo): Promise<RunViewsWithCacheCheckResponse<T>>;
     protected getEntityNameAndUserView(params: RunViewParams, contextUser?: UserInfo): Promise<{
         entityName: string;
         v: UserViewEntityExtended;
@@ -2146,6 +2229,7 @@ interface RunTestParams {
     testId: string;
     verbose?: boolean;
     environment?: string;
+    tags?: string[];
     onProgress?: (progress: TestExecutionProgress) => void;
 }
 /**
@@ -2165,6 +2249,22 @@ interface RunTestSuiteParams {
     verbose?: boolean;
     environment?: string;
     parallel?: boolean;
+    tags?: string[];
+    /**
+     * Run only specific tests by their IDs.
+     * If provided, only tests with matching IDs will be executed.
+     */
+    selectedTestIds?: string[];
+    /**
+     * Start execution from this sequence number (inclusive).
+     * Tests with sequence numbers less than this value will be skipped.
+     */
+    sequenceStart?: number;
+    /**
+     * Stop execution at this sequence number (inclusive).
+     * Tests with sequence numbers greater than this value will be skipped.
+     */
+    sequenceEnd?: number;
     onProgress?: (progress: TestExecutionProgress) => void;
 }
 /**
@@ -2700,4 +2800,80 @@ declare class GraphQLComponentRegistryClient {
     SendComponentFeedback(params: ComponentFeedbackParams): Promise<ComponentFeedbackResponse>;
 }
 
-export { ActionItemInput, ActionItemOutput, type ComponentDependencyTree, type ComponentSpecWithHash, type CreateQueryInput, type CreateQueryResult, type DeleteQueryOptionsInput, type DeleteQueryResult, type EmbedTextParams, type EmbedTextResult, type ExecuteSimplePromptParams, FieldMapper, GetDataOutput, type GetQueryDataByNameSystemUserInput, type GetQueryDataSystemUserInput, type GetRegistryComponentParams, GraphQLAIClient, GraphQLActionClient, GraphQLComponentRegistryClient, GraphQLDataProvider, GraphQLProviderConfigData, GraphQLSystemUserClient, GraphQLTestingClient, GraphQLTransactionGroup, type QueryEntity, type QueryField, type QueryParameter, type QueryPermission, type QueryPermissionInput, type RegistryComponentSearchResult, RoleInput, RolesAndUsersInput, type RunAIPromptParams, type RunAIPromptResult, type RunDynamicViewSystemUserInput, type RunQuerySystemUserResult, type RunTestParams, type RunTestResult, type RunTestSuiteParams, type RunTestSuiteResult, type RunViewByIDSystemUserInput, type RunViewByNameSystemUserInput, type RunViewSystemUserInput, type RunViewSystemUserResult, type RunViewSystemUserResultRow, type SearchRegistryComponentsParams, type SimplePromptResult, SimpleRemoteEntity, SimpleRemoteEntityField, SimpleRemoteEntityOutput, SyncDataAction, SyncDataResult, SyncRolesAndUsersResult, type TestExecutionProgress, type UpdateQueryInput, type UpdateQueryResult, UserInput, setupGraphQLClient };
+/**
+ * In-memory storage provider using nested Map structure for category isolation.
+ * Used as a fallback when browser storage is not available.
+ *
+ * Storage structure: Map<category, Map<key, value>>
+ */
+declare class BrowserStorageProviderBase implements ILocalStorageProvider {
+    private _storage;
+    /**
+     * Gets or creates a category map
+     */
+    private getCategoryMap;
+    GetItem(key: string, category?: string): Promise<string | null>;
+    SetItem(key: string, value: string, category?: string): Promise<void>;
+    Remove(key: string, category?: string): Promise<void>;
+    ClearCategory(category: string): Promise<void>;
+    GetCategoryKeys(category: string): Promise<string[]>;
+}
+/**
+ * IndexedDB schema with dynamic object stores per category.
+ * Each category gets its own object store: mj:CategoryName
+ */
+interface MJ_MetadataDB extends DBSchema {
+    'mj:default': {
+        key: string;
+        value: string;
+    };
+    'mj:Metadata': {
+        key: string;
+        value: string;
+    };
+    'mj:RunViewCache': {
+        key: string;
+        value: string;
+    };
+    'mj:RunQueryCache': {
+        key: string;
+        value: string;
+    };
+    'mj:DatasetCache': {
+        key: string;
+        value: string;
+    };
+}
+/**
+ * IndexedDB storage provider with category support via separate object stores.
+ *
+ * Known categories (mj:Metadata, mj:RunViewCache, etc.) get dedicated object stores.
+ * Unknown categories fall back to the default store with prefixed keys.
+ */
+declare class BrowserIndexedDBStorageProvider extends BrowserStorageProviderBase {
+    private dbPromise;
+    private _dbReady;
+    constructor();
+    /**
+     * Checks if a category has a dedicated object store
+     */
+    private isKnownCategory;
+    /**
+     * Gets the object store name for a category.
+     * Returns the dedicated store if it exists, otherwise returns the default store.
+     */
+    private getStoreName;
+    /**
+     * Gets the key to use in the store.
+     * For known stores, use the key as-is.
+     * For unknown categories using the default store, prefix with category.
+     */
+    private getStoreKey;
+    SetItem(key: string, value: string, category?: string): Promise<void>;
+    GetItem(key: string, category?: string): Promise<string | null>;
+    Remove(key: string, category?: string): Promise<void>;
+    ClearCategory(category: string): Promise<void>;
+    GetCategoryKeys(category: string): Promise<string[]>;
+}
+
+export { ActionItemInput, ActionItemOutput, BrowserIndexedDBStorageProvider, BrowserStorageProviderBase, type ComponentDependencyTree, type ComponentSpecWithHash, type CreateQueryInput, type CreateQueryResult, type DeleteQueryOptionsInput, type DeleteQueryResult, type EmbedTextParams, type EmbedTextResult, type ExecuteSimplePromptParams, FieldMapper, GetDataOutput, type GetQueryDataByNameSystemUserInput, type GetQueryDataSystemUserInput, type GetRegistryComponentParams, GraphQLAIClient, GraphQLActionClient, GraphQLComponentRegistryClient, GraphQLDataProvider, GraphQLProviderConfigData, GraphQLSystemUserClient, GraphQLTestingClient, GraphQLTransactionGroup, type MJ_MetadataDB, type QueryEntity, type QueryField, type QueryParameter, type QueryPermission, type QueryPermissionInput, type RegistryComponentSearchResult, RoleInput, RolesAndUsersInput, type RunAIPromptParams, type RunAIPromptResult, type RunDynamicViewSystemUserInput, type RunQuerySystemUserResult, type RunTestParams, type RunTestResult, type RunTestSuiteParams, type RunTestSuiteResult, type RunViewByIDSystemUserInput, type RunViewByNameSystemUserInput, type RunViewSystemUserInput, type RunViewSystemUserResult, type RunViewSystemUserResultRow, type SearchRegistryComponentsParams, type SimplePromptResult, SimpleRemoteEntity, SimpleRemoteEntityField, SimpleRemoteEntityOutput, SyncDataAction, SyncDataResult, SyncRolesAndUsersResult, type TestExecutionProgress, type UpdateQueryInput, type UpdateQueryResult, UserInput, setupGraphQLClient };

package/dist/index.d.mts

@@ -1,11 +1,12 @@
 import { GraphQLClient } from 'graphql-request';
 export { gql } from 'graphql-request';
-import { ProviderConfigDataBase, ProviderBase, IEntityDataProvider, IMetadataProvider, IRunViewProvider, IRunReportProvider, IRunQueryProvider, EntityInfo, UserInfo, RunReportParams, RunReportResult, RunQueryParams, RunQueryResult, RunViewParams, RunViewResult, ProviderType, CompositeKey, RecordChange, RecordDependency, KeyValuePair, PotentialDuplicateRequest, PotentialDuplicateResponse, RecordMergeRequest, EntityMergeOptions, RecordMergeResult, BaseEntity, EntitySaveOptions, EntityDeleteOptions, DatasetItemFilterType, DatasetResultType, DatasetStatusResultType, TransactionGroupBase, EntityRecordNameInput, EntityRecordNameResult, ILocalStorageProvider, TransactionResult } from '@memberjunction/core';
+import { ProviderConfigDataBase, ProviderBase, IEntityDataProvider, IMetadataProvider, IRunReportProvider, UserInfo, RunReportParams, RunReportResult, RunQueryParams, RunQueryResult, RunQueryWithCacheCheckParams, RunQueriesWithCacheCheckResponse, RunViewParams, RunViewResult, RunViewWithCacheCheckParams, RunViewsWithCacheCheckResponse, EntityInfo, ProviderType, CompositeKey, RecordChange, RecordDependency, KeyValuePair, PotentialDuplicateRequest, PotentialDuplicateResponse, RecordMergeRequest, EntityMergeOptions, RecordMergeResult, BaseEntity, EntitySaveOptions, EntityDeleteOptions, DatasetItemFilterType, DatasetResultType, DatasetStatusResultType, TransactionGroupBase, EntityRecordNameInput, EntityRecordNameResult, ILocalStorageProvider, TransactionResult } from '@memberjunction/core';
 import { UserViewEntityExtended } from '@memberjunction/core-entities';
 import { Observable } from 'rxjs';
 import { ExecuteAgentParams, ExecuteAgentResult } from '@memberjunction/ai-core-plus';
 import { ActionParam, ActionResult, EntityActionInvocationParams, EntityActionResult } from '@memberjunction/actions-base';
 import { ComponentSpec } from '@memberjunction/interactive-component-types';
+import { DBSchema } from '@tempfix/idb';
 
 /**
  * Client for executing AI operations through GraphQL.
@@ -151,6 +152,33 @@ declare class GraphQLAIClient {
      * @private
      */
     private handleAgentError;
+    /**
+     * Run an AI agent using an existing conversation detail ID.
+     * This is an optimized method that loads conversation history server-side,
+     * avoiding the need to send large attachment data from client to server.
+     *
+     * Use this method when:
+     * - The user's message has already been saved as a ConversationDetail
+     * - The conversation may have attachments (images, documents, etc.)
+     * - You want optimal performance by loading history on the server
+     *
+     * @param params The parameters for running the AI agent from conversation detail
+     * @returns A Promise that resolves to an ExecuteAgentResult object
+     *
+     * @example
+     * ```typescript
+     * const result = await aiClient.RunAIAgentFromConversationDetail({
+     *   conversationDetailId: "detail-id-123",
+     *   agentId: "agent-id",
+     *   maxHistoryMessages: 20,
+     *   createArtifacts: true,
+     *   onProgress: (progress) => {
+     *     console.log(`Progress: ${progress.message}`);
+     *   }
+     * });
+     * ```
+     */
+    RunAIAgentFromConversationDetail(params: RunAIAgentFromConversationDetailParams): Promise<ExecuteAgentResult>;
     /**
      * Execute a simple prompt without requiring a stored AI Prompt entity.
      * This method is designed for interactive components that need quick AI responses.
@@ -426,6 +454,69 @@ interface RunAIPromptResult {
      */
     chatResult?: any;
 }
+/**
+ * Parameters for running an AI agent from an existing conversation detail.
+ * This is the optimized method that loads conversation history server-side.
+ */
+interface RunAIAgentFromConversationDetailParams {
+    /**
+     * The ID of the conversation detail (user's message) to use as context
+     */
+    conversationDetailId: string;
+    /**
+     * The ID of the AI agent to run
+     */
+    agentId: string;
+    /**
+     * Maximum number of history messages to include (default: 20)
+     */
+    maxHistoryMessages?: number;
+    /**
+     * Data context to pass to the agent (will be JSON serialized)
+     */
+    data?: Record<string, unknown>;
+    /**
+     * Payload to pass to the agent (will be JSON serialized)
+     */
+    payload?: Record<string, unknown> | string;
+    /**
+     * ID of the last agent run for continuity
+     */
+    lastRunId?: string;
+    /**
+     * Whether to auto-populate payload from last run
+     */
+    autoPopulateLastRunPayload?: boolean;
+    /**
+     * Configuration ID to use
+     */
+    configurationId?: string;
+    /**
+     * Whether to create artifacts from the agent's payload
+     */
+    createArtifacts?: boolean;
+    /**
+     * Whether to create a user notification on completion
+     */
+    createNotification?: boolean;
+    /**
+     * Source artifact ID for versioning
+     */
+    sourceArtifactId?: string;
+    /**
+     * Source artifact version ID for versioning
+     */
+    sourceArtifactVersionId?: string;
+    /**
+     * Optional callback for progress updates
+     */
+    onProgress?: (progress: {
+        currentStep: string;
+        percentage?: number;
+        message: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+}
 
 /**************************************************************************************************************
  * The graphQLDataProvider provides a data provider for the entities framework that uses GraphQL to communicate
@@ -482,7 +573,7 @@ declare class GraphQLProviderConfigData extends ProviderConfigDataBase {
  * The GraphQLDataProvider class is a data provider for MemberJunction that implements the IEntityDataProvider, IMetadataProvider, IRunViewProvider, IRunReportProvider, IRunQueryProvider interfaces and connects to the
  * MJAPI server using GraphQL. This class is used to interact with the server to get and save data, as well as to get metadata about the entities and fields in the system.
  */
-declare class GraphQLDataProvider extends ProviderBase implements IEntityDataProvider, IMetadataProvider, IRunViewProvider, IRunReportProvider, IRunQueryProvider {
+declare class GraphQLDataProvider extends ProviderBase implements IEntityDataProvider, IMetadataProvider, IRunReportProvider {
     private static _instance;
     static get Instance(): GraphQLDataProvider;
     constructor();
@@ -492,36 +583,6 @@ declare class GraphQLDataProvider extends ProviderBase implements IEntityDataPro
     private _aiClient;
     private _refreshPromise;
     get ConfigData(): GraphQLProviderConfigData;
-    /**
-     * The core schema name constant. This should match the mjCoreSchema config value.
-     * TODO: Move this to @memberjunction/core once npm registration issues are resolved
-     * @see https://github.com/MemberJunction/MJ/issues/1452
-     */
-    protected static readonly MJ_CORE_SCHEMA = "__mj";
-    /**
-     * Sanitizes a string to be a valid GraphQL name component, preserving original capitalization.
-     * GraphQL names must match the pattern [_A-Za-z][_0-9A-Za-z]* and cannot start with double underscore
-     *
-     * TODO: Move this to @memberjunction/core once npm registration issues are resolved
-     * @see https://github.com/MemberJunction/MJ/issues/1452
-     *
-     * Copied from @memberjunction/codegen-lib GraphQLServerGeneratorBase.sanitizeGraphQLName()
-     */
-    protected sanitizeGraphQLName(input: string): string;
-    /**
-     * Generates the base GraphQL type name for an entity using SchemaBaseTable pattern.
-     * Preserves original capitalization. Special case: MJ core schema uses "MJ" prefix.
-     * This ensures unique type names across different schemas.
-     *
-     * TODO: Move this to @memberjunction/core once npm registration issues are resolved
-     * @see https://github.com/MemberJunction/MJ/issues/1452
-     *
-     * Copied from @memberjunction/codegen-lib GraphQLServerGeneratorBase.getServerGraphQLTypeNameBase()
-     *
-     * @param entity - The entity to generate the type name for
-     * @returns The base GraphQL type name (without suffix like ViewByID, DynamicView, etc.)
-     */
-    protected getGraphQLTypeNameBase(entity: EntityInfo): string;
     /**
      * Gets the AI client for executing AI operations through GraphQL.
      * The client is lazily initialized on first access.
@@ -584,17 +645,39 @@ declare class GraphQLDataProvider extends ProviderBase implements IEntityDataPro
     /**************************************************************************/
     /**************************************************************************/
     /**************************************************************************/
-    RunQuery(params: RunQueryParams, contextUser?: UserInfo): Promise<RunQueryResult>;
+    protected InternalRunQuery(params: RunQueryParams, contextUser?: UserInfo): Promise<RunQueryResult>;
+    protected InternalRunQueries(params: RunQueryParams[], contextUser?: UserInfo): Promise<RunQueryResult[]>;
     RunQueryByID(QueryID: string, CategoryID?: string, CategoryPath?: string, contextUser?: UserInfo, Parameters?: Record<string, any>, MaxRows?: number, StartRow?: number): Promise<RunQueryResult>;
     RunQueryByName(QueryName: string, CategoryID?: string, CategoryPath?: string, contextUser?: UserInfo, Parameters?: Record<string, any>, MaxRows?: number, StartRow?: number): Promise<RunQueryResult>;
     protected get QueryReturnFieldList(): string;
     protected TransformQueryPayload(data: any): RunQueryResult;
+    /**
+     * RunQueriesWithCacheCheck - Smart cache validation for batch RunQueries.
+     * For each query, if cacheStatus is provided, the server checks if the cache is current
+     * using the Query's CacheValidationSQL. If current, returns status='current' with no data.
+     * If stale, returns status='stale' with fresh data.
+     *
+     * @param params - Array of RunQuery requests with optional cache status
+     * @param contextUser - Optional user context
+     * @returns Response containing results for each query in the batch
+     */
+    RunQueriesWithCacheCheck<T = unknown>(params: RunQueryWithCacheCheckParams[], contextUser?: UserInfo): Promise<RunQueriesWithCacheCheckResponse<T>>;
     /**************************************************************************/
     /**************************************************************************/
     /**************************************************************************/
     /**************************************************************************/
-    RunView<T = any>(params: RunViewParams, contextUser?: UserInfo): Promise<RunViewResult<T>>;
-    RunViews<T = any>(params: RunViewParams[], contextUser?: UserInfo): Promise<RunViewResult<T>[]>;
+    protected InternalRunView<T = any>(params: RunViewParams, contextUser?: UserInfo): Promise<RunViewResult<T>>;
+    protected InternalRunViews<T = any>(params: RunViewParams[], contextUser?: UserInfo): Promise<RunViewResult<T>[]>;
+    /**
+     * RunViewsWithCacheCheck - Smart cache validation for batch RunViews.
+     * For each view, if cacheStatus is provided, the server checks if the cache is current.
+     * If current, returns status='current' with no data. If stale, returns status='stale' with fresh data.
+     *
+     * @param params - Array of RunView requests with optional cache status
+     * @param contextUser - Optional user context
+     * @returns Response containing results for each view in the batch
+     */
+    RunViewsWithCacheCheck<T = unknown>(params: RunViewWithCacheCheckParams[], contextUser?: UserInfo): Promise<RunViewsWithCacheCheckResponse<T>>;
     protected getEntityNameAndUserView(params: RunViewParams, contextUser?: UserInfo): Promise<{
         entityName: string;
         v: UserViewEntityExtended;
@@ -2146,6 +2229,7 @@ interface RunTestParams {
     testId: string;
     verbose?: boolean;
     environment?: string;
+    tags?: string[];
     onProgress?: (progress: TestExecutionProgress) => void;
 }
 /**
@@ -2165,6 +2249,22 @@ interface RunTestSuiteParams {
     verbose?: boolean;
     environment?: string;
     parallel?: boolean;
+    tags?: string[];
+    /**
+     * Run only specific tests by their IDs.
+     * If provided, only tests with matching IDs will be executed.
+     */
+    selectedTestIds?: string[];
+    /**
+     * Start execution from this sequence number (inclusive).
+     * Tests with sequence numbers less than this value will be skipped.
+     */
+    sequenceStart?: number;
+    /**
+     * Stop execution at this sequence number (inclusive).
+     * Tests with sequence numbers greater than this value will be skipped.
+     */
+    sequenceEnd?: number;
     onProgress?: (progress: TestExecutionProgress) => void;
 }
 /**
@@ -2700,4 +2800,80 @@ declare class GraphQLComponentRegistryClient {
     SendComponentFeedback(params: ComponentFeedbackParams): Promise<ComponentFeedbackResponse>;
 }
 
-export { ActionItemInput, ActionItemOutput, type ComponentDependencyTree, type ComponentSpecWithHash, type CreateQueryInput, type CreateQueryResult, type DeleteQueryOptionsInput, type DeleteQueryResult, type EmbedTextParams, type EmbedTextResult, type ExecuteSimplePromptParams, FieldMapper, GetDataOutput, type GetQueryDataByNameSystemUserInput, type GetQueryDataSystemUserInput, type GetRegistryComponentParams, GraphQLAIClient, GraphQLActionClient, GraphQLComponentRegistryClient, GraphQLDataProvider, GraphQLProviderConfigData, GraphQLSystemUserClient, GraphQLTestingClient, GraphQLTransactionGroup, type QueryEntity, type QueryField, type QueryParameter, type QueryPermission, type QueryPermissionInput, type RegistryComponentSearchResult, RoleInput, RolesAndUsersInput, type RunAIPromptParams, type RunAIPromptResult, type RunDynamicViewSystemUserInput, type RunQuerySystemUserResult, type RunTestParams, type RunTestResult, type RunTestSuiteParams, type RunTestSuiteResult, type RunViewByIDSystemUserInput, type RunViewByNameSystemUserInput, type RunViewSystemUserInput, type RunViewSystemUserResult, type RunViewSystemUserResultRow, type SearchRegistryComponentsParams, type SimplePromptResult, SimpleRemoteEntity, SimpleRemoteEntityField, SimpleRemoteEntityOutput, SyncDataAction, SyncDataResult, SyncRolesAndUsersResult, type TestExecutionProgress, type UpdateQueryInput, type UpdateQueryResult, UserInput, setupGraphQLClient };
+/**
+ * In-memory storage provider using nested Map structure for category isolation.
+ * Used as a fallback when browser storage is not available.
+ *
+ * Storage structure: Map<category, Map<key, value>>
+ */
+declare class BrowserStorageProviderBase implements ILocalStorageProvider {
+    private _storage;
+    /**
+     * Gets or creates a category map
+     */
+    private getCategoryMap;
+    GetItem(key: string, category?: string): Promise<string | null>;
+    SetItem(key: string, value: string, category?: string): Promise<void>;
+    Remove(key: string, category?: string): Promise<void>;
+    ClearCategory(category: string): Promise<void>;
+    GetCategoryKeys(category: string): Promise<string[]>;
+}
+/**
+ * IndexedDB schema with dynamic object stores per category.
+ * Each category gets its own object store: mj:CategoryName
+ */
+interface MJ_MetadataDB extends DBSchema {
+    'mj:default': {
+        key: string;
+        value: string;
+    };
+    'mj:Metadata': {
+        key: string;
+        value: string;
+    };
+    'mj:RunViewCache': {
+        key: string;
+        value: string;
+    };
+    'mj:RunQueryCache': {
+        key: string;
+        value: string;
+    };
+    'mj:DatasetCache': {
+        key: string;
+        value: string;
+    };
+}
+/**
+ * IndexedDB storage provider with category support via separate object stores.
+ *
+ * Known categories (mj:Metadata, mj:RunViewCache, etc.) get dedicated object stores.
+ * Unknown categories fall back to the default store with prefixed keys.
+ */
+declare class BrowserIndexedDBStorageProvider extends BrowserStorageProviderBase {
+    private dbPromise;
+    private _dbReady;
+    constructor();
+    /**
+     * Checks if a category has a dedicated object store
+     */
+    private isKnownCategory;
+    /**
+     * Gets the object store name for a category.
+     * Returns the dedicated store if it exists, otherwise returns the default store.
+     */
+    private getStoreName;
+    /**
+     * Gets the key to use in the store.
+     * For known stores, use the key as-is.
+     * For unknown categories using the default store, prefix with category.
+     */
+    private getStoreKey;
+    SetItem(key: string, value: string, category?: string): Promise<void>;
+    GetItem(key: string, category?: string): Promise<string | null>;
+    Remove(key: string, category?: string): Promise<void>;
+    ClearCategory(category: string): Promise<void>;
+    GetCategoryKeys(category: string): Promise<string[]>;
+}
+
+export { ActionItemInput, ActionItemOutput, BrowserIndexedDBStorageProvider, BrowserStorageProviderBase, type ComponentDependencyTree, type ComponentSpecWithHash, type CreateQueryInput, type CreateQueryResult, type DeleteQueryOptionsInput, type DeleteQueryResult, type EmbedTextParams, type EmbedTextResult, type ExecuteSimplePromptParams, FieldMapper, GetDataOutput, type GetQueryDataByNameSystemUserInput, type GetQueryDataSystemUserInput, type GetRegistryComponentParams, GraphQLAIClient, GraphQLActionClient, GraphQLComponentRegistryClient, GraphQLDataProvider, GraphQLProviderConfigData, GraphQLSystemUserClient, GraphQLTestingClient, GraphQLTransactionGroup, type MJ_MetadataDB, type QueryEntity, type QueryField, type QueryParameter, type QueryPermission, type QueryPermissionInput, type RegistryComponentSearchResult, RoleInput, RolesAndUsersInput, type RunAIPromptParams, type RunAIPromptResult, type RunDynamicViewSystemUserInput, type RunQuerySystemUserResult, type RunTestParams, type RunTestResult, type RunTestSuiteParams, type RunTestSuiteResult, type RunViewByIDSystemUserInput, type RunViewByNameSystemUserInput, type RunViewSystemUserInput, type RunViewSystemUserResult, type RunViewSystemUserResultRow, type SearchRegistryComponentsParams, type SimplePromptResult, SimpleRemoteEntity, SimpleRemoteEntityField, SimpleRemoteEntityOutput, SyncDataAction, SyncDataResult, SyncRolesAndUsersResult, type TestExecutionProgress, type UpdateQueryInput, type UpdateQueryResult, UserInput, setupGraphQLClient };