@iebh/tera-fy 1.13.2 → 1.13.4

package/lib/terafy.proxy.js

@@ -25,7 +25,7 @@ export class TeraProxy {
 		host: '0.0.0.0',
 		port: 7334,
 		targetProtocol: 'https',
-		targetHost: 'tera-tools.com',
+		targetHost: 'dev.tera-tools.com',
 		targetPort: 443,
 		portConflict: 'ignore',
 		onLog: (level, ...msg) => console.log(...msg),
@@ -109,6 +109,9 @@ export class TeraProxy {
 
 /**
 * Utility function to return a new TeraProxy instance
+*
+* @param {Object} [options] Options to pass to the Proxy module
+* @returns {TeraProxy} A TeraProxy instance
 */
 export default function(options) {
 	return new TeraProxy(options);

package/lib/terafy.server.js

@@ -152,7 +152,7 @@ export default class TeraFyServer {
 	* This function only works if the context was sub-classed via `createContext()`
 	*
 	* @param {String} method The method name to call
-	* @param {*} [...] Optional arguments to pass to the function
+	* @param {...*} [args] Optional arguments to pass to the function
 	*
 	* @returns {Promise<*>} The resolved output of the server function
 	*/
@@ -213,7 +213,7 @@ export default class TeraFyServer {
 	* Unlike send() this method does not expect any response
 	*
 	* @param {Object} message Message object to send
-	* @param {Window} Window context to dispatch the message via if its not the same as the regular window
+	* @param {Window} sendVia Window context to dispatch the message via if its not the same as the regular window
 	*/
 	sendRaw(message, sendVia) {
 		let payload;
@@ -256,7 +256,7 @@ export default class TeraFyServer {
 	/**
 	* Accept a message from the parent event listener
 	*
-	* @param {MessageEvent} Raw message event to process
+	* @param {MessageEvent} rawMessage Raw message event to process
 	*/
 	acceptMessage(rawMessage) {
 		if (rawMessage.origin == window.location.origin) return; // Message came from us
@@ -326,7 +326,7 @@ export default class TeraFyServer {
 	* Note that emitted messages have no response - they are sent to clients only with no return value
 	*
 	* @param {String} event The event name to emit
-	* @param {*} [args...] Optional event payload to send
+	* @param {...*} [args] Optional event payload to send
 	* @returns {Promise} A promise which resolves when the transmission has completed
 	*/
 	emitClients(event, ...args) {
@@ -709,7 +709,7 @@ export default class TeraFyServer {
 	*
 	* @param {Object} [options] Additional options to mutate behaviour
 	* @param {Boolean} [options.autoRequire=true] Run `requireProject()` automatically before continuing
-	* @param {Array<String>} Paths to subscribe to e.g. ['/users/'],
+	* @param {Array<String>} [options.paths] Paths to subscribe to e.g. ['/users/'],
 	*
 	* @returns {Promise<Object>} The current project state snapshot
 	*/
@@ -877,7 +877,7 @@ export default class TeraFyServer {
 	/**
 	* Apply a computed `just-diff` patch to the current project state
 	*
-	* @param {Object} Patch to apply
+	* @param {Object} patch Patch to apply
 	* @returns {Promise} A promise which resolves when the operation has completed
 	*/
 	applyProjectStatePatch(patch) {
@@ -1056,6 +1056,7 @@ export default class TeraFyServer {
 	* Fetch the raw contents of a file by its ID
 	*
 	* @param {String} [id] File ID to retrieve the contents of
+	*
 	* @param {Object} [options] Additioanl options to mutate behaviour
 	* @param {'blob'|'json'} [options.format='blob'] The format to retrieve the file in. If `json` the raw output is run via JSON.parse() first
 	*
@@ -1180,7 +1181,7 @@ export default class TeraFyServer {
 	/**
 	* Prompt the user to select a library to operate on and return a array of references in a given format
 	*
-	* @param {Object} [options] Additional options to mutate behaviour
+	* @param {Object} [options] Additional options to mutate behaviour - see `getProjectLibrary()` for parent list of options
 	* @param {String} [options.title="Select a citation library"] The title of the dialog to display
 	* @param {String|Array<String>} [options.hint] Hints to identify the library to select in array order of preference. Generally corresponds to the previous stage - e.g. 'deduped', 'review1', 'review2', 'dedisputed'
 	* @param {Boolean} [options.allowUpload=true] Allow uploading new files
@@ -1189,7 +1190,6 @@ export default class TeraFyServer {
 	* @param {Boolean} [options.allowCancel=true] Allow cancelling the operation. Will throw `'CANCEL'` as the promise rejection if acationed
 	* @param {Boolean} [options.autoRequire=true] Run `requireProject()` automatically before continuing
 	* @param {FileFilters} [options.filters] Optional file filters, defaults to citation library selection only
-	* @param {*} [options.*] Additional options - see `getProjectLibrary()`
 	*
 	* @returns {Promise<Array<Ref>>} A collection of references from the selected file
 	*/
@@ -1380,36 +1380,17 @@ export default class TeraFyServer {
 	}
 	// }}}
 
-	// Webpages - setPageUrl(), setPageTitle {{{
-
+	// Webpages - setPage() {{{
 	/**
-	* Set an active tools URL (or path) so that it survives a refresh
+	* Set an active tools URL or other context information so that it survives a refresh
 	* This only really makes a difference to tools within the tera-tools.com site where the tool is working as an embed
 	*
-	* @param {String} url The URL to restore on next refresh
-	*/
-	setPageUrl(url) {
-		if (!url.startsWith('/')) throw new Error('All pageURLs must be a relative path starting with a slash');
-
-		let $routeMatched = app.service('$route').matched[0];
-		if (!$routeMatched?.name) throw new Error('No active route');
-		if ($routeMatched?.path == '/embed') return this.debug('INFO', 2, 'Ignoring setPageUrl(', url, ') on when in embed mode');
-		if (!$routeMatched?.path.endsWith('/:toolPath(.*)?')) return this.debug('INFO', 2, 'Ignoring setPageUrl(', url, ') - no active tool anyway');
-
-		app.router.push({
-			path: $routeMatched.path.replace(/\/:toolPath\(\.\*\)\?$/, url),
-		});
-	}
-
-
-	/**
-	* Set the active page title
-	* This is usually called by a tool nested within the tera-tools.com embed
-	*
-	* @param {String} [title] The current page title. Set to a falsy value to revert back to the default page title
+	* @param {Object|String} options Context information about the page, if this is a string, its assumed to popupate `url`
+	* @param {String} [options.path] The URL path segment to restore on next refresh
+	* @param {String} [options.title] The page title associated with the path
 	*/
-	setPageTitle(title) {
-		app.root.setPageTitle(title);
+	setPage(options) {
+		app.service('$projects').setPage(options);
 	}
 	// }}}
 
@@ -1737,13 +1718,14 @@ export default class TeraFyServer {
 
 	// Utility - debug() {{{
 
+	/* eslint-disable jsdoc/check-param-names */
 	/**
 	* Debugging output function
 	* This function will only act if `settings.devMode` is truthy
 	*
 	* @param {'INFO'|'LOG'|'WARN'|'ERROR'} [method='LOG'] Logging method to use
 	* @param {Number} [verboseLevel=1] The verbosity level to trigger at. If `settings.verbosity` is lower than this, the message is ignored
-	* @param {String} [msg...] Output to show
+	* @param {...*} [msg] Output to show
 	*/
 	debug(...msg) {
 		if (!this.settings.devMode || this.settings.verbosity < 1) return; // Debugging is disabled
@@ -1768,5 +1750,6 @@ export default class TeraFyServer {
 			...msg,
 		);
 	}
+	/* eslint-enable */
 	// }}}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iebh/tera-fy",
-  "version": "1.13.2",
+  "version": "1.13.4",
   "description": "TERA website worker",
   "scripts": {
     "dev": "esbuild --platform=browser --format=esm --bundle lib/terafy.client.js --outfile=dist/terafy.js --minify --serve --servedir=.",
@@ -76,15 +76,15 @@
     "lodash-es": "^4.17.21",
     "mitt": "^3.0.1",
     "nanoid": "^5.0.7",
-    "release-it": "^17.5.0"
+    "release-it": "^17.6.0"
   },
   "devDependencies": {
-    "@momsfriendlydevco/eslint-config": "^2.0.1",
+    "@momsfriendlydevco/eslint-config": "^2.0.3",
     "@release-it/conventional-changelog": "^8.0.1",
     "concurrently": "^8.2.2",
     "documentation": "^14.0.3",
     "esbuild": "^0.23.0",
-    "eslint": "^9.6.0"
+    "eslint": "^9.7.0"
   },
   "peerDependencies": {
     "vue": "^3.0.0"

package/plugins/vite.js

@@ -5,6 +5,7 @@ import TeraProxy from '../lib/terafy.proxy.js';
 *
 * @see lib/terafy.proxy.js
 *
+* @param {Object} [options] Options to pass to the Proxy module
 * @returns {VitePlugin}
 */
 export default function vitePluginTeraFy(options) {

package/plugins/vue3.js

@@ -118,6 +118,8 @@ export default class TeraFyPluginVue extends TeraFyPluginBase {
 	* Utility function which returns an awaitable promise when the state is loading or being refreshed
 	* This is used in place of `statePromisable` as it has a slightly more logical syntax as a function
 	*
+	* @returns {Promise} A promise representing the loading of the project state
+	*
 	* @example Await the state loading
 	* await $tera.statePromise();
 	*/
@@ -128,6 +130,8 @@ export default class TeraFyPluginVue extends TeraFyPluginBase {
 
 	/**
 	* Provide a Vue@3 compatible plugin
+	*
+	* @returns {VuePlugin} A Vue@3 plugin spec
 	*/
 	vuePlugin() {
 		let $tera = this;
@@ -137,12 +141,12 @@ export default class TeraFyPluginVue extends TeraFyPluginBase {
 			/**
 			* Install into Vue as a generic Vue@3 plugin
 			*
+			* @param {VueApp} app The Vue top-level app to install against
+			*
 			* @param {Object} [options] Additional options to mutate behaviour
 			* @param {Boolean} [options.autoInit=true] Call Init() during the `statePromiseable` cycle if its not already been called
 			* @param {String} [options.globalName='$tera'] Globa property to allocate this service as
 			* @param {Objecct} [options.bindOptions] Options passed to `bindProjectState()`
-			*
-			* @returns {VuePlugin} A plugin matching the Vue@3 spec
 			*/
 			install(app, options) {
 				let settings = {

package/utils/pathTools.js

@@ -11,7 +11,6 @@ import {
 * General path setters / getters for project state
 * These are _MAINLY_ wrappers for Lodash functionality such as Lodash.set() / Lodash.get(), any deviations are documented inline
 *
-* @typedef {PathTools}
 * In each case these functions work with either dotted or array notation against a target master-object
 *     - Dotted notation - e.g. `foo.bar.1.baz`
 *     - Array path segments e.g. `['foo', 'bar', 1, 'baz']`
@@ -77,8 +76,8 @@ export function set(target, path, value, options) {
 * @param {*} [fallback] Optional fallback to return if the end point does not exist
 * @returns {*} The fetched value
 */
-export function get(subject, path, fallback) {
-	return _get(subject, path, fallback);
+export function get(target, path, fallback) {
+	return _get(target, path, fallback);
 }
 
 
@@ -132,6 +131,7 @@ export function defaults(target, path, value) {
 	}
 }
 
+
 // Export all functions as a lookup object
 export default {
 	set,

package/widgets/tera-file-select.vue

@@ -55,7 +55,7 @@ export default {
 		* Trigger the file selection functionality within TERA-fy
 		* This sets the `selected` data property to the newly selected file + fires @change
 		*
-		* @fires change Fired as `(file:ProjectFile)` when the contents changes
+		* @emits change Fired as `(file:ProjectFile)` when the contents changes
 		* @returns {ProjectFile} file The selected file
 		*/
 		async choose() {