@memberjunction/global 2.112.0 → 2.113.0

package/dist/generic/providerBase.d.ts

@@ -1,546 +0,0 @@
-import { BaseEntity } from './baseEntity';
-import { EntityDependency, EntityDocumentTypeInfo, EntityInfo, RecordDependency, RecordMergeRequest, RecordMergeResult } from './entityInfo';
-import { IMetadataProvider, ProviderConfigDataBase, MetadataInfo, ILocalStorageProvider, DatasetResultType, DatasetStatusResultType, DatasetItemFilterType, EntityRecordNameInput, EntityRecordNameResult, ProviderType, PotentialDuplicateRequest, PotentialDuplicateResponse, EntityMergeOptions, AllMetadata, IRunViewProvider, RunViewResult } from './interfaces';
-import { ApplicationInfo } from '../generic/applicationInfo';
-import { AuditLogTypeInfo, AuthorizationInfo, RoleInfo, RowLevelSecurityFilterInfo, UserInfo } from './securityInfo';
-import { TransactionGroupBase } from './transactionGroup';
-import { QueryCategoryInfo, QueryFieldInfo, QueryInfo, QueryPermissionInfo, QueryEntityInfo, QueryParameterInfo } from './queryInfo';
-import { LibraryInfo } from './libraryInfo';
-import { CompositeKey } from './compositeKey';
-import { ExplorerNavigationItem } from './explorerNavigationItem';
-import { RunViewParams } from '../views/runView';
-/**
- * Creates a new instance of AllMetadata from a simple object.
- * Handles deserialization and proper instantiation of all metadata classes.
- * @param data - The raw metadata object to convert
- * @param md - The metadata provider for context
- * @returns A fully populated AllMetadata instance with proper type instances
- */
-export declare function MetadataFromSimpleObject(data: any, md: IMetadataProvider): AllMetadata;
-/**
- * Creates a new instance of AllMetadata from a simple object, but does NOT set the CurrentUser property
- * Handles deserialization and proper instantiation of all metadata classes.
- * @param data - The raw metadata object to convert
- * @param md - The metadata provider for context
- * @returns A fully populated AllMetadata instance with proper type instances
- */
-export declare function MetadataFromSimpleObjectWithoutUser(data: any, md: IMetadataProvider): AllMetadata;
-/**
- * This is a list of all metadata classes that are used in the AllMetadata class.
- * Used to automatically determine the class type when deserializing the metadata and
- * for iterating through all metadata collections.
- * Each entry maps a property key to its corresponding class constructor.
- */
-export declare const AllMetadataArrays: ({
-    key: string;
-    class: typeof ApplicationInfo;
-} | {
-    key: string;
-    class: typeof AuthorizationInfo;
-} | {
-    key: string;
-    class: typeof QueryFieldInfo;
-} | {
-    key: string;
-    class: typeof QueryPermissionInfo;
-} | {
-    key: string;
-    class: typeof QueryEntityInfo;
-} | {
-    key: string;
-    class: typeof QueryParameterInfo;
-} | {
-    key: string;
-    class: typeof EntityDocumentTypeInfo;
-})[];
-/**
- * Base class for all metadata providers in MemberJunction.
- * Implements common functionality for metadata caching, refresh, and dataset management.
- * Subclasses must implement abstract methods for provider-specific operations.
- */
-export declare abstract class ProviderBase implements IMetadataProvider, IRunViewProvider {
-    private _ConfigData;
-    private _latestLocalMetadataTimestamps;
-    private _latestRemoteMetadataTimestamps;
-    private _localMetadata;
-    private _refresh;
-    /******** ABSTRACT SECTION ****************************************************************** */
-    /**
-     * Determines if a refresh is currently allowed or not.
-     * Subclasses should return FALSE if they are performing operations that should prevent refreshes.
-     * This helps avoid metadata refreshes during critical operations.
-     */
-    protected abstract get AllowRefresh(): boolean;
-    /**
-     * Returns the provider type for the instance.
-     * Identifies whether this is a Database or Network provider.
-     */
-    abstract get ProviderType(): ProviderType;
-    /**
-     * For providers that have ProviderType==='Database', this property will return an object that represents the underlying database connection.
-     * For providers where ProviderType==='Network' this property will throw an exception.
-     * The type of object returned is provider-specific (e.g., SQL connection pool).
-     */
-    abstract get DatabaseConnection(): any;
-    /**
-     * Gets the display name for a single entity record.
-     * Uses the entity's IsNameField or falls back to 'Name' field if available.
-     * @param entityName - The name of the entity
-     * @param compositeKey - The primary key value(s) for the record
-     * @param contextUser - Optional user context for permissions
-     * @returns The display name of the record or null if not found
-     */
-    abstract GetEntityRecordName(entityName: string, compositeKey: CompositeKey, contextUser?: UserInfo): Promise<string>;
-    /**
-     * Gets display names for multiple entity records in a single operation.
-     * More efficient than multiple GetEntityRecordName calls.
-     * @param info - Array of entity/key pairs to lookup
-     * @param contextUser - Optional user context for permissions
-     * @returns Array of results with names and status for each requested record
-     */
-    abstract GetEntityRecordNames(info: EntityRecordNameInput[], contextUser?: UserInfo): Promise<EntityRecordNameResult[]>;
-    /**
-     * Checks if a specific record is marked as a favorite by the user.
-     * @param userId - The ID of the user to check
-     * @param entityName - The name of the entity
-     * @param CompositeKey - The primary key value(s) for the record
-     * @param contextUser - Optional user context for permissions
-     * @returns True if the record is a favorite, false otherwise
-     */
-    abstract GetRecordFavoriteStatus(userId: string, entityName: string, CompositeKey: CompositeKey, contextUser?: UserInfo): Promise<boolean>;
-    /**
-     * Sets or removes a record's favorite status for a user.
-     * @param userId - The ID of the user
-     * @param entityName - The name of the entity
-     * @param CompositeKey - The primary key value(s) for the record
-     * @param isFavorite - True to mark as favorite, false to remove
-     * @param contextUser - User context for permissions (required)
-     */
-    abstract SetRecordFavoriteStatus(userId: string, entityName: string, CompositeKey: CompositeKey, isFavorite: boolean, contextUser: UserInfo): Promise<void>;
-    /******** END - ABSTRACT SECTION ****************************************************************** */
-    /**
-     * Force sub-classes to implement RunView, base class doesn't provide an implementation
-     * @param params
-     * @param contextUser
-     */
-    abstract RunView<T = any>(params: RunViewParams, contextUser?: UserInfo): Promise<RunViewResult<T>>;
-    /**
-     * Force sub-classes to implement RunViews, base class doesn't provide an implementation
-     * @param params
-     * @param contextUser
-     */
-    abstract RunViews<T = any>(params: RunViewParams[], contextUser?: UserInfo): Promise<RunViewResult<T>[]>;
-    /**
-     * Used to check to see if the entity in question is active or not
-     * If it is not active, it will throw an exception or log a warning depending on the status of the entity being
-     * either Deprecated or Disabled.
-     * @param entityName
-     * @param callerName
-     */
-    protected EntityStatusCheck(params: RunViewParams, callerName: string): Promise<void>;
-    /**
-     * Base class pre-processor that all sub-classes should call before they start their RunView process
-     * @param params
-     * @param contextUser
-     */
-    protected PreProcessRunView<T = any>(params: RunViewParams, contextUser?: UserInfo): Promise<void>;
-    /**
-     * Base class post-processor that all sub-classes should call after they finish their RunView process
-     * @param params
-     * @param contextUser
-     * @returns
-     */
-    protected PostProcessRunView(result: RunViewResult, params: RunViewParams, contextUser?: UserInfo): Promise<void>;
-    /**
-     * Base class implementation for handling pre-processing of RunViews() each sub-class should call this
-     * within their RunViews() method implementation
-     * @param params
-     * @param contextUser
-     * @returns
-     */
-    protected PreProcessRunViews(params: RunViewParams[], contextUser?: UserInfo): Promise<void>;
-    /**
-     * Base class utilty method that should be called after each sub-class handles its internal RunViews() process before returning results
-     * This handles the optional conversion of simple objects to entity objects for each requested view depending on if the params requests
-     * a result_type === 'entity_object'
-     * @param results
-     * @param params
-     * @param contextUser
-     */
-    protected PostProcessRunViews(results: RunViewResult[], params: RunViewParams[], contextUser?: UserInfo): Promise<void>;
-    /**
-     * Transforms the result set from simple objects to entity objects if needed.
-     * @param param - The RunViewParams used for the request
-     * @param result - The RunViewResult returned from the request
-     * @param contextUser - The user context for permissions
-     */
-    protected TransformSimpleObjectToEntityObject(param: RunViewParams, result: RunViewResult, contextUser?: UserInfo): Promise<void>;
-    /**
-     * Returns the currently loaded local metadata from within the instance
-     */
-    get AllMetadata(): AllMetadata;
-    /**
-     * Configures the provider with the specified configuration data.
-     * Handles metadata refresh if needed and initializes the provider.
-     * @param data - Configuration including schema filters and connection info
-     * @returns True if configuration was successful
-     */
-    Config(data: ProviderConfigDataBase, providerToUse?: IMetadataProvider): Promise<boolean>;
-    protected CloneAllMetadata(toClone: AllMetadata): AllMetadata;
-    /**
-     * Copies metadata from the global provider to the local instance.
-     * This is used to ensure that the local instance has the latest metadata
-     * information available without having to reload it from the server.
-     */
-    protected CopyMetadataFromGlobalProvider(): boolean;
-    /**
-     * Builds dataset filters based on the provider configuration.
-     * Ensures MJ Core schema is always included and never excluded.
-     * @returns Array of filters to apply when loading metadata
-     */
-    protected BuildDatasetFilterFromConfig(): DatasetItemFilterType[];
-    protected static _mjMetadataDatasetName: string;
-    /**
-     * Retrieves all metadata from the server and constructs typed instances.
-     * Uses the MJ_Metadata dataset for efficient bulk loading.
-     * @returns Complete metadata collection with all relationships
-     */
-    protected GetAllMetadata(providerToUse?: IMetadataProvider): Promise<AllMetadata>;
-    /**
-     * Gets the current user information from the provider.
-     * Must be implemented by subclasses to return user-specific data.
-     * @returns Current user information including roles and permissions
-     */
-    protected abstract GetCurrentUser(): Promise<UserInfo>;
-    /**
-     * Post-processes entity metadata to establish relationships between entities and their child objects.
-     * Links fields, permissions, relationships, and settings to their parent entities.
-     * @param entities - Array of entity metadata
-     * @param fields - Array of entity field metadata
-     * @param fieldValues - Array of entity field value metadata
-     * @param permissions - Array of entity permission metadata
-     * @param relationships - Array of entity relationship metadata
-     * @param settings - Array of entity settings metadata
-     * @returns Processed array of EntityInfo instances with all relationships established
-     */
-    protected PostProcessEntityMetadata(entities: any[], fields: any[], fieldValues: any[], permissions: any[], relationships: any[], settings: any[]): any[];
-    /**
-     * Gets the configuration data that was provided to the provider.
-     * @returns The provider configuration including schema filters
-     */
-    get ConfigData(): ProviderConfigDataBase;
-    /**
-     * Gets all entity metadata in the system.
-     * @returns Array of EntityInfo objects representing all entities
-     */
-    get Entities(): EntityInfo[];
-    /**
-     * Gets all application metadata in the system.
-     * @returns Array of ApplicationInfo objects representing all applications
-     */
-    get Applications(): ApplicationInfo[];
-    /**
-     * Gets the current user's information including roles and permissions.
-     * @returns UserInfo object for the authenticated user
-     */
-    get CurrentUser(): UserInfo;
-    /**
-     * Gets all security roles defined in the system.
-     * @returns Array of RoleInfo objects representing all roles
-     */
-    get Roles(): RoleInfo[];
-    /**
-     * Gets all row-level security filters defined in the system.
-     * @returns Array of RowLevelSecurityFilterInfo objects for data access control
-     */
-    get RowLevelSecurityFilters(): RowLevelSecurityFilterInfo[];
-    /**
-     * Gets all audit log types defined for tracking system activities.
-     * @returns Array of AuditLogTypeInfo objects
-     */
-    get AuditLogTypes(): AuditLogTypeInfo[];
-    /**
-     * Gets all authorization definitions in the system.
-     * @returns Array of AuthorizationInfo objects defining permissions
-     */
-    get Authorizations(): AuthorizationInfo[];
-    /**
-     * Gets all saved queries in the system.
-     * @returns Array of QueryInfo objects representing stored queries
-     */
-    get Queries(): QueryInfo[];
-    /**
-     * Gets all query category definitions.
-     * @returns Array of QueryCategoryInfo objects for query organization
-     */
-    get QueryCategories(): QueryCategoryInfo[];
-    /**
-     * Gets all query field definitions.
-     * @returns Array of QueryFieldInfo objects defining query result columns
-     */
-    get QueryFields(): QueryFieldInfo[];
-    /**
-     * Gets all query permission assignments.
-     * @returns Array of QueryPermissionInfo objects defining query access
-     */
-    get QueryPermissions(): QueryPermissionInfo[];
-    /**
-     * Gets all query entity associations.
-     * @returns Array of QueryEntityInfo objects linking queries to entities
-     */
-    get QueryEntities(): QueryEntityInfo[];
-    /**
-     * Gets all query parameter definitions.
-     * @returns Array of QueryParameterInfo objects for parameterized queries
-     */
-    get QueryParameters(): QueryParameterInfo[];
-    /**
-     * Gets all library definitions in the system.
-     * @returns Array of LibraryInfo objects representing code libraries
-     */
-    get Libraries(): LibraryInfo[];
-    /**
-     * Gets all explorer navigation items including inactive ones.
-     * @returns Array of all ExplorerNavigationItem objects
-     */
-    get AllExplorerNavigationItems(): ExplorerNavigationItem[];
-    private _cachedVisibleExplorerNavigationItems;
-    /**
-     * Gets only active explorer navigation items sorted by sequence.
-     * Results are cached for performance.
-     * @returns Array of active ExplorerNavigationItem objects
-     */
-    get VisibleExplorerNavigationItems(): ExplorerNavigationItem[];
-    /**
-     * Refreshes all metadata from the server.
-     * Respects the AllowRefresh flag from subclasses.
-     * @returns True if refresh was initiated or allowed
-     */
-    Refresh(providerToUse?: IMetadataProvider): Promise<boolean>;
-    /**
-     * Checks if local metadata is out of date and needs refreshing.
-     * Compares local timestamps with server timestamps.
-     * @returns True if refresh is needed, false otherwise
-     */
-    CheckToSeeIfRefreshNeeded(providerToUse?: IMetadataProvider): Promise<boolean>;
-    /**
-     * Refreshes metadata only if needed based on timestamp comparison.
-     * Combines check and refresh into a single operation.
-     * @returns True if refresh was successful or not needed
-     */
-    RefreshIfNeeded(providerToUse?: IMetadataProvider): Promise<boolean>;
-    /**
-     * Creates a new instance of a BaseEntity subclass for the specified entity and automatically calls NewRecord() to initialize it.
-     * This method serves as the core implementation for entity instantiation in the MemberJunction framework.
-     *
-     * @param entityName - The name of the entity to create (must exist in metadata)
-     * @param contextUser - Optional user context for permissions and audit tracking
-     * @returns Promise resolving to the newly created entity instance with NewRecord() called
-     * @throws Error if entity name is not found in metadata or if instantiation fails
-     */
-    GetEntityObject<T extends BaseEntity>(entityName: string, contextUser?: UserInfo): Promise<T>;
-    /**
-     * Creates a new instance of a BaseEntity subclass and loads an existing record using the provided key.
-     * This overload provides a convenient way to instantiate and load in a single operation.
-     *
-     * @param entityName - The name of the entity to create (must exist in metadata)
-     * @param loadKey - CompositeKey containing the primary key value(s) for the record to load
-     * @param contextUser - Optional user context for permissions and audit tracking
-     * @returns Promise resolving to the entity instance with the specified record loaded
-     * @throws Error if entity name is not found, instantiation fails, or record cannot be loaded
-     */
-    GetEntityObject<T extends BaseEntity>(entityName: string, loadKey: CompositeKey, contextUser?: UserInfo): Promise<T>;
-    /**
-     * Returns a list of dependencies - records that are linked to the specified Entity/RecordID combination. A dependency is as defined by the relationships in the database. The MemberJunction metadata that is used
-     * for this simply reflects the foreign key relationships that exist in the database. The CodeGen tool is what detects all of the relationships and generates the metadata that is used by MemberJunction. The metadata in question
-     * is within the EntityField table and specifically the RelatedEntity and RelatedEntityField columns. In turn, this method uses that metadata and queries the database to determine the dependencies. To get the list of entity dependencies
-     * you can use the utility method GetEntityDependencies(), which doesn't check for dependencies on a specific record, but rather gets the metadata in one shot that can be used for dependency checking.
-     * @param entityName the name of the entity to check
-     * @param KeyValuePairs the values of the primary key of the record to check
-     */
-    abstract GetRecordDependencies(entityName: string, CompositeKey: CompositeKey, contextUser?: UserInfo): Promise<RecordDependency[]>;
-    /**
-     * Returns a list of record IDs that are possible duplicates of the specified record.
-     *
-     * @param params object containing many properties used in fetching records and determining which ones to return
-     */
-    abstract GetRecordDuplicates(params: PotentialDuplicateRequest, contextUser?: UserInfo): Promise<PotentialDuplicateResponse>;
-    /**
-     * Returns a list of entity dependencies, basically metadata that tells you the links to this entity from all other entities.
-     * @param entityName
-     * @returns
-     */
-    GetEntityDependencies(entityName: string): Promise<EntityDependency[]>;
-    /**
-     * This method will merge two or more records based on the request provided. The RecordMergeRequest type you pass in specifies the record that will survive the merge, the records to merge into the surviving record, and an optional field map that can update values in the surviving record, if desired. The process followed is:
-     * 1. A transaction is started
-     * 2. The surviving record is loaded and fields are updated from the field map, if provided, and the record is saved. If a FieldMap not provided within the request object, this step is skipped.
-     * 3. For each of the records that will be merged INTO the surviving record, we call the GetEntityDependencies() method and get a list of all other records in the database are linked to the record to be deleted. We then go through each of those dependencies and update the link to point to the SurvivingRecordID and save the record.
-     * 4. The record to be deleted is then deleted.
-     * 5. The transaction is committed if all of the above steps are succesful, otherwise it is rolled back.
-     *
-     * The return value from this method contains detailed information about the execution of the process. In addition, all attempted merges are logged in the RecordMergeLog and RecordMergeDeletionLog tables.
-     *
-     * @param request
-     * @returns
-     */
-    abstract MergeRecords(request: RecordMergeRequest, contextUser?: UserInfo, options?: EntityMergeOptions): Promise<RecordMergeResult>;
-    /**
-     * Always retrieves data from the server - this method does NOT check cache. To use cached local values if available, call GetAndCacheDatasetByName() instead
-     * @param datasetName
-     * @param itemFilters
-     */
-    abstract GetDatasetByName(datasetName: string, itemFilters?: DatasetItemFilterType[], contextUser?: UserInfo, providerToUse?: IMetadataProvider): Promise<DatasetResultType>;
-    /**
-     * Retrieves the date status information for a dataset and all its items from the server. This method will match the datasetName and itemFilters to the server's dataset and item filters to determine a match
-     * @param datasetName
-     * @param itemFilters
-     */
-    abstract GetDatasetStatusByName(datasetName: string, itemFilters?: DatasetItemFilterType[], contextUser?: UserInfo, providerToUse?: IMetadataProvider): Promise<DatasetStatusResultType>;
-    /**
-     * Gets a database by name, if required, and caches it in a format available to the client (e.g. IndexedDB, LocalStorage, File, etc). The cache method is Provider specific
-     * If itemFilters are provided, the combination of datasetName and the filters are used to determine a match in the cache
-     * @param datasetName
-     * @param itemFilters
-     */
-    GetAndCacheDatasetByName(datasetName: string, itemFilters?: DatasetItemFilterType[], contextUser?: UserInfo, providerToUse?: IMetadataProvider): Promise<DatasetResultType>;
-    /**
-     * Returns the timestamp of the local cached version of a given datasetName or null if there is no local cache for the
-     * specified dataset
-     * @param datasetName the name of the dataset to check
-     * @param itemFilters optional filters to apply to the dataset
-     */
-    GetLocalDatasetTimestamp(datasetName: string, itemFilters?: DatasetItemFilterType[]): Promise<Date>;
-    /**
-     * This routine checks to see if the local cache version of a given datasetName/itemFilters combination is up to date with the server or not
-     * @param datasetName
-     * @param itemFilters
-     * @returns
-     */
-    IsDatasetCacheUpToDate(datasetName: string, itemFilters?: DatasetItemFilterType[]): Promise<boolean>;
-    /**
-     * This routine gets the local cached version of a given datasetName/itemFilters combination, it does NOT check the server status first and does not fall back on the server if there isn't a local cache version of this dataset/itemFilters combination
-     * @param datasetName
-     * @param itemFilters
-     * @returns
-     */
-    GetCachedDataset(datasetName: string, itemFilters?: DatasetItemFilterType[]): Promise<DatasetResultType>;
-    /**
-     * Stores a dataset in the local cache. If itemFilters are provided, the combination of datasetName and the filters are used to build a key and determine a match in the cache
-     * @param datasetName
-     * @param itemFilters
-     * @param dataset
-     */
-    CacheDataset(datasetName: string, itemFilters: DatasetItemFilterType[], dataset: DatasetResultType): Promise<void>;
-    /**
-     * Determines if a given datasetName/itemFilters combination is cached locally or not
-     * @param datasetName
-     * @param itemFilters
-     * @returns
-     */
-    IsDatasetCached(datasetName: string, itemFilters?: DatasetItemFilterType[]): Promise<boolean>;
-    /**
-     * Creates a unique key for the given datasetName and itemFilters combination coupled with the instance connection string to ensure uniqueness when 2+ connections exist
-     * @param datasetName
-     * @param itemFilters
-     * @returns
-     */
-    GetDatasetCacheKey(datasetName: string, itemFilters?: DatasetItemFilterType[]): string;
-    /**
-     * This property is implemented by each sub-class of ProviderBase and is intended to return a unique string that identifies the instance of the provider for the connection it is making.
-     * For example: for network connections, the URL including a TCP port would be a good connection string, whereas on database connections the database host url/instance/port would be a good connection string.
-     * This is used as part of cache keys to ensure different connections don't share cached data.
-     */
-    abstract get InstanceConnectionString(): string;
-    /**
-     * Converts dataset item filters into a unique string key for caching.
-     * @param itemFilters - Array of filters to convert
-     * @returns JSON-formatted string representing the filters
-     */
-    protected ConvertItemFiltersToUniqueKey(itemFilters: DatasetItemFilterType[]): string;
-    /**
-     * If the specified datasetName is cached, this method will clear the cache. If itemFilters are provided, the combination of datasetName and the filters are used to determine a match in the cache
-     * @param datasetName
-     * @param itemFilters
-     */
-    ClearDatasetCache(datasetName: string, itemFilters?: DatasetItemFilterType[]): Promise<void>;
-    /**
-     * Creates a new transaction group for managing database transactions.
-     * Must be implemented by subclasses to provide transaction support.
-     * @returns A new transaction group instance
-     */
-    abstract CreateTransactionGroup(): Promise<TransactionGroupBase>;
-    /**
-     * Gets the latest metadata timestamps from the remote server.
-     * Used to determine if local cache is out of date.
-     * @returns Array of metadata timestamp information
-     */
-    get LatestRemoteMetadata(): MetadataInfo[];
-    /**
-     * Gets the latest metadata timestamps from local cache.
-     * Used for comparison with remote timestamps.
-     * @returns Array of locally cached metadata timestamps
-     */
-    get LatestLocalMetadata(): MetadataInfo[];
-    /**
-     * Retrieves the latest metadata update timestamps from the server.
-     * @returns Array of metadata update information
-     */
-    protected GetLatestMetadataUpdates(providerToUse?: IMetadataProvider): Promise<MetadataInfo[]>;
-    /**
-     * Refreshes the remote metadata timestamps from the server.
-     * Updates the internal cache of remote timestamps.
-     * @returns True if timestamps were successfully refreshed
-     */
-    RefreshRemoteMetadataTimestamps(providerToUse?: IMetadataProvider): Promise<boolean>;
-    /**
-     * Checks if local metadata is obsolete compared to remote metadata.
-     * Compares timestamps and row counts to detect changes.
-     * @param type - Optional specific metadata type to check
-     * @returns True if local metadata is out of date
-     */
-    LocalMetadataObsolete(type?: string): boolean;
-    /**
-     * Updates the local metadata cache with new data.
-     * @param res - The new metadata to store locally
-     */
-    protected UpdateLocalMetadata(res: AllMetadata): void;
-    /**
-     * Gets the local storage provider implementation.
-     * Must be implemented by subclasses to provide environment-specific storage.
-     * @returns Local storage provider instance
-     */
-    abstract get LocalStorageProvider(): ILocalStorageProvider;
-    /**
-     * Loads metadata from local storage if available.
-     * Deserializes and reconstructs typed metadata objects.
-     */
-    protected LoadLocalMetadataFromStorage(): Promise<void>;
-    private static localStorageRootKey;
-    private static localStorageTimestampsKey;
-    private static localStorageAllMetadataKey;
-    private static localStorageKeys;
-    /**
-     * This property will return the prefix to use for local storage keys. This is useful if you have multiple instances of a provider running in the same environment
-     * and you want to keep their local storage keys separate. The default implementation returns an empty string, but subclasses can override this to return a unique string
-     * based on the connection or other distinct identifier.
-     */
-    protected get LocalStoragePrefix(): string;
-    /**
-     * Saves current metadata to local storage for caching.
-     * Serializes both timestamps and full metadata collections.
-     */
-    SaveLocalMetadataToStorage(): Promise<void>;
-    /**
-     * Removes all cached metadata from local storage.
-     * Clears both timestamps and metadata collections.
-     */
-    RemoveLocalMetadataFromStorage(): Promise<void>;
-    /**
-     * Gets the metadata provider instance.
-     * Must be implemented by subclasses to provide access to metadata.
-     * @returns The metadata provider instance
-     */
-    protected abstract get Metadata(): IMetadataProvider;
-}
-//# sourceMappingURL=providerBase.d.ts.map

package/dist/generic/providerBase.d.ts.map

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