beanbagdb 0.8.6 → 0.8.8

package/doc-src/contents.json

@@ -1,15 +1,12 @@
 {
-  "0_about": {
-    "title": "About BeanBagDB"
-  },
-  "1_getting-started": {
+  "getting-started": {
     "title": "Getting Started"
   },
-  "2_schema": {
+  "schema": {
     "title": "How to create a schema?"
   },
 
-  "3_plugins": {
+  "plugins": {
     "title": "How to use plugins?"
   }
 }

package/doc-src/custom-dark.css

@@ -0,0 +1,218 @@
+/* Docdash Dark Theme - Semantic Color System */
+* { box-sizing: border-box; }
+
+:root {
+  /* Core */
+  --color-bg-primary: #0f1117;
+  --color-bg-secondary: #171e2d;
+  --color-bg-card: #1a1f2a;
+  --color-text-primary: #e2e8f0;
+  --color-text-secondary: #a1a8c0;
+  
+  /* Accents */
+  --color-primary: #3b82f6;
+  --color-primary-hover: #2563eb;
+  --color-accent: #a855f7;
+  --color-accent-hover: #9333ea;
+  
+  /* Neutrals */
+  --color-border: #334155;
+  --color-border-light: #475569;
+  --color-surface: #1e293b;
+  
+  /* UI */
+  --color-code-bg: #0f172a;
+  --color-code-fg: #f1f5f9;
+  --color-nav-bg: #111827;
+  --color-nav-fg: #d1d5db;
+  --color-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.4);
+}
+
+html, body {
+  height: 100%;
+  width: 100%;
+  background-color: var(--color-bg-primary) !important;
+  color: var(--color-text-primary) !important;
+}
+
+body {
+  margin: 0 auto;
+  padding: 0 20px;
+  font-family: 'Helvetica Neue', Helvetica, sans-serif;
+  font-size: 16px;
+}
+
+img { max-width: 100%; }
+
+a, a:active {
+  color: var(--color-primary) !important;
+  text-decoration: none;
+}
+
+a:hover {
+  color: var(--color-primary-hover) !important;
+}
+
+article a {
+  border-bottom: 1px solid var(--color-border-light) !important;
+}
+
+article a:hover, article a:active {
+  border-bottom-color: var(--color-primary) !important;
+}
+
+h1, h2, h3, h4, h5, h6 {
+  color: var(--color-text-primary) !important;
+  font-weight: 400;
+  margin: 0;
+}
+
+h1 {
+  font-weight: 300;
+  font-size: 48px;
+  margin: 1em 0 0.5em;
+}
+
+h1.page-title {
+  font-size: 48px;
+  margin: 1em 30px;
+  line-height: 100%;
+  word-wrap: break-word;
+}
+
+h2 { font-size: 24px; margin: 1.5em 0 0.3em; }
+h3 { font-size: 24px; margin: 1.2em 0 0.3em; }
+h4 { font-size: 18px; margin: 1em 0 0.2em; color: var(--color-text-secondary) !important; }
+
+h4.name {
+  color: #fff !important;
+  background: var(--color-primary) !important;
+  box-shadow: var(--color-shadow) !important;
+  border-top: 1px solid var(--color-border-light) !important;
+  border-bottom: 1px solid var(--color-border-light) !important;
+  margin: 1.5em 0 0.5em;
+  padding: 0.75em 0 0.75em 10px;
+}
+
+h4.name a { color: #fff !important; }
+h4.name a:hover { border-bottom-color: var(--color-accent-hover) !important; }
+
+.usertext h1 { font-size: 24px; margin: 2.5em 0 1em; }
+.usertext h2 { font-size: 18px; margin: 2em 0 0.5em; }
+.usertext h3 { font-size: 15px; margin: 1.5em 0 0; }
+.usertext h5, .usertext h6 { color: var(--color-text-secondary) !important; }
+
+tt, code, kbd, samp, pre {
+  font-family: Consolas, Monaco, 'Andale Mono', monospace;
+  background: var(--color-code-bg) !important;
+  color: var(--color-code-fg) !important;
+}
+
+tt, code, kbd, samp { padding: 1px 5px; }
+pre { padding-bottom: 1em; }
+
+#main { float: right; width: calc(100% - 240px); }
+
+section {
+  background-color: var(--color-bg-card) !important;
+  padding: 0 0 0 30px;
+}
+
+nav {
+  float: left;
+  display: block;
+  width: 250px;
+  background: var(--color-nav-bg) !important;
+  overflow: auto;
+  position: fixed;
+  height: 100%;
+}
+
+nav h3 {
+  color: var(--color-text-primary) !important;
+}
+
+nav ul a, nav ul a:active {
+  color: var(--color-nav-fg) !important;
+}
+
+nav a:hover, nav a:active {
+  color: var(--color-primary) !important;
+}
+
+nav ul ul a {
+  color: var(--color-text-secondary) !important;
+  border-left: 1px solid var(--color-border) !important;
+}
+
+nav ul ul a, nav ul ul a:active { padding-left: 20px; }
+
+footer {
+  color: var(--color-text-secondary) !important;
+  margin-left: 250px;
+  padding: 15px;
+  font-style: italic;
+  font-size: 90%;
+}
+
+.signature {
+  color: var(--color-text-primary) !important;
+}
+
+.prettyprint.source, .prettyprint code {
+  background-color: var(--color-code-bg) !important;
+  color: var(--color-code-fg) !important;
+}
+
+.prettyprint.linenums li {
+  border-left: 3px solid var(--color-primary) !important;
+}
+
+.prettyprint.linenums li.selected, .prettyprint.linenums li.selected * {
+  background-color: rgba(59, 130, 246, 0.2) !important;
+}
+
+table {
+  border: 1px solid var(--color-border) !important;
+  box-shadow: var(--color-shadow) !important;
+  background-color: var(--color-bg-card) !important;
+  border-collapse: collapse;
+}
+
+thead tr {
+  background-color: var(--color-surface) !important;
+  border-bottom: 1px solid var(--color-border) !important;
+}
+
+td, th {
+  border-top: 1px solid var(--color-border-light) !important;
+  color: var(--color-text-primary) !important;
+}
+
+.params td {
+  border-top-color: rgba(51, 65, 85, 0.5) !important;
+}
+
+.navicon, .navicon:before, .navicon:after {
+  background: var(--color-text-primary) !important;
+}
+
+.nav-trigger:checked + label.plus .navicon:before,
+.nav-trigger:checked + label.x .navicon:before,
+.nav-trigger:checked + label.plus .navicon:after,
+.nav-trigger:checked + label.x .navicon:after {
+  background: #fff !important;
+}
+
+.overlay {
+  background: rgba(0,0,0,0.5) !important;
+}
+
+/* Responsive */
+@media only screen and (max-width: 680px) {
+  nav {
+    left: -250px;
+    transition: left 0.2s;
+  }
+  footer { margin-left: 0; }
+}

package/doc-src/{1_getting-started.md → getting-started.md}

@@ -1,6 +1,3 @@
-# Getting started
-
-
 
 ### Nodes and edges
 

package/doc-src/{3_plugins.md → plugins.md}

@@ -1,4 +1,4 @@
-# How to use plugins
+to use a plugin: 
 
 ```
 // MyPlugin.js

package/doc-src/schema.md

@@ -0,0 +1 @@
+Adding a new schema

package/index.md

@@ -1 +1,115 @@
-This is where i write the documentation 
+## The Database architecture
+A BeanbagDB is a collection of JSON documents. In a NoSQL database, documents don't need to follow a specific schema. Typically, the developer defines a schema based on the specific problem the app is intended to solve. 
+
+While, BeanBagDB allows users to create their own schemas for documents, all document internally share a consistent structure that accommodates the user defined schema. 
+
+Each document in the database follows this structure :
+```
+{
+  _id, _rev
+  data : {
+    user data
+  },
+  schema: "name_of_the_schema",
+  meta : {},
+}
+```
+
+Here, the `data` object contains user's information, while the `schema` defines it's associated structure. The `meta` field holds metadata such as creation and last updated on date and user defined tags. 
+
+Even schema documents follow this structure. 
+
+### Examples : 
+
+A system defined schema :
+```
+{ 
+  schema:"schema"
+  data : {
+    name: "system_tags",
+    .....
+  },
+  ...
+}
+```
+(In this example, the schema of this doc is `schema` because it stores the schema document, which will be use to validate documents that follows this schema)
+
+The document adhering to this schema might look like : 
+```
+{
+  schema:"system_tags",
+  data:{
+    tags:["tag1","tag2"]
+  }
+  ....
+}
+```
+User Defined schemas :
+```
+{
+  "schema":"schema",
+  "data":{
+    "name":"contacts",
+    ...
+  }
+}
+```
+And a sample document based on this user defined schema might look like :
+```
+{
+  schema:"contacts",
+  "data":{
+    "name":"Human 1",
+    "email":"human@on.earth"
+  }
+}
+```
+
+### System defined schemas 
+To ensure the system functions smoothly, each DB is initialized with a set of system defined schemas and seed documents. These are automatically added when the database is first created. These system defined are typically named with the prefix `system_`.
+
+List of system schemas :
+- `logs` : to log system and user actions 
+- `settings` : System level settings  (`name`,`value`,`json` for more details)
+- `keys` :  user level settings , these are encrypted and stored in the DB 
+- `secrets` : encrypted text (TODO)
+- `relations` : To create a network of relations  (TODO)
+- `index` :  (TODO)
+- `scripts` :  (TODO)
+
+## The BeanBagDB class
+
+The `BeanBagDB` class  contains the the logical part of how to interact with a local database. However, it does not itself makes any changes in the database. To make it (somewhat) compatible with multiple databases (e.g. CouchDB on the server, PouchDB in the browser), the class takes an db_instance object where the actual CRUD actions on the database can be performed. 
+
+To add support for a database, we extend the `BeanBagDB` class. 
+
+
+## JSON Schema (in progress)
+[Source](https://json-schema.org/) and [another](https://www.learnjsonschema.com/2020-12/)
+
+### Basic schema structure 
+```
+{
+  "name":"",
+  "description":"",
+  "properties":{
+
+  },
+  "settings":{
+
+  }
+}
+```
+#### Properties:
+- Settings :
+  - `additionalProperties:true`
+  - `required:[]`
+  - 
+- Defining custom fields :
+  - `type:""` Valid values: ``
+
+
+#### Settings :
+- `primary_key:[]` 
+- `editable_fields:[]`
+- `single_record : true` 

package/jsdoc.json

@@ -8,14 +8,26 @@
     "destination": "./docs-static",  
     "recurse": true,
     "readme":"./index.md",
-    "tutorials": "./doc-src"
+    "tutorials": "./doc-src",
+    "template": "node_modules/docdash"
   },
   "plugins": [
     "plugins/markdown"  
   ],
   "templates": {
     "default": {
-      "outputSourceFiles": false
+      "outputSourceFiles": false,
+      "staticFiles": {
+        "include": ["./doc-src/custom-dark.css"]
+      }
     }
+  },
+   "markdown": {
+    "idInHeadings": true
+  },
+  "docdash":{
+    "sort":false,
+    "search":false,
+    "scripts":["custom-dark.css"]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "beanbagdb",
-  "version": "0.8.6",
+  "version": "0.8.8",
   "description": "A JS library to introduce a schema layer to a No-SQL local database",
   "main": "src/index.js",
   "module": "src/index.js",
@@ -30,6 +30,7 @@
     "ajv": "^8.17.1",
     "chai": "^5.1.1",
     "chai-as-promised": "^8.0.0",
+    "docdash": "^2.0.2",
     "dotenv": "^16.4.5",
     "jsdoc": "^4.0.3",
     "mocha": "^10.7.3",

package/src/index.js

@@ -836,6 +836,20 @@ export class BeanBagDB {
       editable_meta_schema: async (criteria)=>{
         let e = sys_sch.editable_metadata_schema
         return e
+      },
+      related_doc: async (criteria) =>{
+        // criteria can be link or id
+        let get_doc = await this.read(criteria)
+        if(get_doc.doc){
+            let node = get_doc.doc._id 
+            let data = await this.search({selector:{
+              "schema":"system_edge",
+              "$or":[ {'data.node1':{"$in":node}},{'data.node2':{"$in":node}}]
+            },fields:["_id","meta","schema"]})
+            return data
+        }else{
+          throw new ValidationError("Doc not found")
+        }
       }
     }
     if(!input.type){throw new ValidationError("No type provided. Must be: "+Object.keys(fetch_docs).join(","))}

package/doc-src/0_about.md

@@ -1,115 +0,0 @@
-## The Database architecture
-A BeanbagDB is a collection of JSON documents. In a NoSQL database, documents don't need to follow a specific schema. Typically, the developer defines a schema based on the specific problem the app is intended to solve. 
-
-While, BeanBagDB allows users to create their own schemas for documents, all document internally share a consistent structure that accommodates the user defined schema. 
-
-Each document in the database follows this structure :
-```
-{
-  _id, _rev
-  data : {
-    user data
-  },
-  schema: "name_of_the_schema",
-  meta : {},
-}
-```
-
-Here, the `data` object contains user's information, while the `schema` defines it's associated structure. The `meta` field holds metadata such as creation and last updated on date and user defined tags. 
-
-Even schema documents follow this structure. 
-
-### Examples : 
-
-A system defined schema :
-```
-{ 
-  schema:"schema"
-  data : {
-    name: "system_tags",
-    .....
-  },
-  ...
-}
-```
-(In this example, the schema of this doc is `schema` because it stores the schema document, which will be use to validate documents that follows this schema)
-
-The document adhering to this schema might look like : 
-```
-{
-  schema:"system_tags",
-  data:{
-    tags:["tag1","tag2"]
-  }
-  ....
-}
-```
-User Defined schemas :
-```
-{
-  "schema":"schema",
-  "data":{
-    "name":"contacts",
-    ...
-  }
-}
-```
-And a sample document based on this user defined schema might look like :
-```
-{
-  schema:"contacts",
-  "data":{
-    "name":"Human 1",
-    "email":"human@on.earth"
-  }
-}
-```
-
-### System defined schemas 
-To ensure the system functions smoothly, each DB is initialized with a set of system defined schemas and seed documents. These are automatically added when the database is first created. These system defined are typically named with the prefix `system_`.
-
-List of system schemas :
-- `logs` : to log system and user actions 
-- `settings` : System level settings  (`name`,`value`,`json` for more details)
-- `keys` :  user level settings , these are encrypted and stored in the DB 
-- `secrets` : encrypted text (TODO)
-- `relations` : To create a network of relations  (TODO)
-- `index` :  (TODO)
-- `scripts` :  (TODO)
-
-## The BeanBagDB class
-
-The `BeanBagDB` class  contains the the logical part of how to interact with a local database. However, it does not itself makes any changes in the database. To make it (somewhat) compatible with multiple databases (e.g. CouchDB on the server, PouchDB in the browser), the class takes an db_instance object where the actual CRUD actions on the database can be performed. 
-
-To add support for a database, we extend the `BeanBagDB` class. 
-
-
-## JSON Schema (in progress)
-[Source](https://json-schema.org/) and [another](https://www.learnjsonschema.com/2020-12/)
-
-### Basic schema structure 
-```
-{
-  "name":"",
-  "description":"",
-  "properties":{
-
-  },
-  "settings":{
-
-  }
-}
-```
-#### Properties:
-- Settings :
-  - `additionalProperties:true`
-  - `required:[]`
-  - 
-- Defining custom fields :
-  - `type:""` Valid values: ``
-
-
-#### Settings :
-- `primary_key:[]` 
-- `editable_fields:[]`
-- `single_record : true` 

package/doc-src/2_schema.md

@@ -1 +0,0 @@
-# How to add a new schema