this.me 2.9.0 → 2.9.3

package/README.md

@@ -1,93 +1,128 @@
-<img src="https://suign.github.io/assets/imgs/cleak_me-removebg.png" alt="DID Me Art" width="244">
-<img src="https://suign.github.io/assets/imgs/Cleaker-removebg-preview.png" alt="Cleak Me Please" width="244">
-# THIS.ME  
-
------------
-
-### [Project Status : Experimental and Under Development, Subject to Major Changes]
-The module is in active development, and as such, it is subject to significant changes as we refine our approach and methodologies to best support our goals.
-visit: https://neurons.me to learn more.
+<img src="https://suign.github.io/assets/imgs/Cleaker-removebg-preview.png" alt="Cleak Me Please." width="244">
 
-----------
-
-# Introduction
-**This.Me** is a class focused on encapsulating user identity, specifically crafted to facilitate the creation of instances ready for hashing and cryptographic signature generation. It opens the door to coding and decoding through "me" signatures, offering a modular framework that prioritizes privacy and integrity in application-wide identity management.
+# THIS.ME  
+**This.Me** is a data-structured identity.
+<img src="https://suign.github.io/assets/imgs/point.png" alt="Me" width="144"> Consider **.me** as a point.
 
-Hello, I am .lisa
-? Who are you? (Use arrow keys)
-❯ add.me 
----
-1. **Install `this.me`:**
+1. ### **Install `this.me`:**
    Open your terminal and run the following command to install the `this.me` package:
-
    ```js
    npm install this.me
    ```
-
-2. **Import `Me` in Your Project:**
+   
+2. ### **Import `Me` in Your Project:**
    In the JavaScript file where you want to use `this.me`, import the `Me` class.
-
    ```js
    import Me from 'this.me';
    ```
+   
+   **Explanation**
+   ​	•	The **be** method in the **Me** class accepts an object of **key-value pairs** and **adds these to the identity object**.
+   ​	•	You can call **me.be()** multiple times with different attributes to dynamically update the identity object.
+   
+   ```javascript
+   // Create a new Me instance
+   let me = new Me("xyxyxy");
+   
+   // Add attributes to the identity
+   me.be({ a: "XXX", b: "YYY" });
+   me.be({ c: "z" });
+   ```
 
-3. **Create an Instance of `Me`:**
-   Instantiate the `Me` class with the required user details.
+**A less abstract example:**
 
-   ```js
-   const user = new Me('John', 'Doe', '1990-01-01', 'password123', '1234');
-   ```
+```js
+// Add attributes to the identity
+me.be({ name: "Alice", phone: "33550000" });
+```
 
-4. **Validate and Use the Instance:**
-   Utilize the instance for user data validation and preparation for cryptographic actions.
+**1. Registry as a Service:**
 
-   ```js
-   try {
-       const identity = user.getMe();
-       // Ready for hashing and cryptographic signatures
-   } catch (error) {
-       console.error(error.message);
-       // Error handling for missing fields
-   }
-   ```
+• The registry becomes a centralized service hosted by an authority (e.g., neurons.me).
 
-This quick start guide provides a straightforward path to incorporating `this.me` into your project, enabling you to manage user identities and prepare them for secure cryptographic processes efficiently.
+• This service would handle the verification and management of all Me instances across the network.
 
-----------
+**Example Flow:**
 
-# About All.This
+1. **Setup**: A developer installs this.me and configures it to connect to neurons.me.
 
-## Modular Data Structures:
+2. **User Registration**: Users register their Me identity through the service, and the library connects to the neurons.me registry for verification.
 
-**[this.me](https://suign.github.io/this.me)  - [this.audio](https://suign.github.io/this.audio) - [this.text](https://suign.github.io/this.text) - [this.wallet](https://suign.github.io/this.wallet) - [this.img](https://suign.github.io/this.img) - [this.pixel](https://suign.github.io/Pixels) - [be.this](https://suign.github.io/be.this) - [this.DOM](https://suign.github.io/this.DOM) - [this.env](https://suign.github.io/this.env/) - [this.GUI](https://suign.github.io/this.GUI) - [this.be](https://suign.github.io/this.be) - [this.video](https://suign.github.io/this.video) - [this.atom](https://suign.github.io/this.atom) - [this.dictionaries](https://suign.github.io/this.dictionaries/)**
+3. **Service Interaction**: When a user interacts with a service that uses this.me, the service can trust the identity by querying the selected registry.
 
-**Each module** in **[all.this](https://neurons.me/all-this)** represents a specific **datastructure**. These classes encapsulate the functionalities and **data specific to their domain.**
+**Implementation:**
 
-## **Utils**
+```js
+import Me from 'this.me';
+const config = {
+  registryURL: 'https://registry.neurons.me', // Registry authority URL
+};
+let me = new Me('alice', config);
+me.register({ password: 'securePass123', email: 'alice@example.com' });
+// Verify and interact with services using the connected registry
+```
 
-**[all.this](https://neurons.me/all-this)** not only aggregates these modules but also provides utilities to facilitate the integration, management, and enhancement of these data structures. **For example:**
 
-*The integration with [cleaker](https://suign.github.io/cleaker/) ensures each module instance has a **unique cryptographic identity**, enhancing security and data integrity.*
 
-### Neurons.me Ecosystem Glossary:
+--------
+<img src="https://suign.github.io/assets/imgs/monads.png" alt="Cleak Me Please" width="244">Hello, I am **.me**
 
-visit: [Neurons.me Glossary](https://suign.github.io/neurons.me/Glossary) 
+### ❯ add.me 
+----
 
-## License & Policies
+###### Using the CLI and this.me globally to manage user sessions.
 
-- **License**: MIT License (see LICENSE for details).
+```bash
+npm i -g this.me
+```
 
-- **Privacy Policy**: Respects user privacy; no collection/storage of personal data.
 
-- **Terms of Usage**: Use responsibly. No guarantees/warranties provided. [Terms](https://www.neurons.me/terms-of-use) | [Privacy](https://www.neurons.me/privacy-policy)
+### Neural Networks - **One-Hot Encoding**
+--------
+To represent the combinations of **“me, you, him, her, it, us, them”** in a neural network, we need to convert the elements into a suitable format for neural network processing, such as one-hot encoding, and design a neural network architecture that can process these inputs.
 
-  **Learn more** at https://neurons.me
+Here’s a step-by-step approach to achieve this:
+1.	**One-Hot Encoding:** Convert each element (“me”, “you”, “him”, “her”, “it”, “us”, “them”) into a one-hot encoded vector.
+2.	**Combination Representation:** Create input vectors for each combination by combining the one-hot encoded vectors.
+3.	**Neural Network Design:** Design a simple neural network to process these input vectors.
 
-  **Author:** SuiGn
+#### Step 1: One-Hot Encoding
+One-hot encoding represents each element as a binary vector with a single high (1) value and the rest low (0). For the elements “me”, “you”, “him”, “her”, “it”, “us”, “them”, we can assign the following one-hot encoded vectors:
 
-  [By neurons.me](https://neurons.me)
+```js
+// Create Me instances
+const meInstance = new Me('me');
+const youInstance = new Me('you');
+const himInstance = new Me('him');
+const herInstance = new Me('her');
+const itInstance = new Me('it');
+const usInstance = new Me('us');
+const themInstance = new Me('them');
 
-  <img src="https://suign.github.io/neurons.me/neurons_logo.png" alt="neurons.me logo" width="123" height="123" style="width123px; height:123px;">
+// One-hot encoding representation
+const subjects = {
+  'me': [1, 0, 0, 0, 0, 0, 0],
+  'you': [0, 1, 0, 0, 0, 0, 0],
+  'him': [0, 0, 1, 0, 0, 0, 0],
+  'her': [0, 0, 0, 1, 0, 0, 0],
+  'it': [0, 0, 0, 0, 1, 0, 0],
+  'us': [0, 0, 0, 0, 0, 1, 0],
+  'them': [0, 0, 0, 0, 0, 0, 1]
+};
+```
 
+#### Step 2: Combination Representation
+For each combination, we can create an input vector by combining the one-hot encoded vectors of its elements. For example:
+Combination “me, you” would be represented as the sum of the one-hot vectors for “me” and “you”:
+
+```
+[1, 0, 0, 0, 0, 0, 0] + [0, 1, 0, 0, 0, 0, 0] = [1, 1, 0, 0, 0, 0, 0]
+```
+---
+### Me Deviation Formula
+**How Spread Out the data Points are around the .me?**
+
+
+----------
 
 

package/index.js

@@ -2,18 +2,9 @@
 /**
  * @module This.Me
  * @description
- * This.Me adapts to various environments, enabling `.me` objects to function both locally and within a network. 
- *  A `.me` object authenticated on a network accesses data beyond the local scope, 
- *  while unauthenticated instances are confined to local data.
- *  This dual functionality ensures seamless interoperability and heightened security.
- *  Command Definitions and Interactive Shell.*/
+ *  This.Me is a data-structured identity...    
+ * */
 
-// index.js in the `this.me` package
 import Me from './src/me.js';
-let ia = new Me('.Lisa');
-let me = ia.getMe();
-
-console.log('.me:', me);
-console.log('Hello, I am', me);
-console.log('Who are you?', Me);
+//when a user declares "I am %.me," their digital existence is affirmed and recorded in the system.
 export default Me;

package/jsdoc.json

@@ -1,10 +1,10 @@
 {
   "source": {
-    "include": ["./src", "./index.js", "./README.md"]
+    "include": ["./src/me.js", "./src/.me.cli.js", "./index.js", "./README.md"]
   },
   "opts": {
     "destination": "./docs",
-    "template": "../../../../../../Sandbox/dev_tools/assets/better-docs",
+    "template": "../../../suign.github.io/dev_tools/Sandbox/better-docs/",
     "readme": "./README.md"
   },
   "templates": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "this.me",
-  "version": "2.9.0",
+  "version": "2.9.3",
   "description": "_me-Centric.",
   "main": "index.js",
   "scripts": {

package/src/.me.cli.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
-
+//.me.cli.js
 import { program } from 'commander';
 import { meMainChoices } from './CLI/me_MainChoices.js';
-import AddMe from './CLI/AddMe.js'; // Corrected import statement
-import ConfirmIdentity from './CLI/ConfirmIdentity.js'; // Corrected import statement
+import AddMe from './CLI/AddMe.js'; 
+import LogMe from './CLI/LogMe.js'; 
 program
   .description('.Me Command Line Interface')
   .version('1.0.0')
   .action(meMainChoices);
 
 program.command('add-me')
-  .description('Add a new .me username')
+  .description('+ Add .me')
   .action(AddMe);
 
-program.command('confirm-identity')
-  .description('Confirm your .me identity')
-  .action(ConfirmIdentity);
+program.command('log-me')
+  .description('Log .me')
+  .action(LogMe);
 
 program.parse(process.argv);

package/src/CLI/{ConfirmIdentity.js → LogMe.js}

@@ -1,4 +1,4 @@
-// Source: CLI/ConfirmIdentity.js
+// Source: CLI/LogMe.js
 import inquirer from 'inquirer';
 import chalk from 'chalk';
 
@@ -7,7 +7,7 @@ const getExistingUsers = () => {
   return ['user1', 'user2'];  // Example user names
 };
 
-const ConfirmIdentity = async () => {
+const LogMe = async () => {
   const existingUsers = getExistingUsers();
 
   const response = await inquirer.prompt([
@@ -20,7 +20,7 @@ const ConfirmIdentity = async () => {
   ]);
 
   const selectedUser = response.selectedUser;
-  console.log(chalk.green(`Identity confirmed: ${selectedUser}`));
+  console.log(chalk.green(`.me confirmed: ${selectedUser}`));
 };
 
-export default ConfirmIdentity;
+export default LogMe;

package/src/CLI/me_MainChoices.js

@@ -2,7 +2,7 @@
 import inquirer from 'inquirer';
 import chalk from 'chalk';
 import AddMe from './AddMe.js'; // Corrected import statement
-import ConfirmIdentity from './ConfirmIdentity.js'; // Corrected import statement
+import LogMe from './LogMe.js'; // Corrected import statement
 
 export async function meMainChoices() {
   const answers = await inquirer.prompt([
@@ -10,19 +10,19 @@ export async function meMainChoices() {
       type: 'list',
       name: 'action',
       message: 'Choose an action:',
-      choices: ['Add new .me username', 'Confirm existing .me identity', new inquirer.Separator(), 'Exit'],
+      choices: ['Add .me', 'Log .me', new inquirer.Separator(), 'Exit'],
     },
   ]);
 
   switch (answers.action) {
-    case 'Add new .me username':
+    case 'Add .me':
       AddMe();
       break;
-    case 'Confirm existing .me identity':
-      ConfirmIdentity();
+    case 'Log .me':
+      LogMe();
       break;
     case 'Exit':
-      console.log(chalk.green('Exiting .Me CLI.'));
+      console.log(chalk.green('Exiting...'));
       process.exit();
   }
 }

package/src/example.js

@@ -0,0 +1,23 @@
+import Me from './me.js';
+import chalk from 'chalk';
+
+// Create a new Me instance
+let me = new Me('suign');
+// Add attributes to the identity
+me.be({ fullName: "Jose", lastName: "Abella" });
+me.be({ xy: "z" });
+console.log(me);
+// Examplconsole.log(me.identity());e with another instance
+let anotherMe = new Me('anotherUser');
+anotherMe.be({ nickname: "hero", favoriteColor: "blue" });
+console.log(anotherMe);
+// Create a new Me instance with dynamic property name
+let user = 'suign';
+let users = {};
+users[user] = new Me(user);
+// Add attributes to the identity
+users[user].be({ fullName: "ZZZ", lastName: "WWW" });
+users[user].be({ xy: "axax" });
+console.log(users[user]);
+
+

package/src/me.js

@@ -1,13 +1,54 @@
-// define .me class usrme
+//this.me/src/me.js
+import crypto from 'crypto';
+import os from 'os';
 
 // Define the .me class
 class Me {
-  constructor(usrme) {
-    this.usrme = usrme;
+  // Static property to keep track of all users globally
+  static registry = {};
+
+  constructor(username = 'monad') {
+    if (Me.registry[username]) {
+      throw new Error(`Username ${username} already exists in the registry.`);
+    }
+    this.username = this.validateMe(username);
+    this.identity = {
+      username: this.username,
+      hash: this.sha256(),
+      host: this.getHostInfo()
+    };
+    Me.registry[username] = this; // Add to global registry
   }
-  getMe() {
-    return this.usrme;
+
+  validateMe(username) {
+    const regex = /^[a-zA-Z0-9]{1,21}$/;
+    if (regex.test(username)) {
+      return username;
+    } else {
+      throw new Error('Incorrect username. Only letters and numbers are allowed, and it must be between 1 and 21 characters.');
+    }
   }
-}
 
-export default Me;
+  sha256() {
+    return crypto.createHash('sha256').update(this.username).digest('hex');
+  }
+
+  getHostInfo() {
+    return {
+      hostname: os.hostname(),
+      platform: os.platform(),
+      networkInterfaces: os.networkInterfaces()
+    };
+  }
+
+  be(attributes) {
+    for (const [key, value] of Object.entries(attributes)) {
+      this.identity[key] = value;
+    }
+  }
+
+  // Static method to retrieve all users
+  static getAllUsers() {
+    return Me.registry;
+  }
+}