visualvault-api 1.1.0 → 2.0.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 VisualVault
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,7 @@
 # visualvault-api
 
+![Stability: Beta](https://img.shields.io/badge/stability-beta-yellow.svg)
+
 A Node.js client library that provides convenient access to the VisualVault REST API for server-side applications.
 
 ## Installation
@@ -17,6 +19,10 @@ npm install visualvault-api
 ### Basic Authentication and Setup
 
 ```javascript
+// ES Modules (recommended)
+import vvRestApi from 'visualvault-api';
+
+// CommonJS
 const vvRestApi = require('visualvault-api');
 
 // Initialize authentication
@@ -60,150 +66,20 @@ auth.getVaultApiFromJwt(
 });
 ```
 
-## API Usage Examples
-
-### Working with Documents
-
-```javascript
-// Get documents from a folder
-client.library.getDocuments(params, folderId)
-    .then(response => {
-        const documents = JSON.parse(response);
-        console.log('Documents:', documents.data);
-    });
-
-// Upload a new document
-const documentData = {
-    fileName: 'example.pdf',
-    description: 'Example document',
-    folderId: 'your-folder-id'
-};
+## API Usage
 
-client.documents.postDocWithFile(documentData, fileBuffer)
-    .then(response => {
-        console.log('Document uploaded:', response);
-    });
-
-// Get document details
-client.documents.getDocumentRevision(params, revisionId)
-    .then(response => {
-        const document = JSON.parse(response);
-        console.log('Document details:', document);
-    });
-```
-
-### Working with Forms
+Once authenticated, the client provides access to various API modules. All methods return Promises.
 
 ```javascript
-// Get forms by template name
+// Example: Get forms by template name
 client.forms.getForms(params, 'Your Form Template Name')
     .then(response => {
         const forms = JSON.parse(response);
         console.log('Forms:', forms.data);
     });
 
-// Create a new form instance
-const formData = {
-    field1: 'value1',
-    field2: 'value2'
-};
-
-client.forms.postForms(params, formData, 'Your Form Template Name')
-    .then(response => {
-        console.log('Form created:', response);
-    });
-
-// Get form instance by ID
-client.forms.getFormInstanceById(templateId, instanceId)
-    .then(response => {
-        const form = JSON.parse(response);
-        console.log('Form instance:', form);
-    });
-```
-
-### Working with Folders
-
-```javascript
-// Get folders
-client.library.getFolders(params)
-    .then(response => {
-        const folders = JSON.parse(response);
-        console.log('Folders:', folders.data);
-    });
-
-// Create a new folder
-const folderData = {
-    name: 'New Folder',
-    description: 'Folder description'
-};
-
-client.library.postFolderByPath(params, folderData, '/Parent Folder/New Folder')
-    .then(response => {
-        console.log('Folder created:', response);
-    });
-```
-
-### Working with Users
-
-```javascript
-// Get current user information
-client.users.getUser(params)
-    .then(response => {
-        const user = JSON.parse(response);
-        console.log('Current user:', user);
-    });
-
-// Get users in a site
-client.users.getUsers(params, siteId)
-    .then(response => {
-        const users = JSON.parse(response);
-        console.log('Users:', users.data);
-    });
-```
-
-### Running Custom Queries
-
-```javascript
-// Execute a custom query by name
-client.customQuery.getCustomQueryResultsByName('Your Query Name', params)
-    .then(response => {
-        const results = JSON.parse(response);
-        console.log('Query results:', results.data);
-    });
-```
-
-### Working with Files
-
-```javascript
-// Upload a file
-const fileData = {
-    fileName: 'document.pdf',
-    description: 'My document'
-};
-
-client.files.postFile(fileData, fileBuffer)
-    .then(response => {
-        console.log('File uploaded:', response);
-    });
-
-// Download a file
-client.files.getFileBytesId(fileId)
-    .then(fileBuffer => {
-        // Process the file buffer
-        console.log('File downloaded, size:', fileBuffer.length);
-    });
-```
-
-### Running Web Services
-
-```javascript
-// Execute a web service
-const serviceData = {
-    param1: 'value1',
-    param2: 'value2'
-};
-
-client.scripts.runWebService('YourWebServiceName', serviceData)
+// Example: Execute a web service
+client.scripts.runWebService('YourWebServiceName', { param1: 'value1' })
     .then(response => {
         console.log('Web service result:', response);
     });
@@ -232,6 +108,15 @@ The client provides access to the following VisualVault API modules:
 - **securityMembers** - Security member management
 - **reports** - Report generation
 
+## Extended API Modules
+
+When enabled, the following additional API modules are available:
+
+- **docApi** - Enhanced document operations
+- **formsApi** - Enhanced forms operations
+- **objectsApi** - Object model operations
+- **studioApi** - Workflow and studio operations
+- **notificationsApi** - Real-time notifications
 
 ## Error Handling
 
@@ -256,8 +141,8 @@ For more information about the VisualVault API, visit the [VisualVault documenta
 
 ## License
 
-Use of the VisualVault API requires a customer hosting contract which defines all license terms.
+This project is licensed under the [MIT License](LICENSE).
 
-## Repository
+## Contributing
 
-[GitHub Repository](https://github.com/VisualVault/nodeJs-rest-client-library)
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.