npm - pict-docuserve - Versions diffs - 0.0.1 - Mend

pict-docuserve 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (36) hide show

package/LICENSE +21 -0
package/build-site.js +172 -0
package/css/docuserve.css +73 -0
package/dist/css/docuserve.css +73 -0
package/dist/index.html +32 -0
package/dist/js/pict.compatible.js +7793 -0
package/dist/js/pict.compatible.js.map +1 -0
package/dist/js/pict.compatible.min.js +12 -0
package/dist/js/pict.compatible.min.js.map +1 -0
package/dist/js/pict.js +7792 -0
package/dist/js/pict.js.map +1 -0
package/dist/js/pict.min.js +12 -0
package/dist/js/pict.min.js.map +1 -0
package/dist/pict-docuserve.compatible.js +5148 -0
package/dist/pict-docuserve.compatible.js.map +1 -0
package/dist/pict-docuserve.compatible.min.js +2 -0
package/dist/pict-docuserve.compatible.min.js.map +1 -0
package/dist/pict-docuserve.js +4670 -0
package/dist/pict-docuserve.js.map +1 -0
package/dist/pict-docuserve.min.js +2 -0
package/dist/pict-docuserve.min.js.map +1 -0
package/html/index.html +32 -0
package/package.json +52 -0
package/source/Pict-Application-Docuserve-Configuration.json +15 -0
package/source/Pict-Application-Docuserve.js +246 -0
package/source/cli/Docuserve-CLI-Program.js +16 -0
package/source/cli/Docuserve-CLI-Run.js +3 -0
package/source/cli/commands/Docuserve-Command-Inject.js +127 -0
package/source/cli/commands/Docuserve-Command-Serve.js +135 -0
package/source/providers/Pict-Provider-Docuserve-Documentation.js +1156 -0
package/source/providers/PictRouter-Docuserve-Configuration.json +26 -0
package/source/views/PictView-Docuserve-Content.js +208 -0
package/source/views/PictView-Docuserve-Layout.js +105 -0
package/source/views/PictView-Docuserve-Sidebar.js +362 -0
package/source/views/PictView-Docuserve-Splash.js +264 -0
package/source/views/PictView-Docuserve-TopBar.js +213 -0

package/html/index.html ADDED Viewed

@@ -0,0 +1,32 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8">
+		<meta http-equiv="X-UA-Compatible" content="IE=edge">
+		<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+		<meta name="description" content="Retold Documentation - A suite of JavaScript/Node.js modules for building web applications and APIs">
+		<title>Retold Documentation</title>
+		<!-- Application Stylesheet -->
+		<link href="css/docuserve.css" rel="stylesheet">
+		<!-- PICT Dynamic View CSS Container -->
+		<style id="PICT-CSS"></style>
+		<!-- Load the PICT library -->
+		<script src="./js/pict.min.js" type="text/javascript"></script>
+		<!-- Bootstrap the Application -->
+		<script type="text/javascript">
+//<![CDATA[
+		Pict.safeOnDocumentReady(() => { Pict.safeLoadPictApplication(PictDocuserve, 2)});
+//]]>
+		</script>
+	</head>
+	<body>
+		<!-- The root container for the Pict application -->
+		<div id="Docuserve-Application-Container"></div>
+		<!-- Load the Docuserve PICT Application Bundle -->
+		<script src="./pict-docuserve.min.js" type="text/javascript"></script>
+	</body>
+</html>

package/package.json ADDED Viewed

@@ -0,0 +1,52 @@
+{
+	"name": "pict-docuserve",
+	"version": "0.0.1",
+	"description": "Pict Documentation Server - A single-page documentation viewer built on Pict",
+	"main": "source/Pict-Application-Docuserve.js",
+	"bin": {
+		"pict-docuserve": "source/cli/Docuserve-CLI-Run.js"
+	},
+	"files": [
+		"source/",
+		"dist/",
+		"css/",
+		"html/",
+		"build-site.js"
+	],
+	"scripts": {
+		"start": "node source/Pict-Application-Docuserve.js",
+		"build": "npx quack build && npx quack copy",
+		"build-site": "npx quack build && npx quack copy && node build-site.js",
+		"build-examples": "npx quack build && npx quack copy && node build-site.js --docs-path example_applications/todo-app/docs --output-path example_applications/todo-app/site && node build-site.js --docs-path example_applications/contacts-app/docs --output-path example_applications/contacts-app/site && node build-site.js --docs-path example_applications/sports-stats-api/docs --output-path example_applications/sports-stats-api/site",
+		"test": "echo \"Error: no test specified\" && exit 0"
+	},
+	"author": "steven velozo <steven@velozo.com>",
+	"license": "MIT",
+	"dependencies": {
+		"pict": "^1.0.343",
+		"pict-application": "^1.0.28",
+		"pict-view": "^1.0.64",
+		"pict-provider": "^1.0.3",
+		"pict-service-commandlineutility": "^1.0.17"
+	},
+	"devDependencies": {
+		"quackage": "^1.0.41"
+	},
+	"copyFilesSettings": {
+		"whenFileExists": "overwrite"
+	},
+	"copyFiles": [
+		{
+			"from": "./html/*",
+			"to": "./dist/"
+		},
+		{
+			"from": "./css/**",
+			"to": "./dist/css/"
+		},
+		{
+			"from": "./node_modules/pict/dist/*",
+			"to": "./dist/js/"
+		}
+	]
+}

package/source/Pict-Application-Docuserve-Configuration.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+	"Name": "Pict Docuserve",
+	"Hash": "Docuserve",
+	"MainViewportViewIdentifier": "Docuserve-Layout",
+	"AutoSolveAfterInitialize": true,
+	"AutoRenderMainViewportViewAfterInitialize": false,
+	"AutoRenderViewsAfterInitialize": false,
+	"pict_configuration":
+		{
+			"Product": "Docuserve-Pict-Application"
+		}
+}

package/source/Pict-Application-Docuserve.js ADDED Viewed

@@ -0,0 +1,246 @@
+const libPictApplication = require('pict-application');
+// Provider
+const libDocumentationProvider = require('./providers/Pict-Provider-Docuserve-Documentation.js');
+// Views
+const libViewLayout = require('./views/PictView-Docuserve-Layout.js');
+const libViewTopBar = require('./views/PictView-Docuserve-TopBar.js');
+const libViewSidebar = require('./views/PictView-Docuserve-Sidebar.js');
+const libViewSplash = require('./views/PictView-Docuserve-Splash.js');
+const libViewContent = require('./views/PictView-Docuserve-Content.js');
+class DocuserveApplication extends libPictApplication
+{
+	constructor(pFable, pOptions, pServiceHash)
+	{
+		super(pFable, pOptions, pServiceHash);
+		// Add the documentation provider
+		this.pict.addProvider('Docuserve-Documentation', libDocumentationProvider.default_configuration, libDocumentationProvider);
+		// Add views
+		this.pict.addView('Docuserve-Layout', libViewLayout.default_configuration, libViewLayout);
+		this.pict.addView('Docuserve-TopBar', libViewTopBar.default_configuration, libViewTopBar);
+		this.pict.addView('Docuserve-Sidebar', libViewSidebar.default_configuration, libViewSidebar);
+		this.pict.addView('Docuserve-Splash', libViewSplash.default_configuration, libViewSplash);
+		this.pict.addView('Docuserve-Content', libViewContent.default_configuration, libViewContent);
+	}
+	onAfterInitializeAsync(fCallback)
+	{
+		// Initialize application state
+		this.pict.AppData.Docuserve =
+		{
+			CatalogLoaded: false,
+			Catalog: null,
+			CoverLoaded: false,
+			Cover: null,
+			SidebarLoaded: false,
+			SidebarGroups: [],
+			TopBarLoaded: false,
+			TopBar: null,
+			ErrorPageLoaded: false,
+			ErrorPageHTML: null,
+			CurrentGroup: '',
+			CurrentModule: '',
+			CurrentPath: '',
+			// Whether the sidebar is currently visible
+			SidebarVisible: true,
+			// Base URL for local docs (relative to where the app is served)
+			DocsBaseURL: '',
+			// URL for the catalog JSON
+			CatalogURL: 'retold-catalog.json'
+		};
+		// Load the catalog, then render the layout
+		let tmpDocProvider = this.pict.providers['Docuserve-Documentation'];
+		tmpDocProvider.loadCatalog(() =>
+		{
+			// Render the layout shell, which triggers child view rendering
+			this.pict.views['Docuserve-Layout'].render();
+			return super.onAfterInitializeAsync(fCallback);
+		});
+	}
+	/**
+	 * Read the current window.location.hash and dispatch to the correct handler.
+	 *
+	 * Route patterns:
+	 *   #/Home                         -> showView('Docuserve-Splash')
+	 *   #/page/<docpath>               -> navigateToPage(docpath)
+	 *   #/doc/<group>/<module>          -> navigateToModule(group, module)
+	 *   #/doc/<group>/<module>/<path>   -> navigateToModulePath(group, module, path)
+	 */
+	resolveHash()
+	{
+		let tmpHash = (window.location.hash || '').replace(/^#\/?/, '');
+		if (!tmpHash || tmpHash === 'Home')
+		{
+			this.showView('Docuserve-Splash');
+			return;
+		}
+		let tmpParts = tmpHash.split('/');
+		if (tmpParts[0] === 'page' && tmpParts.length >= 2)
+		{
+			// Rejoin everything after 'page/' in case the path has slashes
+			let tmpDocPath = tmpParts.slice(1).join('/');
+			this.navigateToPage(tmpDocPath);
+			return;
+		}
+		if (tmpParts[0] === 'doc' && tmpParts.length >= 3)
+		{
+			let tmpGroup = tmpParts[1];
+			let tmpModule = tmpParts[2];
+			if (tmpParts.length >= 4)
+			{
+				let tmpPath = tmpParts.slice(3).join('/');
+				this.navigateToModulePath(tmpGroup, tmpModule, tmpPath);
+			}
+			else
+			{
+				this.navigateToModule(tmpGroup, tmpModule);
+			}
+			return;
+		}
+		// Unknown route — treat as a page
+		this.navigateToPage(tmpHash);
+	}
+	/**
+	 * Navigate to a hash route.
+	 *
+	 * Sets window.location.hash, which triggers the hashchange listener in the
+	 * layout view, which calls resolveHash() automatically.
+	 *
+	 * @param {string} pRoute - The route path (e.g. '/Home', '/page/quick-start')
+	 */
+	navigateTo(pRoute)
+	{
+		window.location.hash = pRoute;
+	}
+	/**
+	 * Show a specific view in the content area.
+	 *
+	 * @param {string} pViewIdentifier - The view identifier to render
+	 */
+	showView(pViewIdentifier)
+	{
+		if (pViewIdentifier in this.pict.views)
+		{
+			this.pict.AppData.Docuserve.CurrentGroup = '';
+			this.pict.AppData.Docuserve.CurrentModule = '';
+			this.pict.AppData.Docuserve.CurrentPath = '';
+			this.pict.views[pViewIdentifier].render();
+			// Update sidebar to clear module nav and refresh active states
+			this.pict.views['Docuserve-Sidebar'].clearModuleNav();
+			this.pict.views['Docuserve-Sidebar'].renderSidebarGroups();
+		}
+	}
+	/**
+	 * Navigate to a module's documentation.
+	 *
+	 * @param {string} pGroup - The group key
+	 * @param {string} pModule - The module name
+	 */
+	navigateToModule(pGroup, pModule)
+	{
+		this.navigateToModulePath(pGroup, pModule, 'README.md');
+	}
+	/**
+	 * Navigate to a specific path within a module's documentation.
+	 *
+	 * @param {string} pGroup - The group key
+	 * @param {string} pModule - The module name
+	 * @param {string} pPath - The document path
+	 */
+	navigateToModulePath(pGroup, pModule, pPath)
+	{
+		let tmpDocProvider = this.pict.providers['Docuserve-Documentation'];
+		let tmpContentView = this.pict.views['Docuserve-Content'];
+		let tmpSidebarView = this.pict.views['Docuserve-Sidebar'];
+		// Update current navigation state
+		this.pict.AppData.Docuserve.CurrentGroup = pGroup;
+		this.pict.AppData.Docuserve.CurrentModule = pModule;
+		this.pict.AppData.Docuserve.CurrentPath = pPath;
+		// Render the content view shell and show loading
+		tmpContentView.render();
+		tmpContentView.showLoading();
+		// Update sidebar to show active module and module-specific nav
+		tmpSidebarView.renderSidebarGroups();
+		tmpSidebarView.renderModuleNav(pGroup, pModule);
+		// Resolve the document URL and fetch it
+		let tmpURL = tmpDocProvider.resolveDocumentURL(pGroup, pModule, pPath || 'README.md');
+		if (!tmpURL)
+		{
+			tmpContentView.displayContent(tmpDocProvider.getErrorPageHTML(pGroup + '/' + pModule));
+			return;
+		}
+		tmpDocProvider.fetchDocument(tmpURL, (pError, pHTML) =>
+		{
+			// fetchDocument always provides displayable HTML in pHTML,
+			// even on error, so we can use it directly.
+			tmpContentView.displayContent(pHTML);
+		});
+	}
+	/**
+	 * Navigate to a local documentation page (e.g. architecture.md).
+	 *
+	 * @param {string} pDocPath - The doc path without extension
+	 */
+	navigateToPage(pDocPath)
+	{
+		let tmpDocProvider = this.pict.providers['Docuserve-Documentation'];
+		let tmpContentView = this.pict.views['Docuserve-Content'];
+		let tmpSidebarView = this.pict.views['Docuserve-Sidebar'];
+		// Update state
+		this.pict.AppData.Docuserve.CurrentGroup = '';
+		this.pict.AppData.Docuserve.CurrentModule = '';
+		this.pict.AppData.Docuserve.CurrentPath = pDocPath;
+		// Render the content view shell and show loading
+		tmpContentView.render();
+		tmpContentView.showLoading();
+		// Clear module-specific sidebar nav
+		tmpSidebarView.clearModuleNav();
+		tmpSidebarView.renderSidebarGroups();
+		// Fetch the local document
+		let tmpPath = pDocPath;
+		if (!tmpPath.match(/\.md$/))
+		{
+			tmpPath = tmpPath + '.md';
+		}
+		tmpDocProvider.fetchLocalDocument(tmpPath, (pError, pHTML) =>
+		{
+			// fetchDocument always provides displayable HTML in pHTML,
+			// even on error, so we can use it directly.
+			tmpContentView.displayContent(pHTML);
+		});
+	}
+}
+module.exports = DocuserveApplication;
+module.exports.default_configuration = require('./Pict-Application-Docuserve-Configuration.json');

package/source/cli/Docuserve-CLI-Program.js ADDED Viewed

@@ -0,0 +1,16 @@
+const libCLIProgram = require('pict-service-commandlineutility');
+let _PictCLIProgram = new libCLIProgram(
+	{
+		Product: 'pict-docuserve',
+		Version: require('../../package.json').version,
+		Command: 'pict-docuserve',
+		Description: 'Documentation viewer powered by Pict.  Serve or inject documentation assets for any markdown folder.'
+	},
+	[
+		require('./commands/Docuserve-Command-Serve.js'),
+		require('./commands/Docuserve-Command-Inject.js')
+	]);
+module.exports = _PictCLIProgram;

package/source/cli/Docuserve-CLI-Run.js ADDED Viewed

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+const libDocuserveProgram = require('./Docuserve-CLI-Program.js');
+libDocuserveProgram.run();

package/source/cli/commands/Docuserve-Command-Inject.js ADDED Viewed

@@ -0,0 +1,127 @@
+const libCommandLineCommand = require('pict-service-commandlineutility').ServiceCommandLineCommand;
+const libFS = require('fs');
+const libPath = require('path');
+/**
+ * Recursively create a directory if it does not exist.
+ */
+function ensureDir(pPath)
+{
+	if (!libFS.existsSync(pPath))
+	{
+		libFS.mkdirSync(pPath, { recursive: true });
+	}
+}
+/**
+ * Recursively copy a directory's contents into a destination.
+ */
+function copyDir(pSource, pDest)
+{
+	ensureDir(pDest);
+	let tmpEntries = libFS.readdirSync(pSource, { withFileTypes: true });
+	for (let i = 0; i < tmpEntries.length; i++)
+	{
+		let tmpEntry = tmpEntries[i];
+		let tmpSourcePath = libPath.join(pSource, tmpEntry.name);
+		let tmpDestPath = libPath.join(pDest, tmpEntry.name);
+		if (tmpEntry.isDirectory())
+		{
+			copyDir(tmpSourcePath, tmpDestPath);
+		}
+		else
+		{
+			libFS.copyFileSync(tmpSourcePath, tmpDestPath);
+		}
+	}
+}
+/**
+ * Copy a single file, creating parent directories as needed.
+ */
+function copyFile(pSource, pDest)
+{
+	ensureDir(libPath.dirname(pDest));
+	libFS.copyFileSync(pSource, pDest);
+}
+class DocuserveCommandInject extends libCommandLineCommand
+{
+	constructor(pFable, pManifest, pServiceHash)
+	{
+		super(pFable, pManifest, pServiceHash);
+		this.options.CommandKeyword = 'inject';
+		this.options.Description = 'Copy docuserve app assets into a docs folder for static hosting.';
+		this.options.CommandArguments.push({ Name: '<docs-path>', Description: 'Target documentation folder to inject assets into.' });
+		this.addCommand();
+	}
+	onRun()
+	{
+		let tmpDocsPath = libPath.resolve(this.ArgumentString || '.');
+		let tmpDistPath = libPath.resolve(__dirname, '..', '..', '..', 'dist');
+		if (!libFS.existsSync(tmpDocsPath))
+		{
+			this.log.error(`Target folder not found at ${tmpDocsPath}`);
+			process.exit(1);
+		}
+		if (!libFS.existsSync(tmpDistPath))
+		{
+			this.log.error(`dist/ folder not found at ${tmpDistPath}.  Run npm run build first.`);
+			process.exit(1);
+		}
+		this.log.info(`Injecting docuserve assets...`);
+		this.log.info(`  From: ${tmpDistPath}`);
+		this.log.info(`  Into: ${tmpDocsPath}`);
+		// Copy index.html
+		copyFile(
+			libPath.join(tmpDistPath, 'index.html'),
+			libPath.join(tmpDocsPath, 'index.html')
+		);
+		// Copy css/ folder
+		copyDir(
+			libPath.join(tmpDistPath, 'css'),
+			libPath.join(tmpDocsPath, 'css')
+		);
+		// Copy js/ folder (pict library)
+		copyDir(
+			libPath.join(tmpDistPath, 'js'),
+			libPath.join(tmpDocsPath, 'js')
+		);
+		// Copy all pict-docuserve bundle files (*.js and *.js.map)
+		let tmpDistEntries = libFS.readdirSync(tmpDistPath, { withFileTypes: true });
+		for (let i = 0; i < tmpDistEntries.length; i++)
+		{
+			let tmpEntry = tmpDistEntries[i];
+			if (tmpEntry.isFile() && tmpEntry.name.match(/^pict-docuserve\./))
+			{
+				copyFile(
+					libPath.join(tmpDistPath, tmpEntry.name),
+					libPath.join(tmpDocsPath, tmpEntry.name)
+				);
+			}
+		}
+		// Create .nojekyll for GitHub Pages compatibility
+		libFS.writeFileSync(libPath.join(tmpDocsPath, '.nojekyll'), '');
+		this.log.info('');
+		this.log.info('Injection complete!  The docs folder is now self-contained.');
+		this.log.info('Deploy to any static host (GitHub Pages, Netlify, etc.) or serve with any HTTP server.');
+		this.log.info('');
+	}
+}
+module.exports = DocuserveCommandInject;

package/source/cli/commands/Docuserve-Command-Serve.js ADDED Viewed

@@ -0,0 +1,135 @@
+const libCommandLineCommand = require('pict-service-commandlineutility').ServiceCommandLineCommand;
+const libHTTP = require('http');
+const libFS = require('fs');
+const libPath = require('path');
+const _MimeTypes = (
+	{
+		'.html': 'text/html',
+		'.js': 'text/javascript',
+		'.css': 'text/css',
+		'.json': 'application/json',
+		'.md': 'text/markdown',
+		'.map': 'application/json',
+		'.svg': 'image/svg+xml',
+		'.png': 'image/png',
+		'.jpg': 'image/jpeg',
+		'.jpeg': 'image/jpeg',
+		'.gif': 'image/gif',
+		'.ico': 'image/x-icon',
+		'.woff': 'font/woff',
+		'.woff2': 'font/woff2',
+		'.ttf': 'font/ttf',
+		'.eot': 'application/vnd.ms-fontobject',
+		'.txt': 'text/plain'
+	});
+/**
+ * Attempt to serve a file from the given path.
+ *
+ * @param {string} pFilePath - Absolute path to the file
+ * @param {object} pResponse - HTTP response object
+ * @param {function} fNotFound - Callback if the file does not exist
+ */
+function serveFile(pFilePath, pResponse, fNotFound)
+{
+	libFS.stat(pFilePath, (pError, pStats) =>
+	{
+		if (pError || !pStats.isFile())
+		{
+			return fNotFound();
+		}
+		let tmpExt = libPath.extname(pFilePath).toLowerCase();
+		let tmpContentType = _MimeTypes[tmpExt] || 'application/octet-stream';
+		pResponse.writeHead(200, { 'Content-Type': tmpContentType });
+		let tmpStream = libFS.createReadStream(pFilePath);
+		tmpStream.pipe(pResponse);
+	});
+}
+class DocuserveCommandServe extends libCommandLineCommand
+{
+	constructor(pFable, pManifest, pServiceHash)
+	{
+		super(pFable, pManifest, pServiceHash);
+		this.options.CommandKeyword = 'serve';
+		this.options.Description = 'Start a local HTTP server for a documentation folder.';
+		this.options.CommandArguments.push({ Name: '<docs-path>', Description: 'Path to the documentation folder containing markdown files.' });
+		this.options.CommandOptions.push({ Name: '-p, --port [port]', Description: 'Port to serve on.', Default: '3333' });
+		this.addCommand();
+	}
+	onRun()
+	{
+		let tmpDocsPath = libPath.resolve(this.ArgumentString || '.');
+		let tmpDistPath = libPath.resolve(__dirname, '..', '..', '..', 'dist');
+		let tmpPort = parseInt(this.CommandOptions.port, 10) || 3333;
+		if (!libFS.existsSync(tmpDocsPath))
+		{
+			this.log.error(`Docs folder not found at ${tmpDocsPath}`);
+			process.exit(1);
+		}
+		if (!libFS.existsSync(tmpDistPath))
+		{
+			this.log.error(`dist/ folder not found at ${tmpDistPath}.  Run npm run build first.`);
+			process.exit(1);
+		}
+		let tmpServer = libHTTP.createServer((pRequest, pResponse) =>
+		{
+			let tmpURLPath = pRequest.url.split('?')[0];
+			tmpURLPath = decodeURIComponent(tmpURLPath);
+			// Reject path traversal attempts
+			if (tmpURLPath.indexOf('..') >= 0)
+			{
+				pResponse.writeHead(403, { 'Content-Type': 'text/plain' });
+				pResponse.end('Forbidden');
+				return;
+			}
+			// Rewrite root to index.html
+			if (tmpURLPath === '/')
+			{
+				tmpURLPath = '/index.html';
+			}
+			let tmpDocsFilePath = libPath.join(tmpDocsPath, tmpURLPath);
+			let tmpDistFilePath = libPath.join(tmpDistPath, tmpURLPath);
+			// Overlay: try the docs folder first, fall back to dist/
+			serveFile(tmpDocsFilePath, pResponse, () =>
+			{
+				serveFile(tmpDistFilePath, pResponse, () =>
+				{
+					pResponse.writeHead(404, { 'Content-Type': 'text/plain' });
+					pResponse.end('Not Found');
+				});
+			});
+		});
+		tmpServer.listen(tmpPort, '127.0.0.1', () =>
+		{
+			this.log.info('');
+			this.log.info(`pict-docuserve is running!`);
+			this.log.info('');
+			this.log.info(`  Local:   http://127.0.0.1:${tmpPort}`);
+			this.log.info(`  Docs:    ${tmpDocsPath}`);
+			this.log.info(`  Assets:  ${tmpDistPath}`);
+			this.log.info('');
+			this.log.info('  Press Ctrl+C to stop.');
+			this.log.info('');
+		});
+	}
+}
+module.exports = DocuserveCommandServe;