unetjs 5.0.0 → 5.1.0

package/dist/cjs/unet.cjs

@@ -1,8 +1,8 @@
-/* unet.js v5.0.0 2025-09-10T05:44:10.408Z */
+/* unet.js v5.1.0 2026-03-25T05:10:03.141Z */
 
 'use strict';
 
-/* fjage.js v2.2.1 */
+/* fjage.js v2.3.0 */
 
 /**
 * An action represented by a message. The performative actions are a subset of the
@@ -704,7 +704,7 @@ class JSONMessage {
       jsonObj.services = this.services;
       if (jsonObj.services.length === 0) delete jsonObj.services; // remove empty array
     }
-    if (this.answer) jsonObj.answer = this.answer;
+    if (this.answer != undefined) jsonObj.answer = this.answer;
     if (this.message) jsonObj.message = this.message;
     if (this.relay) jsonObj.relay = this.relay;
     if (this.creds) jsonObj.creds = this.creds;
@@ -1846,6 +1846,60 @@ const ParameterReq = MessageClass('org.arl.fjage.param.ParameterReq');
 */
 MessageClass('org.arl.fjage.param.ParameterRsp');
 
+/**
+* Request to write contents to a file, or delete a file.
+*
+* @typedef {Message} PutFileReq
+* @property {string} filename - name of the file to be written to or deleted
+* @property {number} [content] - content to be written to the file as a byte array. If not provided, the file will be deleted.
+* @property {number} [offset=0] - offset in the file to write the content to.
+* @exports PutFileReq
+*/
+const PutFileReq = MessageClass('org.arl.fjage.shell.PutFileReq');
+
+
+/**
+* Request to read a file or a directory.
+*
+* If the filename specified represents a directory, then the contents of the
+* directory (list of files) are returned as a tab separated string with:
+*   filename, file size, last modification time.
+*
+* The time is represented as epoch time (milliseconds since 1 Jan 1970).
+*
+* @typedef {Message} GetFileReq
+* @property {string} filename - name of the file or directory to be read
+* @property {number} [offset=0] - offset in the file to read from (ignored for directories)
+* @property {number} [length=0] - number of bytes to read from the file (ignored for directories). If 0,
+* the entire file will be read.
+*  @exports GetFileReq
+*/
+const GetFileReq = MessageClass('org.arl.fjage.shell.GetFileReq');
+
+/**
+* Response to a {@link GetFileReq}, with the contents of the file or the directory.
+*
+* @typedef {Message} GetFileRsp
+* @property {string} filename - name of the file or directory that was read
+* @property {number} [content] - content of the file as a byte array. If the filename represents a directory,
+* the content consists of a list of files (one file per line). Each line starts with the filename
+* (with a trailing "/" if it is a directory), "\t", file size in bytes, "\t", and last modification date.
+* @property {number} [offset=0] - offset in the file that the content corresponds to (ignored for directories)
+* @property {boolean} [directory=false] - indicates if the filename represents a directory
+* @exports GetFileRsp
+*/
+const GetFileRsp = MessageClass('org.arl.fjage.shell.GetFileRsp');
+
+/**
+* Request to execute shell command/script.
+*
+* @typedef {Message} ShellExecReq
+* @property {string} command - shell command or script to be executed
+* @property {boolean} ans  - indicates if the response to this request should include the output of the command/script execution
+* @exports ShellExecReq
+*/
+const ShellExecReq = MessageClass('org.arl.fjage.shell.ShellExecReq');
+
 /**
 * Services supported by fjage agents.
 */
@@ -1905,6 +1959,13 @@ let Protocol = {
  * @typedef {Object.<string, MessageClass>} UnetMessages
  */
 let UnetMessages = {
+
+  // fjage
+  'PutFileReq'             : PutFileReq,
+  'GetFileReq'             : GetFileReq,
+  'GetFileRsp'             : GetFileRsp,
+  'ShellExecReq'           : ShellExecReq,
+
   // unet
   'TestReportNtf'          : MessageClass('org.arl.unet.TestReportNtf'),
   'AbnormalTerminationNtf' : MessageClass('org.arl.unet.AbnormalTerminationNtf'),

package/dist/esm/unet.js

@@ -1,6 +1,6 @@
-/* unet.js v5.0.0 2025-09-10T05:44:10.407Z */
+/* unet.js v5.1.0 2026-03-25T05:10:03.140Z */
 
-/* fjage.js v2.2.1 */
+/* fjage.js v2.3.0 */
 
 /**
 * An action represented by a message. The performative actions are a subset of the
@@ -702,7 +702,7 @@ class JSONMessage {
       jsonObj.services = this.services;
       if (jsonObj.services.length === 0) delete jsonObj.services; // remove empty array
     }
-    if (this.answer) jsonObj.answer = this.answer;
+    if (this.answer != undefined) jsonObj.answer = this.answer;
     if (this.message) jsonObj.message = this.message;
     if (this.relay) jsonObj.relay = this.relay;
     if (this.creds) jsonObj.creds = this.creds;
@@ -1844,6 +1844,60 @@ const ParameterReq = MessageClass('org.arl.fjage.param.ParameterReq');
 */
 MessageClass('org.arl.fjage.param.ParameterRsp');
 
+/**
+* Request to write contents to a file, or delete a file.
+*
+* @typedef {Message} PutFileReq
+* @property {string} filename - name of the file to be written to or deleted
+* @property {number} [content] - content to be written to the file as a byte array. If not provided, the file will be deleted.
+* @property {number} [offset=0] - offset in the file to write the content to.
+* @exports PutFileReq
+*/
+const PutFileReq = MessageClass('org.arl.fjage.shell.PutFileReq');
+
+
+/**
+* Request to read a file or a directory.
+*
+* If the filename specified represents a directory, then the contents of the
+* directory (list of files) are returned as a tab separated string with:
+*   filename, file size, last modification time.
+*
+* The time is represented as epoch time (milliseconds since 1 Jan 1970).
+*
+* @typedef {Message} GetFileReq
+* @property {string} filename - name of the file or directory to be read
+* @property {number} [offset=0] - offset in the file to read from (ignored for directories)
+* @property {number} [length=0] - number of bytes to read from the file (ignored for directories). If 0,
+* the entire file will be read.
+*  @exports GetFileReq
+*/
+const GetFileReq = MessageClass('org.arl.fjage.shell.GetFileReq');
+
+/**
+* Response to a {@link GetFileReq}, with the contents of the file or the directory.
+*
+* @typedef {Message} GetFileRsp
+* @property {string} filename - name of the file or directory that was read
+* @property {number} [content] - content of the file as a byte array. If the filename represents a directory,
+* the content consists of a list of files (one file per line). Each line starts with the filename
+* (with a trailing "/" if it is a directory), "\t", file size in bytes, "\t", and last modification date.
+* @property {number} [offset=0] - offset in the file that the content corresponds to (ignored for directories)
+* @property {boolean} [directory=false] - indicates if the filename represents a directory
+* @exports GetFileRsp
+*/
+const GetFileRsp = MessageClass('org.arl.fjage.shell.GetFileRsp');
+
+/**
+* Request to execute shell command/script.
+*
+* @typedef {Message} ShellExecReq
+* @property {string} command - shell command or script to be executed
+* @property {boolean} ans  - indicates if the response to this request should include the output of the command/script execution
+* @exports ShellExecReq
+*/
+const ShellExecReq = MessageClass('org.arl.fjage.shell.ShellExecReq');
+
 /**
 * Services supported by fjage agents.
 */
@@ -1903,6 +1957,13 @@ let Protocol = {
  * @typedef {Object.<string, MessageClass>} UnetMessages
  */
 let UnetMessages = {
+
+  // fjage
+  'PutFileReq'             : PutFileReq,
+  'GetFileReq'             : GetFileReq,
+  'GetFileRsp'             : GetFileRsp,
+  'ShellExecReq'           : ShellExecReq,
+
   // unet
   'TestReportNtf'          : MessageClass('org.arl.unet.TestReportNtf'),
   'AbnormalTerminationNtf' : MessageClass('org.arl.unet.AbnormalTerminationNtf'),

package/dist/unetjs.js

@@ -4,7 +4,7 @@
   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.unet = {}));
 })(this, (function (exports) { 'use strict';
 
-  /* fjage.js v2.2.1 */
+  /* fjage.js v2.3.0 */
 
   /**
   * An action represented by a message. The performative actions are a subset of the
@@ -706,7 +706,7 @@
         jsonObj.services = this.services;
         if (jsonObj.services.length === 0) delete jsonObj.services; // remove empty array
       }
-      if (this.answer) jsonObj.answer = this.answer;
+      if (this.answer != undefined) jsonObj.answer = this.answer;
       if (this.message) jsonObj.message = this.message;
       if (this.relay) jsonObj.relay = this.relay;
       if (this.creds) jsonObj.creds = this.creds;
@@ -1848,6 +1848,60 @@
   */
   MessageClass('org.arl.fjage.param.ParameterRsp');
 
+  /**
+  * Request to write contents to a file, or delete a file.
+  *
+  * @typedef {Message} PutFileReq
+  * @property {string} filename - name of the file to be written to or deleted
+  * @property {number} [content] - content to be written to the file as a byte array. If not provided, the file will be deleted.
+  * @property {number} [offset=0] - offset in the file to write the content to.
+  * @exports PutFileReq
+  */
+  const PutFileReq = MessageClass('org.arl.fjage.shell.PutFileReq');
+
+
+  /**
+  * Request to read a file or a directory.
+  *
+  * If the filename specified represents a directory, then the contents of the
+  * directory (list of files) are returned as a tab separated string with:
+  *   filename, file size, last modification time.
+  *
+  * The time is represented as epoch time (milliseconds since 1 Jan 1970).
+  *
+  * @typedef {Message} GetFileReq
+  * @property {string} filename - name of the file or directory to be read
+  * @property {number} [offset=0] - offset in the file to read from (ignored for directories)
+  * @property {number} [length=0] - number of bytes to read from the file (ignored for directories). If 0,
+  * the entire file will be read.
+  *  @exports GetFileReq
+  */
+  const GetFileReq = MessageClass('org.arl.fjage.shell.GetFileReq');
+
+  /**
+  * Response to a {@link GetFileReq}, with the contents of the file or the directory.
+  *
+  * @typedef {Message} GetFileRsp
+  * @property {string} filename - name of the file or directory that was read
+  * @property {number} [content] - content of the file as a byte array. If the filename represents a directory,
+  * the content consists of a list of files (one file per line). Each line starts with the filename
+  * (with a trailing "/" if it is a directory), "\t", file size in bytes, "\t", and last modification date.
+  * @property {number} [offset=0] - offset in the file that the content corresponds to (ignored for directories)
+  * @property {boolean} [directory=false] - indicates if the filename represents a directory
+  * @exports GetFileRsp
+  */
+  const GetFileRsp = MessageClass('org.arl.fjage.shell.GetFileRsp');
+
+  /**
+  * Request to execute shell command/script.
+  *
+  * @typedef {Message} ShellExecReq
+  * @property {string} command - shell command or script to be executed
+  * @property {boolean} ans  - indicates if the response to this request should include the output of the command/script execution
+  * @exports ShellExecReq
+  */
+  const ShellExecReq = MessageClass('org.arl.fjage.shell.ShellExecReq');
+
   /**
   * Services supported by fjage agents.
   */
@@ -1907,6 +1961,13 @@
    * @typedef {Object.<string, MessageClass>} UnetMessages
    */
   let UnetMessages = {
+
+    // fjage
+    'PutFileReq'             : PutFileReq,
+    'GetFileReq'             : GetFileReq,
+    'GetFileRsp'             : GetFileRsp,
+    'ShellExecReq'           : ShellExecReq,
+
     // unet
     'TestReportNtf'          : MessageClass('org.arl.unet.TestReportNtf'),
     'AbnormalTerminationNtf' : MessageClass('org.arl.unet.AbnormalTerminationNtf'),