pathchain 1.1.37 → 1.1.39

package/README.md

@@ -740,14 +740,28 @@ var path_chain_obj = pathchain.getPathchainObj(path_buff);
 console.log("Path chain obj: ", path_chain_obj);
 ```
 
-Summoning `getPatheadObj(xaddress)` returns the head object of a path:
-```javascript
-const pathchain = require("pathchain"); // Summoning pathchain
-
-// Get the head object of a path
-var path_head_obj = pathchain.getPatheadObj(path_buff);
-
-console.log("Path head object: ", path_head_obj);
+Console: 
+``` bash
+Pathchain object:  [
+  {
+    register: 'moments/253414143d338fc68096a0e3710caf0874056ccebab0c5440cc1d2316b696814',
+    author: 'entities/23223e7b9a2e98456d42963de23a165c43248e1430adfaf4fd461959a109306c',
+    text: 'This is the content of a third public node',
+    tag: 'nodes/415024cff8dd263b3252592903b5d8f098298a0eed3ab67f372ea305cf2e137b'
+  },
+  {
+    register: 'moments/86e1a2571fb12fa4af49f43ead01819b85376564e017bda6f656cde6d33dc070',
+    author: 'entities/23223e7b9a2e98456d42963de23a165c43248e1430adfaf4fd461959a109306c',
+    text: 'This is the content of a second public node',
+    tag: 'nodes/0d1686603951c3e92a3122375d27a6ead4c3131d81fd321aee04c4729657b41d'
+  },
+  {
+    register: 'moments/897a9171765ca68fb5aa264b41040e107d741307918e1acd6dda2dbea36d7dfc',
+    author: 'entities/23223e7b9a2e98456d42963de23a165c43248e1430adfaf4fd461959a109306c',
+    text: 'This is the content of a public node',
+    tag: 'nodes/480cd79de90f3cd6d5aabd7847d0eb8ed416eb5c1054e27866e29524e6da754e'
+  }
+]
 ```
 
 ## Label
@@ -833,3 +847,42 @@ var obj = pathchain.getObj(node_buff);
 
 console.log("Object: ", obj);
 ```
+
+Console:
+```bash
+Retrieving object of type:  nodes
+Object:  {
+  register: 'moments/253414143d338fc68096a0e3710caf0874056ccebab0c5440cc1d2316b696814',
+  author: 'entities/23223e7b9a2e98456d42963de23a165c43248e1430adfaf4fd461959a109306c',
+  text: 'This is the content of a third public node',
+  tag: 'nodes/415024cff8dd263b3252592903b5d8f098298a0eed3ab67f372ea305cf2e137b'
+}
+```
+
+
+#### Generic Object Type getter
+
+Parameter rules:
+|Parameter                |Required  |
+|-------------------------|----------|
+|{string} xaddress        |(required)|
+
+
+---
+Summoning `getType(xaddress)`:
+```javascript
+const pathchain = require("pathchain"); // Summoning pathchain
+
+// Having the tag/address of any object from the pathchain
+var buff_address = "nodes/415024cff8dd263b3252592903b5d8f098298a0eed3ab67f372ea305cf2e137b"
+
+// Infer its type!
+var buff_type = pathchain.getType(buff_address);
+
+console.log("Type: ", buff_type);
+```
+
+Console:
+```bash
+Type: node 
+```

package/getter.js

@@ -4,10 +4,10 @@ const dt = require('date-and-time');
 
 /**
  * Returns the current datetime string in the specified format.
- * @param {string} [format='MM DD YYYY HH:mm:SSS [GMT]Z'] - The desired date format.
+ * @param {string} [format='MM DD YYYY HH:mm:ss:SSS [GMT]Z'] - The desired date format.
  * @returns {string} The formatted current datetime.
  */
-function getCurrentDate(format = 'MM DD YYYY HH:mm:SSS [GMT]Z') {
+function getCurrentDate(format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') {
     const currentDatetime = new Date();
     return dt.format(currentDatetime, dt.compile(format, true));
 }

package/index.js

@@ -36,7 +36,7 @@ exports.hello = (name = "nameless entity") => {
  * 
  * @return {string} moment_buffer
  */
-exports.makeMoment = (datetime = getter.getCurrentDate(), lat = 0, lon = 0, x = 0, y = 0, z = 0, format = 'MM DD YYYY HH:mm:SSS [GMT]Z') => {
+exports.makeMoment = (datetime = getter.getCurrentDate(), lat = 0, lon = 0, x = 0, y = 0, z = 0, format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') => {
     const moment_buffer = maker.moment(datetime, lat, lon, x, y, z, format);
     return moment_buffer;
 }
@@ -63,7 +63,7 @@ exports.getMomentObj = (xmoment) => {
  * 
  * @return {string} entity_buffer
  */
-exports.makePioneer = (datetime = getter.getCurrentDate(), format = 'MM DD YYYY HH:mm:SSS [GMT]Z') => {
+exports.makePioneer = (datetime = getter.getCurrentDate(), format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') => {
     const pioneer_buffer = maker.pioneer(datetime, format);
     return pioneer_buffer;
 }
@@ -90,7 +90,7 @@ exports.getPioneerObj = (xpioneer = this.makePioneer()) => {
  * 
  * @return {string} entity_buffer
  */
-exports.makeEntity = (xsecret, format = 'MM DD YYYY HH:mm:SSS [GMT]Z') => {
+exports.makeEntity = (xsecret, format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') => {
     const entity_buffer = maker.entity(xsecret, format);
     return entity_buffer;
 }
@@ -117,7 +117,7 @@ exports.getEntityObj = (xentity, xauthor="") => {
  * 
  * @return {string} secret_buffer
  */
-exports.makeSecret = (author = maker.pioneer(), format = 'MM DD YYYY HH:mm:SSS [GMT]Z') => {
+exports.makeSecret = (author = maker.pioneer(), format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') => {
     const secret_buffer = maker.secret(author, format);
     return secret_buffer;
 }
@@ -165,7 +165,7 @@ exports.getSecretObj = (xsecret, xauthor = "") => {
  * 
  * @return {string} node_buffer
  */
-exports.makeNode = (text ="", xauthor = "", format = 'MM DD YYYY HH:mm:SSS [GMT]Z') => {
+exports.makeNode = (text ="", xauthor = "", format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') => {
     const node_buffer = maker.node(text, xauthor, format);
     return node_buffer;
 }
@@ -192,7 +192,7 @@ exports.getNodeObj = (xnode, xauthor="") => {
  * 
  * @return {string} link_buffer
  */
-exports.makeLink = (target="", prev="", next = "", xauthor = "", ancestor = "", format = 'MM DD YYYY HH:mm:SSS [GMT]Z') => {
+exports.makeLink = (target="", prev="", next = "", xauthor = "", ancestor = "", format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') => {
     const link_buffer = maker.link(target, prev, next, xauthor, ancestor, format);
     return link_buffer;
 }
@@ -219,7 +219,7 @@ exports.getLinkObj = (xlink, xauthor="") => {
  * 
  * @return {string} path_buffer
  */
-exports.makePath = (text ="", head="", xauthor = "", ancestor="", format = 'MM DD YYYY HH:mm:SSS [GMT]Z') => {
+exports.makePath = (text ="", head="", xauthor = "", ancestor="", format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') => {
     const path_buffer = maker.path(text, head, xauthor, ancestor, format);
     return path_buffer;
 }
@@ -257,7 +257,7 @@ exports.getPathChainObj = (xpath, xauthor="") => {
  * 
  * @return {string} label_buffer
  */
-exports.makeLabel = (text ="", xauthor = "", ancestor = "", format = 'MM DD YYYY HH:mm:SSS [GMT]Z') => {
+exports.makeLabel = (text ="", xauthor = "", ancestor = "", format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') => {
     const label_buffer = maker.label(text, xauthor, ancestor, format);
     return label_buffer;
 }

package/maker.js

@@ -7,6 +7,17 @@ const getter = require("./getter");
 const checker = require("./checker");
 const updater = require("./updater");
 
+/**
+ * Writes an element file only if none exists at the path yet.
+ * Element hashes derive from the register moment (seconds:milliseconds
+ * resolution), so a same-moment collision would otherwise silently
+ * overwrite the earlier element's protobuf — first writer wins, callers
+ * get the hash either way, and uniqueness stays the caller's concern.
+ */
+function writeOnce(filePath, buffer) {
+    if (!fs.existsSync(filePath)) fs.writeFileSync(filePath, buffer);
+}
+
 /**
  * Creates a moment Protocol Buffer
  * @param {string} datetime - Timestamp (optional)
@@ -41,7 +52,7 @@ function moment(datetime, lat, lon, x, y, z, format) {
     const moment_hash = sha256(JSON.stringify(moment_pb.moment.decode(buffer)));
 
     checker.checkDir("files/moments/");
-    fs.writeFileSync(`files/moments/${moment_hash}`, buffer);
+    writeOnce(`files/moments/${moment_hash}`, buffer);
 
     return moment_hash;
 }
@@ -75,8 +86,8 @@ function secret(author, format) {
         checker.checkDir("files/secrets/");
         checker.checkDir(`files/${author}/secrets/`);
 
-        fs.writeFileSync(`files/secrets/${secret_hash}`, buffer);
-        fs.writeFileSync(`files/${author}/secrets/${secret_hash}`, buffer);
+        writeOnce(`files/secrets/${secret_hash}`, buffer);
+        writeOnce(`files/${author}/secrets/${secret_hash}`, buffer);
         
         return secret_hash;
     } else {
@@ -115,10 +126,10 @@ function pioneer(xbigbang, format) {
         console.log("The pioneer secret buffer is: ", the_secret);
 
         checker.checkDir("files/entities/");
-        fs.writeFileSync(`files/entities/${pioneer_hash}`, buffer);
+        writeOnce(`files/entities/${pioneer_hash}`, buffer);
 
         checker.checkDir("files/pioneer/");
-        fs.writeFileSync(`files/pioneer/${pioneer_hash}`, buffer);
+        writeOnce(`files/pioneer/${pioneer_hash}`, buffer);
 
         return pioneer_hash;
     } else {
@@ -156,7 +167,7 @@ function entity(xsecret, format) {
             console.log("Updated secret: ", updated_secret);
 
             checker.checkDir("files/entities/");
-            fs.writeFileSync(`files/entities/${entity_hash}`, buffer);
+            writeOnce(`files/entities/${entity_hash}`, buffer);
 
             return entity_hash;
         } else {
@@ -172,12 +183,12 @@ function entity(xsecret, format) {
  * @param {string} format - Date format (optional)
  * @returns {string} node_hash - Hash of the created node
  */
-function node(text, author, format = 'MM DD YYYY HH:mm:SSS [GMT]Z') {
+function node(text, author, format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') {
     const node_pb = pb(fs.readFileSync('node_modules/pathchain/proto/node.proto'));
 
     let author_folder = author;
     if (author == "") {
-        author = pioneer(getter.getCurrentDate(), 'MM DD YYYY HH:mm:SSS [GMT]Z');
+        author = pioneer(getter.getCurrentDate(), 'MM DD YYYY HH:mm:ss:SSS [GMT]Z');
         author_folder = "";
     } else {
         author_folder = `${author_folder}/`;
@@ -196,7 +207,7 @@ function node(text, author, format = 'MM DD YYYY HH:mm:SSS [GMT]Z') {
     });
 
     checker.checkDir(`files/${author_folder}nodes/`);
-    fs.writeFileSync(`files/${author_folder}nodes/${node_hash}`, buffer);
+    writeOnce(`files/${author_folder}nodes/${node_hash}`, buffer);
     
     return node_hash;
 }
@@ -210,12 +221,12 @@ function node(text, author, format = 'MM DD YYYY HH:mm:SSS [GMT]Z') {
  * @param {string} format - Date format (optional)
  * @returns {string} path_hash - Hash of the created path
  */
-function path(text, elements, author, ancestor, format = 'MM DD YYYY HH:mm:SSS [GMT]Z') {
+function path(text, elements, author, ancestor, format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') {
     const path_pb = pb(fs.readFileSync('node_modules/pathchain/proto/path.proto'));
 
     let author_folder = author;
     if (author == "") {
-        author = pioneer(getter.getCurrentDate(), 'MM DD YYYY HH:mm:SSS [GMT]Z');
+        author = pioneer(getter.getCurrentDate(), 'MM DD YYYY HH:mm:ss:SSS [GMT]Z');
         author_folder = "";
     } else {
         author_folder = `${author_folder}/`;
@@ -259,7 +270,7 @@ function path(text, elements, author, ancestor, format = 'MM DD YYYY HH:mm:SSS [
     });
 
     checker.checkDir(`files/${author_folder}paths/`);
-    fs.writeFileSync(`files/${author_folder}paths/${path_hash}`, buffer);
+    writeOnce(`files/${author_folder}paths/${path_hash}`, buffer);
    
     return path_hash;
 }
@@ -272,12 +283,12 @@ function path(text, elements, author, ancestor, format = 'MM DD YYYY HH:mm:SSS [
  * @param {string} format - Date format (optional)
  * @returns {string} label_hash - Hash of the created label
  */
-function label(text, author, ancestor, format = 'MM DD YYYY HH:mm:SSS [GMT]Z') {
+function label(text, author, ancestor, format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') {
     const label_pb = pb(fs.readFileSync('node_modules/pathchain/proto/label.proto'));
 
     let author_folder = author; 
     if (author == "") {
-        author = pioneer(getter.getCurrentDate(), 'MM DD YYYY HH:mm:SSS [GMT]Z');
+        author = pioneer(getter.getCurrentDate(), 'MM DD YYYY HH:mm:ss:SSS [GMT]Z');
         author_folder = "";
     } else {
         author_folder = `${author_folder}/`;
@@ -301,7 +312,7 @@ function label(text, author, ancestor, format = 'MM DD YYYY HH:mm:SSS [GMT]Z') {
     });
 
     checker.checkDir(`files/${author_folder}labels/`);
-    fs.writeFileSync(`files/${author_folder}labels/${label_hash}`, buffer);
+    writeOnce(`files/${author_folder}labels/${label_hash}`, buffer);
     
     return label_hash;
 }
@@ -316,7 +327,7 @@ function label(text, author, ancestor, format = 'MM DD YYYY HH:mm:SSS [GMT]Z') {
  * @param {string} format - Date format (optional)
  * @returns {string} link_hash - Hash of the created link
  */
-function link(target, prev, next, author, ancestor, format = 'MM DD YYYY HH:mm:SSS [GMT]Z') {
+function link(target, prev, next, author, ancestor, format = 'MM DD YYYY HH:mm:ss:SSS [GMT]Z') {
     // Load the link protocol buffer definition
     const link_pb = pb(fs.readFileSync('node_modules/pathchain/proto/link.proto'));
     var target_type = "";
@@ -324,7 +335,7 @@ function link(target, prev, next, author, ancestor, format = 'MM DD YYYY HH:mm:S
     // Handle author and author folder
     let author_folder = author; 
     if (author === "") {
-        author = pioneer(getter.getCurrentDate(), 'MM DD YYYY HH:mm:SSS [GMT]Z');
+        author = pioneer(getter.getCurrentDate(), 'MM DD YYYY HH:mm:ss:SSS [GMT]Z');
         author_folder = "";
     } else {
         author_folder = `${author_folder}/`;
@@ -392,7 +403,7 @@ function link(target, prev, next, author, ancestor, format = 'MM DD YYYY HH:mm:S
 
     // Ensure the directory exists and write the link buffer to a file
     checker.checkDir(`files/${author_folder}links/`);
-    fs.writeFileSync(`files/${author_folder}links/${link_hash}`, buffer);
+    writeOnce(`files/${author_folder}links/${link_hash}`, buffer);
     
     return `${author_folder}links/${link_hash}`;
 }

package/package.json

@@ -34,5 +34,5 @@
   "deprecated": false,
   "description": "![image](https://user-images.githubusercontent.com/104391124/282268780-cbbc1ee6-8d97-4d80-b896-66ae3eb723dd.png)",
   "name": "pathchain",
-  "version": "1.1.37"
+  "version": "1.1.39"
 }

package/updater.js

@@ -10,7 +10,7 @@ const getter = require('./getter');
  */
 function useSecret(xsecret, xauthor = '') {
     if (!xauthor) {
-        xauthor = pioneer(getter.getCurrentDate(), 'MM DD YYYY HH:mm:SSS [GMT]Z');
+        xauthor = pioneer(getter.getCurrentDate(), 'MM DD YYYY HH:mm:ss:SSS [GMT]Z');
     }
 
     const secretProto = pb(fs.readFileSync('node_modules/pathchain/proto/secret.proto'));