docpouch-client 0.8.14 → 0.8.15

package/README.md

@@ -81,35 +81,44 @@ await client.removeUser('user-id');
 ```typescript
 // Create a new document
 const newDocument = await client.createDocument({
+    _id: 'document-id',
+    owner: 'user-id',
+    title: 'Mission Statement',
     type: 17,
     subType: 11,
-    title: "Mission Statement",
-    content: "{\"msg\": \"We strive for a world that...\"}",
+    content: '{"msg": "We strive for a world that..."}',
     shareWithGroup: false,
     shareWithDepartment: false
 });
 
 // Update a document
 await client.updateDocument('document-id', {
+    _id: 'document-id',
+    owner: 'user-id',
     title: 'Updated Mission Statement',
-    content: '{"msg": "Our updated mission..."}'
+    type: 17,
+    subType: 11,
+    content: '{"msg": "Our updated mission..."}',
+    shareWithGroup: false,
+    shareWithDepartment: false
 });
 
 // Delete a document
-await client.deleteDocument('document-id');
+await client.removeDocument('document-id');
+
+// List all documents
+const allDocuments = await client.listDocuments();
 
 // Fetch documents by query
-const documents = await client.fetchDocuments([
-    {type: 17, subType: 11}
-]);
+const documents = await client.fetchDocuments({type: 17, subType: 11});
 ```
 
 ### Data Structure Management
 
 ```typescript
 // Create a new data structure
-const newStructure = await client.createDataStructure({
-    title: "Data resulting from Vision-Mission-Value-Canvas",
+const newStructure = await client.createStructure({
+    name: "Data resulting from Vision-Mission-Value-Canvas",
     fields: [
         {
             name: "Mission value statement",
@@ -120,28 +129,30 @@ const newStructure = await client.createDataStructure({
 });
 
 // Update a data structure
-await client.updateDataStructure('structure-id', {
-    title: 'Updated Structure Title',
+await client.updateStructure('structure-id', {
+    _id: 'structure-id',
+    name: 'Updated Structure Title',
+    description: 'Updated structure description',
     fields: [
         {name: 'New Field Name', type: 'number'}
     ]
 });
 
 // Delete a data structure
-await client.deleteDataStructure('structure-id');
+await client.removeStructure('structure-id');
 
 // List all data structures
-const structures = await client.listDataStructures();
+const structures = await client.getStructures();
 ```
 
 ### Document Type Management
 
 ```typescript
 // List all document types
-const docTypes = await client.listDocumentTypes();
+const docTypes = await client.getTypes();
 
-// Create or update a document type
-const newDocType = await client.createOrUpdateDocumentType({
+// Create a new document type
+const newDocType = await client.createType({
     name: "HR Wages",
     description: "HR Wage information Document listing wages per personnel ID",
     type: 14,
@@ -149,8 +160,16 @@ const newDocType = await client.createOrUpdateDocumentType({
     defaultStructureID: 'structure-id'
 });
 
+// Update a document type
+await client.updateType({
+    _id: 'doc-type-id',
+    name: 'Updated HR Wages',
+    type: 14,
+    subType: 2
+});
+
 // Delete a document type
-await client.deleteDocumentType('doc-type-id');
+await client.removeType('doc-type-id');
 ```
 
 ## API Reference
@@ -159,147 +178,272 @@ await client.deleteDocumentType('doc-type-id');
 
 #### Constructor
 
-- `new docPouchClient(baseUrl: string, port: number, callback?: (event: string, data: any) => void)`
+- `new docPouchClient(host: string, port?: number, callback?: (event: I_EventString, data: I_WsMessage) => void)`
 
 #### Methods
 
-- `login(credentials: { name: string, password: string }): Promise<{ token: string } | null>`
-- `setToken(token: string): void`
-- `listUsers(): Promise<UserDisplay[]>`
-- `createUser(userData: UserCreation): Promise<UserDisplay>`
-- `updateUser(id: string, userData: UserUpdate): Promise<void>`
-- `removeUser(id: string): Promise<void>`
-- `createDocument(docData: NewDocument): Promise<Document>`
-- `updateDocument(id: string, docData: Partial<Document>): Promise<void>`
-- `deleteDocument(id: string): Promise<void>`
-- `fetchDocuments(query: DocumentQuery[]): Promise<Document[]>`
-- `createDataStructure(structureData: DataStructureCreation): Promise<DataStructure>`
-- `updateDataStructure(id: string, structureData: Partial<DataStructure>): Promise<void>`
-- `deleteDataStructure(id: string): Promise<void>`
-- `listDataStructures(): Promise<DataStructure[]>`
-- `listDocumentTypes(): Promise<DocumentTypeEdit[]>`
-- `createOrUpdateDocumentType(typeData: DocumentTypeEdit): Promise<void>`
-- `deleteDocumentType(id: string): Promise<void>`
+- `setRealTimeSync(newRealTimeSync: boolean): void`
+- `login(credentials: I_UserLogin): Promise<I_LoginResponse | null>`
+- `listUsers(): Promise<I_UserEntry[]>`
+- `updateUser(userID: string, userData: I_UserUpdate): Promise<void>`
+- `createUser(userData: I_UserCreation): Promise<I_UserDisplay>`
+- `removeUser(userID: string): Promise<void>`
+- `createDocument(document: I_DocumentEntry): Promise<I_DocumentEntry>`
+- `listDocuments(): Promise<I_DocumentEntry[]>`
+- `fetchDocuments(queryObject: I_DocumentQuery): Promise<I_DocumentEntry[]>`
+- `updateDocument(documentID: string, documentData: I_DocumentEntry): Promise<void>`
+- `removeDocument(documentID: string): Promise<void>`
+- `createStructure(structure: I_StructureCreation): Promise<I_DataStructure>`
+- `getStructures(): Promise<I_DataStructure[]>`
+- `updateStructure(structureID: string, structureData: I_DataStructure): Promise<void>`
+- `removeStructure(structureID: string): Promise<void>`
+- `createType(type: I_DocumentType): Promise<I_DocumentType>`
+- `removeType(typeID: string): Promise<void>`
+- `getTypes(): Promise<I_DocumentType[]>`
+- `updateType(updatedType: I_DocumentType): Promise<void>`
+- `setToken(token: string | null): void`
+- `getVersion(): string`
+- `debugSocketConnection(): void`
 
 ## Types
 
-### UserDisplay
+### I_UserEntry
 
 ```typescript
 {
-    _id: number;
+    _id: string;
     name: string;
-    email ? : string;
+    password: string;
+    email?: string;
     department: string;
     group: string;
+    isAdmin: boolean;
 }
 ```
 
-### UserCreation
+### I_UserLogin
 
 ```typescript
 {
     name: string;
     password: string;
-    email ? : string;
+}
+```
+
+### I_UserDisplay
+
+```typescript
+{
+    _id: string;
+    username: string;
+    department: string;
+    group: string;
+    email?: string;
+}
+```
+
+### I_UserCreation
+
+```typescript
+{
+    name: string;
+    password: string;
+    email?: string;
     department: string;
     group: string;
     isAdmin: boolean;
 }
 ```
 
-### UserUpdate
+### I_UserUpdate
+
+```typescript
+{
+    _id?: string;
+    name?: string;
+    password?: string;
+    email?: string;
+    department?: string;
+    group?: string;
+    isAdmin?: boolean;
+}
+```
+
+### I_LoginResponse
 
 ```typescript
 {
-    name ? : string;
-    password ? : string;
-    email ? : string;
-    isAdmin ? : boolean;
-    department ? : string;
-    group ? : string;
+    token: string;
+    isAdmin: boolean;
+    userName: string;
 }
 ```
 
-### Document
+### I_DocumentEntry
 
 ```typescript
 {
     _id: string;
+    owner: string;
+    title: string;
+    description?: string;
     type: number;
     subType: number;
-    title: string;
-    content: string;
+    content: any;
     shareWithGroup: boolean;
     shareWithDepartment: boolean;
 }
 ```
 
-### NewDocument
+### I_DocumentCreation
 
 ```typescript
 {
+    title: string;
+    description?: string;
     type: number;
     subType: number;
+    content: any;
+    shareWithGroup: boolean;
+    shareWithDepartment: boolean;
+}
+```
+
+### I_DocumentCreationOwned
+
+```typescript
+{
+    owner: string;
     title: string;
-    content: string;
+    description?: string;
+    type: number;
+    subType: number;
+    content: any;
     shareWithGroup: boolean;
     shareWithDepartment: boolean;
 }
 ```
 
-### DocumentQuery
+### I_DocumentUpdate
 
 ```typescript
 {
-    _id ? : string;
-    type ? : number;
-    subType ? : number;
-    title ? : string;
-    description ? : string;
-    shareWithGroup ? : boolean;
-    shareWithDepartment ? : boolean;
+    _id?: string;
+    owner?: string;
+    title?: string;
+    type?: number;
+    subType?: number;
+    shareWithGroup?: boolean;
+    shareWithDepartment?: boolean;
+    content?: any;
+    description?: string;
 }
 ```
 
-### DataStructure
+### I_DocumentQuery
 
 ```typescript
 {
-    _id: number;
-    title: string;
-    fields: DataField[];
+    _id?: string;
+    owner?: string;
+    title?: string;
+    type?: number;
+    subType?: number;
+    shareWithGroup?: boolean;
+    shareWithDepartment?: boolean;
 }
 ```
 
-### DataStructureCreation
+### I_DataStructure
 
 ```typescript
 {
-    title: string;
-    fields: DataField[];
+    _id?: string;
+    name: string;
+    description: string;
+    fields: I_StructureField[];
+}
+```
+
+### I_StructureCreation
+
+```typescript
+{
+    name: string;
+    description?: string;
+    fields: I_StructureField[];
+}
+```
+
+### I_StructureUpdate
+
+```typescript
+{
+    _id?: string;
+    name?: string;
+    description?: string;
+    fields?: I_StructureField[];
+}
+```
+
+### I_StructureField
+
+```typescript
+{
+    name: string;
+    type: string;
+    items?: string;
 }
 ```
 
-### DataField
+### I_StructureEntry
 
 ```typescript
 {
+    _id?: string;
     name: string;
-    type: 'number' | 'string' | 'boolean' | 'array' | 'structure';
-    items ? : string; // For array and structure types
+    description: string;
+    fields: I_StructureField[];
 }
 ```
 
-### DocumentTypeEdit
+### I_DocumentType
 
 ```typescript
 {
-    _id ? : string;
+    _id?: string;
     name: string;
-    description ? : string;
+    description?: string;
     type: number;
     subType: number;
-    defaultStructureID ? : string;
+    defaultStructureID?: string;
+}
+```
+
+### I_EventString
+
+```typescript
+'heartbeatPong' | 'heartbeatPing' | 'newDocument' | 'newStructure' |
+'newUser' | 'newType' | 'removedID' | 'changedDocument' |
+'changedStructure' | 'changedUser' | 'changedType' | 'removedUser' |
+'removedStructure' | 'removedDocument' | 'removedType'
+```
+
+### I_WsMessage
+
+```typescript
+{
+    newDocument?: I_DocumentEntry;
+    newStructure?: I_StructureEntry;
+    newUser?: I_UserEntry;
+    removedID?: string;
+    changedDocument?: I_DocumentUpdate;
+    changedStructure?: I_StructureUpdate;
+    changedUser?: I_UserUpdate;
+    confirmSubscription?: boolean;
+    confirmUnsubscription?: boolean;
+    heartbeatPing?: number;
+    heartbeatPong?: number;
+    newType?: I_DocumentType;
 }
 ```

package/package.json

@@ -1,38 +1,38 @@
-{
-  "name": "docpouch-client",
-  "version": "0.8.14",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
-    }
-  },
-  "type": "module",
-  "scripts": {
-    "build": "tsc",
-    "test": "jest"
-  },
-  "keywords": [
-    "docPouch",
-    "API"
-  ],
-  "author": "Jan Frecè",
-  "license": "MIT",
-  "description": "A small class to more easily access the docPouch API",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/BFH-JTF/docpouch-client"
-  },
-  "devDependencies": {
-    "@types/jest": "^30.0.0",
-    "@types/node": "^24.3.0",
-    "jest": "^30.0.5",
-    "ts-jest": "^29.4.1",
-    "typescript": "^5.9.2"
-  },
-  "dependencies": {
-    "socket.io-client": "^4.8.1"
-  }
-}
+{
+  "name": "docpouch-client",
+  "version": "0.8.15",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest"
+  },
+  "keywords": [
+    "docPouch",
+    "API"
+  ],
+  "author": "Jan Frecè",
+  "license": "MIT",
+  "description": "A small class to more easily access the docPouch API",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BFH-JTF/docpouch-client"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.3.0",
+    "jest": "^30.0.5",
+    "ts-jest": "^29.4.1",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "socket.io-client": "^4.8.1"
+  }
+}