cyberia 3.2.5 → 3.2.9

package/src/client/components/underpost/LogInUnderpost.js

@@ -6,8 +6,9 @@ import { RouterReady } from '../core/Router.js';
 import { s } from '../core/VanillaJs.js';
 import { commonUserGuard } from '../core/CommonJs.js';
 
-const LogInUnderpost = async function () {
-  LogIn.Event['LogInUnderpost'] = async (options) => {
+class LogInUnderpost {
+  static async instance() {
+  LogIn.onLogin(async (options) => {
     const { token, user } = options;
 
     AppStoreUnderpost.Data.user.main.model.user = user;
@@ -15,9 +16,10 @@ const LogInUnderpost = async function () {
     await RouterReady;
     await PanelForm.Data['underpost-panel'].updatePanel();
     if (s(`.main-btn-cloud`) && commonUserGuard(user.role)) s(`.main-btn-cloud`).classList.remove('hide');
-  };
+  }, { key: 'LogInUnderpost' });
   const { user } = await Auth.sessionIn();
   AppStoreUnderpost.Data.user.main.model.user = user;
-};
+  }
+}
 
 export { LogInUnderpost };

package/src/client/components/underpost/LogOutUnderpost.js

@@ -3,13 +3,15 @@ import { AppStoreUnderpost } from './AppStoreUnderpost.js';
 import { PanelForm } from '../core/PanelForm.js';
 import { s } from '../core/VanillaJs.js';
 
-const LogOutUnderpost = async function () {
-  LogOut.Event['LogOutUnderpost'] = async (result = { user: { _id: '' } }) => {
+class LogOutUnderpost {
+  static async instance() {
+  LogOut.onLogout(async (result = { user: { _id: '' } }) => {
     AppStoreUnderpost.Data.user.main.model.user = result.user;
 
     PanelForm.Data['underpost-panel'].updatePanel();
     if (s(`.main-btn-cloud`)) s(`.main-btn-cloud`).classList.add('hide');
-  };
-};
+  }, { key: 'LogOutUnderpost' });
+  }
+}
 
 export { LogOutUnderpost };

package/src/client/components/underpost/RouterUnderpost.js

@@ -0,0 +1,45 @@
+import { loggerFactory } from '../core/Logger.js';
+import { Modal } from '../core/Modal.js';
+import { s } from '../core/VanillaJs.js';
+
+const logger = loggerFactory(import.meta);
+
+const BannerAppTemplate = html`underpost.net`;
+
+class RouterUnderpost {
+  static routes() {
+    return {
+      '/': {
+        title: 'Home',
+        render: () => Modal.onHomeRouterEvent(),
+      },
+      '/contracultura-cyberpunk': {
+        title: 'contracultura-cyberpunk',
+        render: () => s(`.main-btn-contracultura-cyberpunk`).click(),
+      },
+      '/lab-gallery': { title: 'lab-gallery', render: () => s(`.main-btn-lab-gallery`).click() },
+      '/log-in': { title: 'log-in', render: () => s(`.main-btn-log-in`).click() },
+      '/sign-up': { title: 'sign-up', render: () => s(`.main-btn-sign-up`).click() },
+      '/log-out': {
+        title: 'log-out',
+        render: () => s(`.main-btn-log-out`).click(),
+      },
+      '/account': {
+        title: 'account',
+        render: () => s(`.main-btn-account`).click(),
+      },
+      '/u': { title: 'public-profile', render: () => s(`.main-btn-public-profile`).click() },
+      '/settings': { title: 'settings', render: () => s(`.main-btn-settings`).click() },
+      '/recover': { title: 'recover', render: () => s(`.main-btn-recover`).click() },
+      '/content': { title: 'content', render: () => s(`.main-btn-content`).click() },
+      '/cloud': { title: 'cloud', render: () => s(`.main-btn-cloud`).click() },
+      '/polyhedron': { title: 'polyhedron', render: () => s(`.main-btn-polyhedron`).click() },
+    };
+  }
+
+  static instance() {
+    return { Routes: RouterUnderpost.routes };
+  }
+}
+
+export { RouterUnderpost, BannerAppTemplate };

package/src/client/components/underpost/SettingsUnderpost.js

@@ -3,14 +3,14 @@ import { FullScreen } from '../core/FullScreen.js';
 import { Translate } from '../core/Translate.js';
 import { Worker } from '../core/Worker.js';
 
-const SettingsUnderpost = {
-  Render: async function () {
+class SettingsUnderpost {
+  static async instance() {
     let render = await FullScreen.RenderSetting();
     render += await Css.RenderSetting();
     render += await Translate.RenderSetting();
     render += await Worker.RenderSetting();
     return render;
-  },
-};
+  }
+}
 
 export { SettingsUnderpost };

package/src/client/components/underpost/SignUpUnderpost.js

@@ -1,9 +1,11 @@
 import { SignUp } from '../core/SignUp.js';
 
-const SignUpUnderpost = function () {
-  SignUp.Event['SignUpUnderpost'] = async (options) => {
+class SignUpUnderpost {
+  static instance() {
+  SignUp.onSignup(async (options) => {
     const { user } = options;
-  };
-};
+  }, { key: 'SignUpUnderpost' });
+  }
+}
 
 export { SignUpUnderpost };

package/src/client/components/underpost/TranslateUnderpost.js

@@ -1,10 +1,10 @@
 import { Translate } from '../core/Translate.js';
 
-const TranslateUnderpost = {
-  Init: async function () {
+class TranslateUnderpost {
+  static async instance() {
     Translate.Data['contracultura-cyberpunk'] = { en: 'Contracultura Cyberpunk', es: 'Contracultura Cyberpunk' };
     Translate.Data['lab-gallery'] = { en: 'Lab Gallery', es: 'Lab Gallery' };
-  },
-};
+  }
+}
 
 export { TranslateUnderpost };

package/src/client/public/cyberia-docs/ACTION-SYSTEM.md

@@ -0,0 +1,235 @@
+# Action System
+
+**Module:** `src/api/cyberia-action` · `src/api/cyberia-dialogue`
+
+---
+
+## Overview
+
+The Action System defines how NPC entities interact with players. An **Action** is a spatial, typed payload attached to a map entity that the player activates by tapping the NPC. Actions drive dialogue, shops, crafting, storage, and quest grant events.
+
+> **Implementation status — Pre-alpha:** The CyberiaAction and CyberiaDialogue MongoDB schemas and Engine REST API (`src/api/cyberia-action`, `src/api/cyberia-dialogue`) are defined. Go server integration (NPC tap routing to action handlers, shop/craft transaction processing, quest grant on dialogue completion) is planned for the **Alpha milestone**. The `freeze_start`/`freeze_end` WS messages for modal protection are implemented in the Go server today.
+
+---
+
+## Data Model
+
+### CyberiaAction Schema
+
+```
+CyberiaAction {
+  code:         String  // stable unique slug
+  type:         String  // see Action Types below
+  label:        String  // display label on interaction button
+
+  // Spatial origin — NPC entity cell providing this action
+  sourceMapCode: String
+  sourceCellX:   Number
+  sourceCellY:   Number
+
+  // Identity — used to match quest objectives of type 'talk'
+  provideItemId: String  // entity's active skin ObjectLayer item ID (e.g. 'wason', 'alex')
+
+  // Quest grant — first interaction with this NPC starts the linked quest chain
+  grantQuestCode: String  // empty = no quest granted
+
+  // Dialogue
+  dialogCode:        String    // greeting dialogue shown on tap
+  questDialogueCodes: [String] // ordered dialogue codes that satisfy 'talk' quest objectives
+
+  // Type-specific payloads:
+  shopItems: [{
+    itemId:      String  // ObjectLayer item ID being sold
+    priceItemId: String  // currency item ID (default: 'coin')
+    priceQty:    Number  // price quantity
+  }]
+
+  craftRecipes: [{
+    outputItems: [{ itemId: String, qty: Number }]
+    ingredients: [{ itemId: String, qty: Number }]
+  }]
+
+  storageSlots: Number  // storage capacity (type='storage' only)
+}
+```
+
+### CyberiaDialogue Schema
+
+```
+CyberiaDialogue {
+  code:    String  // grouping key (e.g. "wason-intro")
+  order:   Number  // 0-based sequence within the group
+  speaker: String  // display name above the dialogue line
+  text:    String  // dialogue line content
+  mood:    String  // emotion hint: neutral | angry | sad | happy | ...
+}
+```
+
+A single `code` groups many ordered dialogue lines. The C client fetches all lines for a given code in one request, then displays them sequentially.
+
+---
+
+## Action Types
+
+| Type         | Description                                                    | Active Payload                                       |
+| ------------ | -------------------------------------------------------------- | ---------------------------------------------------- |
+| `quest-talk` | Grants a quest on first interaction, then shows dialogue       | `grantQuestCode`, `dialogCode`, `questDialogueCodes` |
+| `talk`       | NPC dialogue only — satisfies `talk` quest objectives          | `dialogCode`, `questDialogueCodes`                   |
+| `shop`       | Item shop — player buys items with in-game currency            | `shopItems[]`                                        |
+| `craft`      | Crafting station — consume ingredients to produce output items | `craftRecipes[]`                                     |
+| `storage`    | Personal item storage vault                                    | `storageSlots`                                       |
+
+---
+
+## Action–Quest Integration
+
+The Action System and Quest System are linked through `provideItemId` and `questDialogueCodes`:
+
+```mermaid
+graph LR
+    Quest["CyberiaQuest\nstep.objective:\n{ type: 'talk', itemId: 'wason' }"]
+    Action["CyberiaAction\nprovideItemId: 'wason'\ngrantQuestCode: 'wason-intro'\nquestDialogueCodes: ['wason-intro']"]
+    Progress["CyberiaQuestProgress\nstep.objectiveProgress[i].current++"]
+
+    Quest -->|matched by provideItemId| Action
+    Action -->|player completes dialogue| Progress
+```
+
+**Talk objective satisfaction flow:**
+
+1. Player taps NPC → interaction bubble shown.
+2. Player taps interaction bubble → Action is fetched by spatial coordinates.
+3. Client displays `dialogCode` dialogue sequence.
+4. On first tap, if `grantQuestCode` is set → server grants the quest.
+5. After viewing all `questDialogueCodes` dialogue lines → server increments the matching `talk` objective's `current` counter.
+
+---
+
+## Shop Transaction Flow
+
+```mermaid
+sequenceDiagram
+    participant P as Player
+    participant G as Go Server
+    participant E as Engine (Node.js)
+
+    P->>G: Tap shop NPC
+    G->>E: GET /api/cyberia-action?sourceMapCode=...&sourceCellX=...
+    E-->>G: CyberiaAction { type: 'shop', shopItems: [...] }
+    G-->>P: init_data → shop payload (item list + prices)
+    P-->>G: FrozenInteractionState (modal open)
+
+    P->>G: Buy request { itemId, quantity }
+    G->>E: GET player coin balance
+    Note over G: balance >= price * quantity?
+    G->>E: Deduct coins + grant item to inventory
+    G-->>P: FCT: CoinLoss + ItemGain events
+    G-->>P: ThawPlayer (modal close allowed)
+```
+
+---
+
+## Craft Transaction Flow
+
+```mermaid
+sequenceDiagram
+    participant P as Player
+    participant G as Go Server
+    participant E as Engine (Node.js)
+    participant BC as ObjectLayerToken
+
+    P->>G: Tap craft NPC
+    G-->>P: FrozenInteractionState
+    P->>G: Craft request { recipeIndex }
+    Note over G: Verify player has all ingredients
+    G->>E: Deduct ingredient quantities from inventory
+    G->>E: Grant output items to inventory
+    opt Item has on-chain token (ERC-1155)
+        G->>BC: burn(ingredientTokenId, qty) per ingredient
+        G->>BC: mint(outputTokenId, qty)
+    end
+    G-->>P: FCT: ItemLoss per ingredient + ItemGain per output
+    G-->>P: ThawPlayer
+```
+
+---
+
+## Spatial Binding and Instance Init
+
+`sourceMapCode + sourceCellX + sourceCellY` links an Action to a specific entity cell in a specific map. During instance initialization:
+
+1. `instance_loader.go` reads each `CyberiaEntity` at its `initCellX/initCellY`.
+2. For entities with matching Action source coordinates, the Go server attaches the Action payload to the runtime entity.
+3. The entity's `entityStatus` is set to `action-provider` (ESI id=8) — the bouncing chat icon renders above its nameplate.
+
+---
+
+## Dialogue System
+
+Dialogue groups allow multi-line sequential NPC speech:
+
+```json
+[
+  {
+    "code": "wason-intro",
+    "order": 0,
+    "speaker": "Wason",
+    "text": "Young traveler... you've finally arrived.",
+    "mood": "neutral"
+  },
+  {
+    "code": "wason-intro",
+    "order": 1,
+    "speaker": "Wason",
+    "text": "The village is in danger. I need your help.",
+    "mood": "sad"
+  },
+  {
+    "code": "wason-intro",
+    "order": 2,
+    "speaker": "Wason",
+    "text": "Collect 5 herbs from the forest and return to me.",
+    "mood": "neutral"
+  }
+]
+```
+
+The C client fetches the full `code` group sorted by `order`, then renders lines one at a time in `modal_dialogue.c`. The player advances through lines by tapping.
+
+---
+
+## Indexes
+
+```javascript
+// CyberiaAction
+{ code: 1 }           // unique
+{ provideItemId: 1 }
+{ grantQuestCode: 1 } // sparse
+{ sourceMapCode: 1, sourceCellX: 1, sourceCellY: 1 }
+
+// CyberiaDialogue
+{ code: 1 }
+{ code: 1, order: 1 }
+```
+
+---
+
+## Example Action Document
+
+```json
+{
+  "code": "wason-npc",
+  "type": "quest-talk",
+  "label": "Talk",
+  "sourceMapCode": "cyberia-village",
+  "sourceCellX": 12,
+  "sourceCellY": 8,
+  "provideItemId": "wason",
+  "grantQuestCode": "wason-intro",
+  "dialogCode": "wason-intro",
+  "questDialogueCodes": ["wason-intro"],
+  "shopItems": [],
+  "craftRecipes": [],
+  "storageSlots": 0
+}
+```