cyberia 2.8.885

package/.github/workflows/release.cd.yml

@@ -0,0 +1,37 @@
+name: CD | Release deployment | remote ssh
+
+on:
+  workflow_run:
+    workflows: ['CI | Publish npm package']
+    types:
+      - completed
+
+jobs:
+  after-publish:
+    if: github.repository == 'underpostnet/pwa-microservices-template' || startsWith(github.event.head_commit.message, 'cd(ssh-release)')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Run remote deploy via SSH
+        uses: appleboy/ssh-action@v1.2.2
+        with:
+          # Remote host (secret)
+          host: ${{ secrets.SSH_HOST }}
+          # Remote user (secret)
+          username: ${{ secrets.SSH_USERNAME }}
+          # Private key (secret) — the PEM contents (not a path)
+          key: ${{ secrets.SSH_PRIV_KEY }}
+          # Remote port (optional)
+          port: ${{ secrets.SSH_PORT }}
+          # Optional: if your private key has a passphrase, add:
+          # passphrase: ${{ secrets.SSH_KEY_PASSPHRASE }}
+          # Commands to run on the remote VM
+          script: |
+            set -e
+            echo "Starting remote release deploy"
+            cd /home/dd/engine
+            npm install -g underpost
+            underpost run secret
+            underpost run pull
+            underpost run secret
+            underpost cmt . --empty ci docker-image-engine
+            underpost run ssh-deploy engine-test

package/.nycrc

@@ -0,0 +1,9 @@
+{
+  "exclude": [],
+  "include": ["test"],
+  "output": "reports",
+  "reporter": ["html", "text", "lcov", "text-lcov", "cobertura"],
+  "sourceMap": true,
+  "instrument": true,
+  "all": true
+}

package/.prettierignore

@@ -0,0 +1,13 @@
+/node_modules
+/public
+/conf
+/tmp
+/bkt
+/logs
+/build
+/.env
+/coverage
+/prometheus_data
+/grafana_data
+.nyc_output
+.cache

package/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "printWidth": 120,
+  "singleQuote": true,
+  "useTabs": false,
+  "tabWidth": 2,
+  "semi": true,
+  "bracketSpacing": true,
+  "trailingComma": "all"
+}

package/.vscode/extensions.json

@@ -0,0 +1,51 @@
+{
+    "recommendations": [
+        "antiantisepticeye.vscode-color-picker",
+        "bashmish.es6-string-css",
+        "codeium.codeium",
+        "eamodio.gitlens",
+        "esbenp.prettier-vscode",
+        "formulahendry.code-runner",
+        "github.codespaces",
+        "github.vscode-github-actions",
+        "golang.go",
+        "gruntfuggly.todo-tree",
+        "mechatroner.rainbow-csv",
+        "mindaro-dev.file-downloader",
+        "ms-azuretools.vscode-containers",
+        "ms-azuretools.vscode-docker",
+        "ms-kubernetes-tools.vscode-kubernetes-tools",
+        "ms-python.black-formatter",
+        "ms-python.debugpy",
+        "ms-python.python",
+        "ms-python.vscode-pylance",
+        "ms-vscode-remote.remote-containers",
+        "oderwat.indent-rainbow",
+        "pleiades.java-extension-pack-jdk",
+        "ravioshankar.scala-gurus",
+        "redhat.java",
+        "redhat.vscode-xml",
+        "redhat.vscode-yaml",
+        "ritwickdey.liveserver",
+        "scala-lang.scala",
+        "scala-lang.scala-snippets",
+        "scalameta.metals",
+        "shakram02.bash-beautify",
+        "shardulm94.trailing-spaces",
+        "streetsidesoftware.code-spell-checker",
+        "tamasfe.even-better-toml",
+        "tobermory.es6-string-html",
+        "visualstudioexptteam.intellicode-api-usage-examples",
+        "visualstudioexptteam.vscodeintellicode",
+        "vmware.vscode-boot-dev-pack",
+        "vmware.vscode-spring-boot",
+        "vscjava.vscode-gradle",
+        "vscjava.vscode-java-debug",
+        "vscjava.vscode-java-dependency",
+        "vscjava.vscode-java-pack",
+        "vscjava.vscode-java-test",
+        "vscjava.vscode-maven",
+        "vscjava.vscode-spring-boot-dashboard",
+        "vscjava.vscode-spring-initializr"
+    ]
+}

package/.vscode/settings.json

@@ -0,0 +1,87 @@
+{
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "editor.formatOnSave": true,
+  "explorer.compactFolders": false,
+  "javascript.preferences.importModuleSpecifierEnding": "js",
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[python]": {
+    "editor.defaultFormatter": "ms-python.python"
+  },
+  "cSpell.words": [
+    "adminer",
+    "ANAME",
+    "browserconfig",
+    "Bymyelectrics",
+    "certbot",
+    "certonly",
+    "changefreq",
+    "chebyshev",
+    "Cids",
+    "Contracultura",
+    "cooldown",
+    "cryptokoyn",
+    "cyberia",
+    "cyberiaonline",
+    "dbname",
+    "dists",
+    "DNSSEC",
+    "DOGMADUAL",
+    "dondominio",
+    "dont",
+    "fileupload",
+    "fontawesome",
+    "fortawesome",
+    "gameplay",
+    "googlebot",
+    "Hexa",
+    "htdocs",
+    "htmls",
+    "inet",
+    "inlt",
+    "ipfs",
+    "Itemledger",
+    "jsonld",
+    "lampp",
+    "letsencrypt",
+    "loadingio",
+    "Longname",
+    "metanarrative",
+    "Microdata",
+    "minami",
+    "MMORPG",
+    "mongosh",
+    "mysqldump",
+    "neodrag",
+    "nexodev",
+    "pathfinding",
+    "Pixi",
+    "privkey",
+    "runas",
+    "Scatterplot",
+    "sortablejs",
+    "statefulset",
+    "supervisord",
+    "Tokenomics",
+    "underpost",
+    "underpostnet",
+    "Unequip",
+    "uuidv",
+    "Valkey",
+    "webroot",
+    "xampp",
+    "xfwd",
+    "youtu"
+  ],
+  "[php]": {
+    "editor.defaultFormatter": "bmewburn.vscode-intelephense-client"
+  },
+  "[xml]": {
+    "editor.defaultFormatter": "redhat.vscode-xml"
+  },
+
+  "files.watcherExclude": {
+    "**/target": true
+  }
+}

package/AUTHORS.md

@@ -0,0 +1,21 @@
+# Authors
+
+
+Author: fcoverdugoa <52893447+underpostnet@users.noreply.github.com>
+
+
+Author: fcoverdugoa <fcoverdugoa@underpost.net>
+
+
+Author: fcoverdugo <fcoverdugoa@underpost.net>
+
+
+Author: underpost.net <52893447+underpostnet@users.noreply.github.com>
+
+
+Author: underpostnet <fcoverdugoa@underpost.net>
+
+
+
+
+#### Generated by [underpost.net](https://underpost.net)

package/CHANGELOG.md

@@ -0,0 +1,205 @@
+### Changelog
+
+All notable changes to this project will be documented in this file. Dates are displayed in UTC.
+
+Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
+
+#### [v2.8.646](https://github.com/underpostnet/engine/compare/v2.8.532...v2.8.646)
+
+> 28 March 2025
+
+- refactor(engine-core): 📦 start deploy refactor [`4c4ebdb`](https://github.com/underpostnet/engine/commit/4c4ebdb8ebd57b77420451cc8a1022c3d63444b1)
+- refactor(engine-core): 📦 monitor and image build logic [`fd8f7ee`](https://github.com/underpostnet/engine/commit/fd8f7eeed054d3c591961e03c3a15029a7dfb380)
+- ci(package-pwa-microservices-template): ⚙️ Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) [`25e4097`](https://github.com/underpostnet/engine/commit/25e4097a9bde35ee7d0b5e5c2fb9546e80f50aee)
+
+#### [v2.8.532](https://github.com/underpostnet/engine/compare/v2.8.521...v2.8.532)
+
+> 6 March 2025
+
+- ci(package-pwa-microservices-template): ⚙️ Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) [`09b2e9a`](https://github.com/underpostnet/engine/commit/09b2e9a5e16092415f553566643d70e5ae81951f)
+- refactor(cli): 📦 it script methods [`8a16e17`](https://github.com/underpostnet/engine/commit/8a16e17db6d3b70198a6d435624572d8807feb46)
+- feat(mongo): ✨ advance support mongo 4.4 [`2bb5bf9`](https://github.com/underpostnet/engine/commit/2bb5bf9f32162207f01a6a57effb514ae36e9ebc)
+
+#### [v2.8.521](https://github.com/underpostnet/engine/compare/v2.8.56...v2.8.521)
+
+> 4 March 2025
+
+#### [v2.8.56](https://github.com/underpostnet/engine/compare/v2.8.51...v2.8.56)
+
+> 11 March 2025
+
+- ci(package-pwa-microservices-template): ⚙️ Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) [`2d03419`](https://github.com/underpostnet/engine/commit/2d034191f73adad4091e25a2d01e3fb3df5e697a)
+- revert(remove cyberia assets): 🗑 Reverts a previous commit [`b7dc5bd`](https://github.com/underpostnet/engine/commit/b7dc5bd5f02d601cac04ffd699c704667cb9c22b)
+- feat(cyberia-cli): ✨ media generator adbvance [`61bbdb3`](https://github.com/underpostnet/engine/commit/61bbdb32b2a99cf54af9f69640e7aa15066f0f7d)
+
+#### [v2.8.51](https://github.com/underpostnet/engine/compare/v2.8.46...v2.8.51)
+
+> 4 March 2025
+
+- ci: ⚙️ add dd-core-development yamls [`a236466`](https://github.com/underpostnet/engine/commit/a2364666f5ddc0e824fa8b68b203bb9e021cca0c)
+- refactor(cli): 📦 cron jobs management refactor [`8c28689`](https://github.com/underpostnet/engine/commit/8c28689cd514ee0e30a38be22ca3dbd292aa3a8a)
+- ci(package-pwa-microservices-template): ⚙️ Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) [`dd3557b`](https://github.com/underpostnet/engine/commit/dd3557bc52724d9231a0a13a320108758b6a84d2)
+
+#### [v2.8.46](https://github.com/underpostnet/engine/compare/v2.8.44...v2.8.46)
+
+> 28 February 2025
+
+- refactor(add cli module directory): 📦 A code change that neither fixes a bug nor adds a feature [`56eea01`](https://github.com/underpostnet/engine/commit/56eea0121489998945c1b2040c3fc53cf6ee295c)
+- refactor(bin): 📦 static API method access [`dcac59e`](https://github.com/underpostnet/engine/commit/dcac59e0cc3fb3e7eeef490d7ded3adb921f4e7a)
+- ci(package-pwa-microservices-template): ⚙️ update version 2.8.45 [`11795eb`](https://github.com/underpostnet/engine/commit/11795eb2b57243530bfd027774005a83edbdee3b)
+
+#### [v2.8.44](https://github.com/underpostnet/engine/compare/v2.8.42...v2.8.44)
+
+> 18 February 2025
+
+- ci(package-pwa-microservices-template): ⚙️ update version 2.8.44 [`1d1731d`](https://github.com/underpostnet/engine/commit/1d1731d8c81389f9ba6a308af9a66e455baa8fad)
+- ci(package-pwa-microservices-template): ⚙️ Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) [`1c2cc3e`](https://github.com/underpostnet/engine/commit/1c2cc3ed8c96c1d7d219f112692397de14aea172)
+- ci(package-pwa-microservices-template): ⚙️ add underpost cli root env management [`1923fb6`](https://github.com/underpostnet/engine/commit/1923fb6b32c1d2df1564fb94d3475b4ef0400f99)
+
+#### [v2.8.42](https://github.com/underpostnet/engine/compare/v2.8.31...v2.8.42)
+
+> 18 February 2025
+
+- ci(engine-lampp-repo-build): ⚙️ Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) [`cd076c0`](https://github.com/underpostnet/engine/commit/cd076c095fde19caf744e5e04e419973670fbc6c)
+- ci(engine-cyberia-repo-build): ⚙️ Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) [`69d55e2`](https://github.com/underpostnet/engine/commit/69d55e2d9f8f93252561c17747472f12c6369e1c)
+- ci(engine-core-repo-build): ⚙️ Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) [`b031b0f`](https://github.com/underpostnet/engine/commit/b031b0f65884d9d908143e2d609ea8b0f30828a0)
+
+#### [v2.8.31](https://github.com/underpostnet/engine/compare/v2.8.1...v2.8.31)
+
+> 5 February 2025
+
+- build(clipboardy): 🛠 add cli copy paste [`18acbde`](https://github.com/underpostnet/engine/commit/18acbded151da88499a3a0f1c1bfdbdef2abfc6b)
+- HealthcareAppointmentService advance [`228257c`](https://github.com/underpostnet/engine/commit/228257c0aa2d875014e72f2550bb44aa6b009bed)
+- healthcare appoiment service advance [`207a299`](https://github.com/underpostnet/engine/commit/207a299ffc815870a574524907d5b6b3d9924f1a)
+
+#### [v2.8.1](https://github.com/underpostnet/engine/compare/v2.8.0...v2.8.1)
+
+> 20 January 2025
+
+- [ci][docker-image][engine] v2.8.1 [`1c44f4c`](https://github.com/underpostnet/engine/commit/1c44f4cb53d1e197866e6ef768287f618fbe79b4)
+- version refactor [`1aeaca2`](https://github.com/underpostnet/engine/commit/1aeaca200c8003915d3ef422f2bb2818e7438b8d)
+- add bymyelectrics client components [`f2d3e8c`](https://github.com/underpostnet/engine/commit/f2d3e8c888b2b8573b25965b549fcb8e6b2e86e7)
+
+#### [v2.8.0](https://github.com/underpostnet/engine/compare/v2.7.94...v2.8.0)
+
+> 31 December 2024
+
+- add vectorized lore cyberia [`166e021`](https://github.com/underpostnet/engine/commit/166e0210470e6a0fbaf755320c56105932138e28)
+- cyberia biome engine advance [`e8bbce7`](https://github.com/underpostnet/engine/commit/e8bbce7cf2154c6de67840132cebc50349b1ab67)
+- update src v2.8.0 [`3fa3aa1`](https://github.com/underpostnet/engine/commit/3fa3aa12db3609bd14ac526626707a152d69bd32)
+
+#### [v2.7.94](https://github.com/underpostnet/engine/compare/v2.7.93...v2.7.94)
+
+> 17 December 2024
+
+- cyberia server character server transport refactor [`d302a5a`](https://github.com/underpostnet/engine/commit/d302a5ab02d789226d9ef84bf00c19358f83b5cb)
+- healthcare nutrition-tips advance [`f97ca58`](https://github.com/underpostnet/engine/commit/f97ca58344d9d9da656155deaaac54c621e927f8)
+- scroll top refresh refactor [`b9fc99f`](https://github.com/underpostnet/engine/commit/b9fc99f413b8a177242c9e6538eb70c73f97747e)
+
+#### [v2.7.93](https://github.com/underpostnet/engine/compare/v2.7.92...v2.7.93)
+
+> 12 December 2024
+
+- [ci][docker-image][engine] [`0d209f7`](https://github.com/underpostnet/engine/commit/0d209f7336b33d56db290e6816152a29194f224f)
+- add pul refresh reload [`93c2929`](https://github.com/underpostnet/engine/commit/93c29298e322181ef320644a97731b90efed1811)
+- update get lang function [`895df49`](https://github.com/underpostnet/engine/commit/895df49c150c09f3f2c0d96921f3529a097f5f83)
+
+#### [v2.7.92](https://github.com/underpostnet/engine/compare/v2.7.91...v2.7.92)
+
+> 12 December 2024
+
+- ssr refactor advance [`9c1be61`](https://github.com/underpostnet/engine/commit/9c1be61a48c7fe343c38008fc81854713c239388)
+- [ci][docker-image][engine] v2.7.92 [`719efb7`](https://github.com/underpostnet/engine/commit/719efb7486c2651450ad698f9d5770042ed4c060)
+- cyberia biome instance refactor [`44e56ed`](https://github.com/underpostnet/engine/commit/44e56ed7cebccacbf7439ffb6857f12afa52edeb)
+
+#### [v2.7.91](https://github.com/underpostnet/engine/compare/v2.7.83...v2.7.91)
+
+> 7 December 2024
+
+- [ci][docker-image][engine] v2.7.91 [`9616635`](https://github.com/underpostnet/engine/commit/9616635c12d4eba7e7597a81f6ff6760fc9fb937)
+- add gemini creator quest [`5f1bbec`](https://github.com/underpostnet/engine/commit/5f1bbeca4698879043c7d4abb1341c8ac08b859c)
+- update to version 2.7.9 [`41b96b6`](https://github.com/underpostnet/engine/commit/41b96b63e48759a3bb8ab54c0573536db8ef4143)
+
+#### [v2.7.83](https://github.com/underpostnet/engine/compare/v2.7.9...v2.7.83)
+
+> 28 October 2024
+
+#### [v2.7.9](https://github.com/underpostnet/engine/compare/v2.7.7...v2.7.9)
+
+> 14 November 2024
+
+- update version 2.7.83 [`3d22671`](https://github.com/underpostnet/engine/commit/3d22671a23f25767cc01c244090e237ab3a300da)
+- remove unnecesary packages [`4c0e029`](https://github.com/underpostnet/engine/commit/4c0e029509331fb718554d595d7de9e042eb2b54)
+- add item-skin-08 tile engine logic [`b72c64f`](https://github.com/underpostnet/engine/commit/b72c64f218d013653c1c800473f768dc38fe5607)
+
+#### [v2.7.7](https://github.com/underpostnet/engine/compare/v2.7.6...v2.7.7)
+
+> 25 October 2024
+
+- update version 2.7.7 [`df31617`](https://github.com/underpostnet/engine/commit/df316174ca563251fbaca62a6717771f3056e59b)
+- cyberia ssr lore advance [`ad1f214`](https://github.com/underpostnet/engine/commit/ad1f2144bdd2f3b5b1f2ebc4b9f6b83716df800a)
+- advance ssr lore cyberia [`03b2292`](https://github.com/underpostnet/engine/commit/03b2292f6e092fc9b98cfb6aba9eee6eb0f21a06)
+
+#### [v2.7.6](https://github.com/underpostnet/engine/compare/v2.7.5...v2.7.6)
+
+> 17 October 2024
+
+- update version v2.7.6 [`ddbc2c4`](https://github.com/underpostnet/engine/commit/ddbc2c4bd366e75b580be288c28c68830ed390d5)
+- update node version 22.9.0 and hardhat refactor [`8ba9281`](https://github.com/underpostnet/engine/commit/8ba92818cd67438359dd1aa0938fd33bb932e718)
+- remove pinata [`e231b00`](https://github.com/underpostnet/engine/commit/e231b00919d9d0e31c9718d4dc512384779cf2bb)
+
+#### [v2.7.5](https://github.com/underpostnet/engine/compare/v2.7.2...v2.7.5)
+
+> 10 October 2024
+
+- remove os switchs [`78f7c17`](https://github.com/underpostnet/engine/commit/78f7c17bdaa1789101bf3038544d105b51f25309)
+- update version 2.7.5 [`ca059d9`](https://github.com/underpostnet/engine/commit/ca059d99f95121cbd51f4582c60458734e21b70d)
+- add mondo db server daemon [`b3bab7e`](https://github.com/underpostnet/engine/commit/b3bab7e8ba4204da459660d5fdba25c076c6cd33)
+
+#### [v2.7.2](https://github.com/underpostnet/engine/compare/v2.7.1...v2.7.2)
+
+> 8 October 2024
+
+- underpost panel advance [`60087d5`](https://github.com/underpostnet/engine/commit/60087d55920ae9ddf7d7a3396606088d028cc996)
+- file explorer content ui ux refactor [`38e87a0`](https://github.com/underpostnet/engine/commit/38e87a0f0bd222e1d8c9d76904d086aa9d2125ea)
+- add macro db restore logic [`9cfd41c`](https://github.com/underpostnet/engine/commit/9cfd41c5d7adcd309976e7d327af800ffcf92dac)
+
+#### [v2.7.1](https://github.com/underpostnet/engine/compare/v2.6.3...v2.7.1)
+
+> 19 September 2024
+
+- update version 2.7.0 [`03c5c35`](https://github.com/underpostnet/engine/commit/03c5c35a71e7ffb35203a668bfa2f8e2f86125e0)
+- update [`d410da6`](https://github.com/underpostnet/engine/commit/d410da62fadbbb841eb9dcfa5922f105d35ad81d)
+- add changelog generator [`28b3256`](https://github.com/underpostnet/engine/commit/28b3256ab9cebaa9caf2b52426e48f0b3105c8b7)
+
+#### [v2.6.3](https://github.com/underpostnet/engine/compare/v2.6.2...v2.6.3)
+
+> 14 September 2024
+
+- update version 2.6.3 [`85c585d`](https://github.com/underpostnet/engine/commit/85c585d1cce30de4389772605cf56e774e2b7d3c)
+- update refactor docs and coverage [`b455016`](https://github.com/underpostnet/engine/commit/b455016f5f2b2bdc142aacb4dfd66ab890125662)
+- update [`b8f01f2`](https://github.com/underpostnet/engine/commit/b8f01f258999c9ebc1173b0616f0f7b8f7171048)
+
+#### [v2.6.2](https://github.com/underpostnet/engine/compare/v2.5.1...v2.6.2)
+
+> 13 September 2024
+
+- update version 2.6.2 [`0895afb`](https://github.com/underpostnet/engine/commit/0895afbde42dd5a573507ccfcb07c328648b4eb0)
+- update version 2.5.6 [`ca57b87`](https://github.com/underpostnet/engine/commit/ca57b87c56a544e7b7e53baa5a6e15415e16b99b)
+- update [`eec4943`](https://github.com/underpostnet/engine/commit/eec49433f50b4dfa7b7bbff48891a60f5be25545)
+
+#### [v2.5.1](https://github.com/underpostnet/engine/compare/v2.0.0...v2.5.1)
+
+> 27 August 2024
+
+- css refactor [`49b1904`](https://github.com/underpostnet/engine/commit/49b1904e83162f9066fbf843ced37d4e87db5581)
+- refactor [`dad4f95`](https://github.com/underpostnet/engine/commit/dad4f9567629b737254702ce8be6b243e68fb01e)
+- add sitemap builder [`53d05a6`](https://github.com/underpostnet/engine/commit/53d05a62d03ea327df3d37181a4b5c272d417289)
+
+#### v2.0.0
+
+> 30 March 2024
+
+- seed-city assets [`6d9decb`](https://github.com/underpostnet/engine/commit/6d9decbae96b828aa001777f96dd75aab3fc71d1)
+- update [`1069fc5`](https://github.com/underpostnet/engine/commit/1069fc5268aa5ef7c101695393de59edfc14daf8)
+- update [`41ae7d4`](https://github.com/underpostnet/engine/commit/41ae7d4c969cce0608171c820e05ebab42610a7f)

package/Dockerfile

@@ -0,0 +1,28 @@
+FROM rockylinux:9
+
+RUN dnf install -y --allowerasing bzip2
+RUN dnf clean all
+
+
+# Install Node.js
+RUN curl -fsSL https://rpm.nodesource.com/setup_24.x | bash -
+RUN dnf install nodejs -y
+RUN dnf clean all
+
+# Verify Node.js and npm versions
+RUN node --version
+RUN npm --version
+
+# Install underpost ci/cd cli
+RUN npm install -g underpost
+RUN underpost --version
+
+# Set working directory
+WORKDIR /home/dd
+
+# Expose necessary ports
+EXPOSE 22
+EXPOSE 80
+EXPOSE 443
+EXPOSE 3000-3100
+EXPOSE 4000-4100

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 DOGMADUAL.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+<p align="center">
+  <img src="https://www.cyberiaonline.com/assets/splash/apple-touch-icon-precomposed.png" alt="CYBERIA Network Object Layer Engine CLI"/>
+</p>
+
+<div align="center">
+
+<h1>cyberia</h1>
+
+<h2>Network Object Layer Engine CLI</h2>
+
+[![Downloads](https://img.shields.io/npm/dm/cyberia.svg)](https://www.npmjs.com/package/cyberia) [![Version](https://img.shields.io/npm/v/cyberia.svg)](https://www.npmjs.org/package/cyberia)
+
+</div>
+
+This Command Line Interface (CLI) is a core tool for the **Cyberia Network Object Layer Engine**, specifically designed for processing, generating, and managing game assets, primarily **Object Layer** elements like skins, floors, and weapons.
+
+It handles image asset quantization, generates data matrices and color palettes, and persists the resulting structured data into the game's database.
+
+## **🚀 Getting Started**
+
+### **Prerequisites**
+
+You must have the following installed in your environment:
+
+- **Node.js** (v24.10.0 recommended)
+- **npm** or **yarn**
+- **MongoDB** (or access to the configured MongoDB instance)
+
+### **Installation**
+
+1. **Clone the Repository** (If applicable):  
+   git clone \[Your Repository URL\]  
+   cd \[Your Project Directory\]
+
+2. **Install Dependencies:**  
+   npm install  
+   \# or  
+   yarn install
+
+3. Environment Setup:  
+   Ensure your required environment variables (e.g., DEFAULT_DEPLOY_ID, DEFAULT_DEPLOY_HOST, DEFAULT_DEPLOY_PATH) are correctly configured, typically in a .env file, to point the CLI to the correct database instance defined in conf.server.json.
+
+## **🛠️ Usage**
+
+The CLI is executed via Node.js, running the primary script cyberia.js. You can use your project's package.json scripts or run it directly.
+
+The main execution pattern is:
+
+node cyberia.js \[command\] \[options\]
+
+### **Main Commands**
+
+#### **1\. Processing and Saving Object Layer Assets**
+
+The primary function of this CLI is to process raw PNG/GIF assets, convert them into game-ready tile matrices and color palettes, and store the final data object in the database.
+
+| Option                  | Description                                                                                                                                                                                                                                 |
+| :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| \--process-object-layer | Iterates through all asset directories (/cyberia/assets/{type}/{id}/{direction}/{frame}), runs the frameFactory quantization logic, generates map_color and frame_matrix, and saves the final object to the database (with a SHA-256 hash). |
+
+**Example:** To process all defined assets (skins, floors, etc.):
+
+node cyberia.js \--process-object-layer
+
+#### **2\. Visualizing Processed Frames**
+
+This command allows developers to quickly visualize a single processed frame matrix, regenerating a standard PNG image from the tile data. This is useful for debugging the asset processing and quantization logic.
+
+| Option        | Format                             | Description                                                                                                                 |
+| :------------ | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------- |
+| \--show-frame | objectLayerId_direction_frameIndex | Takes a processed asset ID, direction, and frame index, reconstructs the PNG, saves it locally, and opens it using firefox. |
+
+**Example:** To show the first frame (index 0\) of the skin-001 asset in direction 08:
+
+node cyberia.js \--show-frame skin-001_08_0
+
+This will create a file named skin-001_08_0.png in the current directory and open it.
+
+## **⚙️ Core Logic (from object-layer.js)**
+
+The CLI relies on the logic provided by the ObjectLayerEngine class, which handles:
+
+- **pngDirectoryIteratorByObjectLayerType**: Walks the file system to find all relevant asset files.
+- **frameFactory**: The core image processing method that converts raw image data (PNG/GIF) into a grid of color indices (frame_matrix) and a global color palette (map_color).
+- **buildImgFromTile**: Reverses the process, taking the stored frame_matrix and map_color to reconstruct and save a visual PNG.