pict-section-recordset 1.0.43 → 1.0.45

package/example_applications/simple_entity/Simple-RecordSet-Application.js

@@ -1,7 +1,165 @@
 const libPictRecordSet = require('../../source/Pict-Section-RecordSet.js');
 
+const BaseFilterView = require('../../source/views/filters/RecordSet-Filter-ExternalJoinSelectedValueList.js');
+
+const CustomViewConfig =
+{
+	ViewIdentifier: 'PRSP-FilterType-ExternalJoinSelectedValueList-MyCoolView',
+
+	Templates:
+	[
+		{
+			Hash: 'PRSP-Filter-ExternalJoin-SelectedValueList-Template-Custom',
+			Template: /*html*/`
+	<!-- DefaultPackage pict view template: [PRSP-Filter-ExternalJoin-SelectedValueList-Template] -->
+	<table>
+		<tbody>
+		<td valign="top">{~T:PRSP-Filter-ExternalJoin-SelectedValueList-SearchResults-Custom~}</td>
+		<td>
+			<button onclick="_Pict.views['{~D:Context[0].Hash~}'].handleAdd(event, '{~D:Record.ClauseAddress~}', '{~D:Record.Hash~}')">--&gt;</button>
+			<button onclick="_Pict.views['{~D:Context[0].Hash~}'].handleRemove(event, '{~D:Record.ClauseAddress~}', '{~D:Record.Hash~}')">&lt;--</button>
+		</td>
+		<td valign="top">{~T:PRSP-Filter-ExternalJoin-SelectedValueList-SelectedValues-Custom~}</td>
+		</tbody>
+	</table>
+	<!-- DefaultPackage end view template:	[PRSP-Filter-ExternalJoin-SelectedValueList-Template] -->
+`
+		},
+		{
+			Hash: 'PRSP-Filter-ExternalJoin-SelectedValueList-SearchResults-Custom',
+			Template: /*html*/`
+	<!-- DefaultPackage pict view template: [PRSP-Filter-ExternalJoin-SearchResults] -->
+	<form id="PRSP_Filter_{~D:Record.Hash~}_Search_Form" onsubmit="_Pict.views['{~D:Context[0].Hash~}'].performSearch(event, '{~D:Record.ClauseAddress~}', '{~D:Record.Hash~}'); return false;">
+		<input id="PRSP_Filter_{~D:Record.Hash~}_Search_Value" type="text" placeholder="Search..." value="{~D:Record.SearchInputValue~}" />
+		<button type="submit" id="PRSP_Filter_{~D:Record.Hash~}_Button_Search" onclick="_Pict.views['{~D:Context[0].Hash~}'].performSearch(event, '{~D:Record.ClauseAddress~}', '{~D:Record.Hash~}')">Search</button>
+	</form>
+	<label>{~D:Record.Label~}</label>
+	<select id="PRSP_Filter_{~D:Record.Hash~}_ResultsList" size="25">
+		{~TSWP:PRSP-Filter-ExternalJoin-SelectedValueList-SearchResults-Entry-Custom:Record.SearchResults:Record~}
+	</select>
+	<!-- DefaultPackage end view template:	[PRSP-Filter-ExternalJoin-SearchResults] -->
+`
+		},
+		{
+			Hash: 'PRSP-Filter-ExternalJoin-SelectedValueList-SelectedValues-Custom',
+			Template: /*html*/`
+	<!-- DefaultPackage view template:	[PRSP-Filter-ExternalJoin-SelectedValueList-SelectedValues] -->
+	<label>Selection</label>
+	<select id="PRSP_Filter_{~D:Record.Hash~}_SelectedValuesSelect" size="25">
+		{~TSWP:PRSP-Filter-ExternalJoin-SelectedValueList-SelectedValues-Entry-Custom:Record.SelectedValues:Record~}
+	</select>
+	<!-- DefaultPackage end view template:	[PRSP-Filter-ExternalJoin-SelectedValueList-SelectedValues] -->
+`
+		},
+		{
+			Hash: 'PRSP-Filter-ExternalJoin-SelectedValueList-SearchResults-Entry-Custom',
+			Template: /*html*/`
+	<!-- DefaultPackage pict view template: [PRSP-Filter-ExternalJoin-SelectedValueList-Template] -->
+	<option value="{~DVBK:Record.Data:Record.Payload.ExternalFilterTableLookupColumn~}">{~TFA:Record.Payload.ExternalRecordDisplayTemplate:Record~}</option>
+	<!-- DefaultPackage end view template:	[PRSP-Filter-ExternalJoin-SelectedValueList-Template] -->
+`
+		},
+		{
+			Hash: 'PRSP-Filter-ExternalJoin-SelectedValueList-SelectedValues-Entry-Custom',
+			Template: /*html*/`
+	<!-- DefaultPackage pict view template: [PRSP-Filter-ExternalJoin-SelectedValueList-SelectedValues-Entry] -->
+	<option value="{~DVBK:Record.Data:Record.Payload.ExternalFilterTableLookupColumn~}">{~TFA:Record.Payload.ExternalRecordDisplayTemplate:Record~}</option>
+	<!-- DefaultPackage end view template:	[PRSP-Filter-ExternalJoin-SelectedValueList-SelectedValues-Entry] -->
+`
+		}
+	],
+};
+
+class CustomFilterView extends BaseFilterView
+{
+	getFilterFormTemplate()
+	{
+		return 'PRSP-Filter-ExternalJoin-SelectedValueList-Template-Custom';
+	}
+
+	handleAdd(pEvent, pClauseInformaryAddress, pClauseHash)
+	{
+		pEvent.preventDefault();
+		const tmpClause = this.getInformaryScopedValue(pClauseInformaryAddress);
+		if (!tmpClause)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValueList]  No clause found for address: ${pClauseInformaryAddress}`);
+			return;
+		}
+		const tmpRecordLookupValue = this.pict.ContentAssignment.readContent(`#PRSP_Filter_${tmpClause.Hash}_ResultsList`);
+		const tmpRecordLookupColumn = tmpClause.ExternalFilterTableLookupColumn || `ID${tmpClause.ExternalFilterByTable}`;
+		const tmpRecordToAdd = tmpClause.SearchResults.find((r) => r[tmpRecordLookupColumn] == tmpRecordLookupValue);
+		if (!tmpRecordToAdd)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValueList]  No record found for value: ${tmpRecordLookupValue} in search results.`);
+			return;
+		}
+		if (!tmpClause.SelectedValues)
+		{
+			tmpClause.SelectedValues = [];
+		}
+		if (tmpClause.SelectedValues.some((pSV) => pSV[tmpRecordLookupColumn] == tmpRecordLookupValue))
+		{
+			return;
+		}
+		const tmpValue = tmpRecordToAdd[tmpClause.ExternalFilterByTableConnectionColumn];
+		if (tmpValue == null)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValueList]  No value found for column: ${tmpClause.ExternalFilterByTableConnectionColumn} in record: ${JSON.stringify(tmpRecordToAdd)}`);
+			return;
+		}
+		tmpClause.SelectedValues.push(tmpRecordToAdd);
+		if (!tmpClause.Values)
+		{
+			tmpClause.Values = [];
+		}
+		if (!tmpClause.Values.some((pV) => pV == tmpValue))
+		{
+			tmpClause.Values.push(tmpValue);
+		}
+		const tmpRecord = Object.assign({ ClauseAddress: pClauseInformaryAddress }, tmpClause);
+		this.prepareRecord(tmpRecord);
+		const tmpDestinationAddress = `#PRSP_Filter_Container_${pClauseHash}`;
+		this.render(null, tmpDestinationAddress, tmpRecord);
+	}
+
+	handleRemove(pEvent, pClauseInformaryAddress, pClauseHash)
+	{
+		pEvent.preventDefault();
+		const tmpClause = this.getInformaryScopedValue(pClauseInformaryAddress);
+		if (!tmpClause)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValueList]  No clause found for address: ${pClauseInformaryAddress}`);
+			return;
+		}
+		const tmpRecordLookupValue = this.pict.ContentAssignment.readContent(`#PRSP_Filter_${tmpClause.Hash}_SelectedValuesSelect`);
+		const tmpRecordLookupColumn = tmpClause.ExternalFilterTableLookupColumn || `ID${tmpClause.ExternalFilterByTable}`;
+		const tmpRecordIndexToRemove = tmpClause.SelectedValues.findIndex((r) => r[tmpRecordLookupColumn] == tmpRecordLookupValue);
+		if (tmpRecordIndexToRemove < 0)
+		{
+			this.pict.log.error(`[Filter-ExternalJoinSelectedValueList]  No record found to remove for value: ${tmpRecordLookupValue}`);
+			return;
+		}
+		const tmpRecordToRemove = tmpClause.SelectedValues.splice(tmpRecordIndexToRemove, 1)[0];
+		const tmpValue = tmpRecordToRemove[tmpClause.ExternalFilterByTableConnectionColumn];
+		tmpClause.Values = tmpClause.Values.filter((pV) => pV !== tmpValue);
+		const tmpRecord = Object.assign({ ClauseAddress: pClauseInformaryAddress }, tmpClause);
+		this.prepareRecord(tmpRecord);
+		const tmpDestinationAddress = `#PRSP_Filter_Container_${pClauseHash}`;
+		this.render(null, tmpDestinationAddress, tmpRecord);
+	}
+}
+
+CustomFilterView.default_configuration = Object.assign({}, BaseFilterView.default_configuration, CustomViewConfig);
+
 class SimpleApplication extends libPictRecordSet.PictRecordSetApplication
 {
+	onInitialize()
+	{
+		this.pict.addView('PRSP-FilterType-ExternalJoinSelectedValueList-MyCoolView', {}, CustomFilterView);
+
+		return super.onInitialize();
+	}
 }
 
 module.exports = SimpleApplication;
@@ -182,9 +340,10 @@ module.exports.default_configuration.pict_configuration = (
 		{
 			"ExternalJoinBookByAuthor":
 			{
-				"DisplayName": "Author's Name",
+				"Label": "Author's Name",
 				"Type": "ExternalJoinStringMatch",
 				"ExternalFilterByColumns": [ "Name" ],
+				"DisplayName": "Author's Name",
 
 				"CoreConnectionColumn": "IDBook",
 
@@ -194,6 +353,39 @@ module.exports.default_configuration.pict_configuration = (
 
 				"ExternalFilterByTable": "Author",
 				"ExternalFilterByTableConnectionColumn": "IDAuthor"
+			},
+			"ExternalJoinBookBySelectedAuthors":
+			{
+				"Label": "Authors",
+				"Type": "ExternalJoinSelectedValueList",
+				"ExternalFilterByColumns": [ "Name", "GUIDAuthor" ],
+
+				"MaximumSelectedExternalRecords": 5,
+				"ExternalRecordDisplayTemplate": "{~D:Record.Data.Name~}",
+
+				"CoreConnectionColumn": "IDBook",
+
+				"JoinTable": "BookAuthorJoin",
+				"JoinTableExternalConnectionColumn": "IDAuthor",
+				"JoinTableCoreConnectionColumn": "IDBook",
+
+				"ExternalFilterByTable": "Author",
+				"ExternalFilterByTableConnectionColumn": "IDAuthor",
+				"CustomFilterViewHash": "MyCoolView"
+			},
+			"InternalJoinBySelectedJoinIDs":
+			{
+				"Label": "Join IDs (internal test)",
+				"Type": "InternalJoinSelectedValue",
+				"ExternalFilterByColumns": [ "IDBookAuthorJoin" ],
+
+				"ExternalRecordDisplayTemplate": "{~D:Record.Data.IDBookAuthorJoin~} [{~D:Record.Data.IDBook~} &lt;-&gt; {~D:Record.Data.IDAuthor~}]",
+
+				"CoreConnectionColumn": "IDBook",
+
+				"RemoteTable": "BookAuthorJoin",
+				"JoinExternalConnectionColumn": "IDBook",
+				"JoinInternalConnectionColumn": "IDBook"
 			}
 		},
 		"FilterCriteria":
@@ -201,7 +393,11 @@ module.exports.default_configuration.pict_configuration = (
 			"FilterRecordsetByBookAndCreateDate":
 			[
 				{
-					"FilterDefinitionHash": "ExternalJoinBookByAuthor",
+					"FilterDefinitionHash": "ExternalJoinBookBySelectedAuthors",
+					"FilterByColumn": "IDBook"
+				},
+				{
+					"FilterDefinitionHash": "InternalJoinBySelectedJoinIDs",
 					"FilterByColumn": "IDBook"
 				},
 				{
@@ -236,7 +432,7 @@ module.exports.default_configuration.pict_configuration = (
 				{
 					"Title":
 					[
-						{ "FilterKey": "Title", "ClauseKey": "TitleMatch", "DisplayName": "Book Title Custom Filter", "Type": "StringMatch", "FilterByColumn": "Title", "ExactMatch": true }
+						{ "FilterKey": "Title", "ClauseKey": "TitleMatch", "Label": "Book Title Custom Filter", "Type": "StringMatch", "FilterByColumn": "Title", "ExactMatch": true }
 					]
 				},
 

package/example_applications/simple_entity/html/index.html

@@ -3,6 +3,12 @@
 	<head>
 		<title>Simple.</title>
 		<style id="PICT-CSS"></style>
+		<style>
+			.is-hidden
+			{
+				display: none;
+			}
+		</style>
 		<script src="./pict.js" type="text/javascript"></script>
 		<script type="text/javascript">Pict.safeOnDocumentReady(() => { Pict.safeLoadPictApplication(SimpleApplication, 1)});</script>
 	</head>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pict-section-recordset",
-  "version": "1.0.43",
+  "version": "1.0.45",
   "description": "Pict dynamic record set management views",
   "main": "source/Pict-Section-RecordSet.js",
   "directories": {
@@ -33,7 +33,7 @@
     "browser-env": "^3.3.0",
     "eslint": "^9.28.0",
     "jquery": "^3.7.1",
-    "pict": "^1.0.295",
+    "pict": "^1.0.299",
     "pict-application": "^1.0.27",
     "pict-service-commandlineutility": "^1.0.15",
     "quackage": "^1.0.42",

package/source/providers/Filter-Data-Provider.js

@@ -0,0 +1,371 @@
+const libPictProvider = require('pict-provider');
+
+const _DEFAULT_PROVIDER_CONFIGURATION =
+{
+	ProviderIdentifier: 'FilterDataProvider',
+
+	AutoInitialize: true,
+	AutoInitializeOrdinal: 0,
+};
+
+class FilterDataProvider extends libPictProvider
+{
+	/**
+	 * @param {import('pict')} pFable - The Fable instance
+	 * @param {Record<string, any>} [pOptions] - The options for the provider
+	 * @param {string} [pServiceHash] - The service hash for the provider
+	 */
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		let tmpOptions = Object.assign({}, _DEFAULT_PROVIDER_CONFIGURATION, pOptions);
+		super(pFable, tmpOptions, pServiceHash);
+
+		// This allows unit tests to run
+		this.storageProvider = this;
+		this.keyCache = {};
+		if ((typeof(window) === 'object') && (typeof(window.localStorage) === 'object'))
+		{
+			this.storageProvider = window.localStorage;
+		}
+
+		this.filtersMap = { };
+		this.lastFilterExperienceHashMap = { };
+	}
+
+	onBeforeInitialize()
+	{
+		this.loadFilters();
+
+		return super.onBeforeInitialize();
+	}
+
+	/**
+	 * @return {void}
+	 */
+	loadFilters()
+	{
+		// load all known recordsets
+	}
+
+	/**
+	 * List all available Filters (from the Filter Meta data)
+	 * 
+	 * @param {string} pRecordSet - the record set to list the filters for
+	 *
+	 * @return Array<Record<string, any>> - a list of Filters as Index/FilterExperienceHash entries
+	 */
+	listFilters(pRecordSet)
+	{
+		this.loadFilterMeta(pRecordSet);
+		const filtersList = this.filtersMap[pRecordSet] || [];
+		const tmpFilterList = filtersList.map((pValue, pIndex) => { return { Index: pIndex, RecordSet: pRecordSet, FilterExperienceHash: pValue }; });
+		return tmpFilterList;
+	}
+
+	/**
+	 * @param {string} pRecordSet - the record set to get the active filter experience for
+	 *
+	 * @return {Record<string, any>} - the active filter experience for the given record set
+	 */
+	getActiveFilterExperience(pRecordSet)
+	{
+		return this.pict.Bundle._ActiveFilterState?.[pRecordSet];
+	}
+
+	/**
+	 * Check if a particular scope is in use.
+	 *
+	 * @param {string} pRecordSet - the record set
+	 * @param {string} pFilterExperienceHash - the manyfest scope to check the existence of
+	 *
+	 * @return {boolean}
+	 */
+	checkFilterExists(pRecordSet, pFilterExperienceHash)
+	{
+		const filterExperience = this.getActiveFilterExperience(pRecordSet);
+		if (filterExperience && filterExperience.FilterExperienceHash === pFilterExperienceHash)
+		{
+			return true;
+		}
+		// Make sure other tabs didn't do something funny.
+		// Also.  This means users can do FUNNY BUSINESS and mess with the state if they have a 
+		// crapton of tabs open and delete a manyfest in one tab and later this check happens.
+		// Will not result in data loss but will result in flaky behavior.
+		this.loadFilterMeta(pRecordSet, false);
+		const filtersList = this.filtersMap[pRecordSet] || [];
+		return filtersList.indexOf(pFilterExperienceHash) >= 0;
+	}
+
+	/**
+	 * Resolve a key in the LocalStorage keyspace for a filter experience for a given record set.
+	 * 
+	 * @param {string} pRecordSet - The record set to resolve a key for
+	 * @param {string} pFilterExperienceHash - The scope to resolve a key for
+	 *
+	 * @return {string} A string that points to the record.
+	 */
+	getFilterStorageKey(pRecordSet, pFilterExperienceHash)
+	{
+		this.loadFilterMeta(pRecordSet, false);
+		// Default to the loaded manyfest if nothing is passed in.
+		let tmpFilterExperienceHash = (typeof(pFilterExperienceHash) === 'string') ? pFilterExperienceHash : this.pict.AppData?.FilterRecord?.FilterExperienceHash ?? 'RECENT';
+		return `${pRecordSet}_Filter_${tmpFilterExperienceHash}`;
+	}
+
+	/**
+	 * Save the application metadata (list of Filters, last loaded FilterExperienceHash, etc.)
+	 *
+	 * @param {string} pRecordSet - The record set to save the filter for; TODO: should this have a default?
+	 * @param {boolean} [pRender=false] - Whether or not to also render the list of Filters in the UI automatically
+	 */
+	saveFilterMeta(pRecordSet, pRender = false)
+	{
+		const filtersList = this.filtersMap[pRecordSet] || [];
+
+		// TODO: BUG: Gotta have a more complex merge happen here for multiple tabs
+		this.storageProvider.setItem(`Filter_Meta_${pRecordSet}`, JSON.stringify({ LastFilterExperienceHash: this.lastFilterExperienceHashMap[pRecordSet] || 'RECENT', FilterList: filtersList }));
+
+		if (pRender && this.pict.views.FilterPersistenceView)
+		{
+			this.pict.views.FilterPersistenceView.render()
+		}
+
+		return true;
+	}
+
+	/**
+	 * Save the application metadata (list of Filters, last loaded FilterExperienceHash, etc.)
+	 *
+	 * @param {string} pRecordSet - The record set to save the filter for; TODO: should this have a default?
+	 * @param {boolean} [pRender=false] - Whether or not to also render the list of Filters in the UI automatically
+	 *
+	 * @return {Array<object>} The list of available Filters.
+	 */
+	loadFilterMeta(pRecordSet, pRender = false)
+	{
+		// We get this every time in case the user has multiple tabs open
+		let tmpFilterMetaJSON = this.storageProvider.getItem(`Filter_Meta_${pRecordSet}`);
+		if (!tmpFilterMetaJSON)
+		{
+			tmpFilterMetaJSON = '{}';
+		}
+		let tmpFilterMeta = JSON.parse(tmpFilterMetaJSON)
+
+		let filtersList = tmpFilterMeta.FilterList;
+		this.filtersMap[pRecordSet] = filtersList;
+		this.lastFilterExperienceHashMap[pRecordSet] = tmpFilterMeta.LastFilterExperienceHash;
+
+		if (!Array.isArray(filtersList))
+		{
+			this.filtersMap[pRecordSet] = [];
+			//this.lastFilterExperienceHashMap[pRecordSet] = 'LATEST';
+			this.saveFilterMeta(pRecordSet)
+		}
+
+		if (pRender && this.pict.views.FilterPersistenceView)
+		{
+			this.pict.views.FilterPersistenceView.render()
+		}
+
+		return filtersList;
+	}
+
+	/**
+	 * @param {string} pRecordSet - The record set to add the filter experience hash to
+	 * @param {string} pFilterExperienceHash - The filter experience hash to add
+	 * @param {boolean} [pRender=true] - Whether or not to also render the list of Filters in the UI automatically
+	 *
+	 * @return {boolean} True if the filter experience hash was added, false if it already exists.
+	 */
+	addFilterExperienceHashToFilterList(pRecordSet, pFilterExperienceHash, pRender)
+	{
+		let tmpRender = (typeof(pRender) === 'undefined') ? true : pRender;
+
+		this.loadFilterMeta(pRecordSet);
+
+		const tmpFilterList = this.filtersMap[pRecordSet] || [];
+
+		let tmpFilterFilterExperienceHashIndex = tmpFilterList.indexOf(pFilterExperienceHash);
+
+		if (tmpFilterFilterExperienceHashIndex >= 0)
+		{
+			return false;
+		}
+		const filtersList = this.filtersMap[pRecordSet] || [];
+		filtersList.push(pFilterExperienceHash);
+		this.filtersMap[pRecordSet] = filtersList;
+
+		this.saveFilterMeta(pRecordSet);
+
+		if (tmpRender && this.pict.views.FilterPersistenceView)
+		{
+			this.pict.views.FilterPersistenceView.render()
+		}
+
+		return true;
+	}
+
+	/**
+	 * @param {string} pRecordSet - The record set to remove the filter experience hash from
+	 * @param {string} pFilterExperienceHash - The filter experience hash to remove
+	 * @param {boolean} [pRender=true] - Whether or not to also render the list of Filters in the UI automatically
+	 */
+	removeFilterExperienceHashFromFilterList(pRecordSet, pFilterExperienceHash, pRender)
+	{
+		let tmpRender = (typeof(pRender) === 'undefined') ? true : pRender;
+
+		let tmpFilterList = this.loadFilterMeta(pRecordSet);
+
+		let tmpFilterFilterExperienceHashIndex = tmpFilterList.indexOf(pFilterExperienceHash);
+
+		if (tmpFilterFilterExperienceHashIndex >= 0)
+		{
+			// Could use array splice but meh
+			let tmpNewFilterList = [];
+
+			for (let i = 0; i < tmpFilterList.length; i++)
+			{
+				if (tmpFilterList[i] != pFilterExperienceHash)
+				{
+					tmpNewFilterList.push(tmpFilterList[i]);
+				}
+			}
+
+			this.filtersMap[pRecordSet] = tmpNewFilterList;
+
+			this.saveFilterMeta(pRecordSet, true);
+
+			if (tmpRender && this.pict.views.FilterPersistenceView)
+			{
+				this.pict.views.FilterPersistenceView.render()
+			}
+
+			return true;
+		}
+
+		return false;
+	}
+
+	/**
+	 * @param {string} pRecordSet - The record set to create a new filter for
+	 * @param {string} [pFilterExperienceHash] - The filter experience hash to create a new filter for; if not provided, a new one will be generated
+	 */
+	newFilter(pRecordSet, pFilterExperienceHash)
+	{
+		let tmpFilterExperienceHash = ((typeof(pFilterExperienceHash) === 'string') && (pFilterExperienceHash.length > 0)) ? pFilterExperienceHash : false;
+
+		if (!tmpFilterExperienceHash)
+		{
+			// Autogenerate a scope
+			const filtersList = this.filtersMap[pRecordSet] || [];
+			let tmpProspectiveIndex = filtersList.length;
+
+			// If a user has more than 10,000 manifests we need to talk.  In person.
+			for (let i = 0; i < 10000; i++)
+			{
+				let tmpFilterFilterExperienceHash = `New Manifest ${tmpProspectiveIndex}`;
+
+				if (!this.checkFilterExists(pRecordSet, tmpFilterFilterExperienceHash))
+				{
+					tmpFilterExperienceHash = tmpFilterFilterExperienceHash;
+					break;
+				}
+			}
+		}
+		else
+		{
+			// Check to ensure the manyfest doesn't already exist.
+			if (this.checkFilterExists(pRecordSet, tmpFilterExperienceHash))
+			{
+				this.log.warn(`Filter ${tmpFilterExperienceHash} already exists but it was explicitly requested by the user.  Loading insted.`);
+				return this.loadFilter(pRecordSet, tmpFilterExperienceHash);
+			}
+		}
+
+		// As far as I can tell this only happens if the user has more than 10,000 manifests
+		if (!tmpFilterExperienceHash)
+		{
+			this.log.warn(`You have won the lottery.  Seriously.  Call us to learn more!  Please email steven@velozo.com for more details.`);
+			tmpFilterExperienceHash = 'LotteryWinner';
+		}
+
+		// Now create the new manyfest
+		let tmpNewManifest = JSON.parse(JSON.stringify(this.options.DefaultManifest));
+		tmpNewManifest.FilterExperienceHash = tmpFilterExperienceHash;
+
+		// Now save it.
+		this.storageProvider.setItem(this.getFilterStorageKey(pRecordSet, tmpFilterExperienceHash), JSON.stringify(tmpNewManifest));
+		this.addFilterExperienceHashToFilterList(pRecordSet, tmpFilterExperienceHash, true);
+
+		// TODO: Do we load it?  Maaaaaaaybe.  Figure out the "autosave before load" workflow.
+
+		this.loadFilter(pRecordSet, tmpFilterExperienceHash);
+	}
+
+	/**
+	 * @param {string} pRecordSet - The record set to save the filter for; TODO: should this have a default?
+	 */
+	saveFilter(pRecordSet)
+	{
+		let tmpFilterFilterExperienceHash = this.pict.AppData.FilterRecord.FilterExperienceHash;
+		// TODO: Should this be a .... merge?  Yikes.  Multiple tabs is bonkers.
+		this.storageProvider.setItem(this.getFilterStorageKey(pRecordSet, tmpFilterFilterExperienceHash), JSON.stringify(this.pict.AppData.FilterRecord));
+		this.addFilterExperienceHashToFilterList(pRecordSet, tmpFilterFilterExperienceHash);
+	}
+
+	/**
+	 * @param {string} pRecordSet - The record set to load the filter for
+	 * @param {string} pFilterFilterExperienceHash - The filter experience hash to load; if not provided, the last used one will be loaded
+	 */
+	loadFilter(pRecordSet, pFilterFilterExperienceHash)
+	{
+		let tmpFilterJSON = this.storageProvider.getItem(this.getFilterStorageKey(pRecordSet, pFilterFilterExperienceHash));
+		if (tmpFilterJSON)
+		{
+			this.pict.AppData.FilterRecord = JSON.parse(tmpFilterJSON);
+		}
+		this.pict.providers.FilterRouter.postPersistNavigate();
+	}
+
+	/**
+	 * @param {string} pKey - The key to get from the cache
+	 *
+	 * @return {any} - The value associated with the key, or false if not found
+	 */
+	getItem(pKey)
+	{
+		if (pKey in this.keyCache)
+		{
+			return this.keyCache[pKey];
+		}
+		return false;
+	}
+
+	/**
+	 * @param {string} pKey - The key to set in the cache
+	 * @param {any} pValue - The value to associate with the key
+	 */
+	setItem(pKey, pValue)
+	{
+		this.keyCache[pKey] = pValue;
+		return true;
+	}
+
+	/**
+	 * @param {string} pKey - The key to remove from the cache
+	 *
+	 * @return {boolean} - True if the item was removed, false if it was not found
+	 */
+	removeItem(pKey)
+	{
+		if (pKey in this.keyCache)
+		{
+			delete this.keyCache[pKey];
+			return true;
+		}
+		return false;
+	}
+}
+
+module.exports = FilterDataProvider;
+module.exports.default_configuration = _DEFAULT_PROVIDER_CONFIGURATION;

package/source/providers/RecordSet-Link-Manager.js

@@ -31,7 +31,15 @@ class PictRecordSetLinkManager extends libPictProvider
 		this.linkTemplates = [];
 	}
 
-	// TODO: Add the ability to add routes that are scoped to particular entity types
+	/**
+	 * TODO: Add the ability to add routes that are scoped to particular entity types
+	 *
+	 * @param {string} pNameTemplate - The name template for the record link.
+	 * @param {string} pURLTemplate - The URL template for the record link.
+	 * @param {boolean} pDefault - Whether this is a default link template.
+	 *
+	 * @return {Record<string, any>} - The link template object that was added.
+	 */
 	addRecordLinkTemplate(pNameTemplate, pURLTemplate, pDefault)
 	{
 		let tmpDefaultAction = (typeof(pDefault) !== 'undefined') ? pDefault : false;

package/source/providers/RecordSet-RecordProvider-Base.js

@@ -8,7 +8,7 @@ const libPictProvider = require('pict-provider');
 const _DefaultProviderConfiguration = {
 	ProviderIdentifier: 'Pict-RecordSetProvider',
 	AutoInitialize: true,
-	AutoInitializeOrdinal: 0,
+	AutoInitializeOrdinal: 1, // initialize after other providers if initialized during app init
 	AutoSolveWithApp: false,
 };