miolo 3.0.0-beta.222 → 3.0.0-beta.223

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miolo",
-  "version": "3.0.0-beta.222",
+  "version": "3.0.0-beta.223",
   "description": "all-in-one koa-based server",
   "author": "Donato Lorenzo <donato@afialapis.com>",
   "contributors": [
@@ -47,7 +47,7 @@
     "@babel/plugin-proposal-decorators": "^7.29.7",
     "@babel/preset-env": "^7.29.7",
     "@babel/preset-react": "^7.29.7",
-    "@dotenvx/dotenvx": "^2.1.4",
+    "@dotenvx/dotenvx": "^2.7.3",
     "@koa/bodyparser": "^6.1.0",
     "@koa/cors": "^5.0.0",
     "@koa/router": "^15.7.0",
@@ -82,7 +82,7 @@
     "koa-ratelimit": "^6.0.0",
     "koa-session": "^7.0.2",
     "koa-static": "^5.0.0",
-    "nanoid": "^5.1.16",
+    "nanoid": "^6.0.0",
     "nodemailer": "^9.0.3",
     "passport-google-oauth20": "^2.0.0",
     "passport-local": "^1.0.0",
@@ -94,7 +94,7 @@
     "statuses": "^2.0.2",
     "tailwindcss": "^4.3.2",
     "tinguir": "^0.0.7",
-    "vite": "^8.1.3",
+    "vite": "^8.1.4",
     "winston": "^3.19.0",
     "winston-daily-rotate-file": "^5.0.0",
     "yargs-parser": "^22.0.0"

package/template/biome.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.5.2/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.3/schema.json",
   "files": {
     "includes": [
       "**/*",

package/template/package.json

@@ -27,15 +27,15 @@
     "#static/*": "./src/static/*"
   },
   "dependencies": {
-    "@radix-ui/react-avatar": "^1.2.1",
-    "@radix-ui/react-collapsible": "^1.1.15",
-    "@radix-ui/react-dialog": "^1.1.18",
-    "@radix-ui/react-dropdown-menu": "^2.1.19",
+    "@radix-ui/react-avatar": "^1.2.2",
+    "@radix-ui/react-collapsible": "^1.1.16",
+    "@radix-ui/react-dialog": "^1.1.19",
+    "@radix-ui/react-dropdown-menu": "^2.1.20",
     "@radix-ui/react-label": "^2.1.11",
-    "@radix-ui/react-select": "^2.3.2",
+    "@radix-ui/react-select": "^2.3.3",
     "@radix-ui/react-separator": "^1.1.11",
     "@radix-ui/react-slot": "^1.3.0",
-    "@radix-ui/react-tooltip": "^1.2.11",
+    "@radix-ui/react-tooltip": "^1.2.12",
     "@stepperize/react": "^7.0.0",
     "@tailwindcss/postcss": "^4.3.2",
     "@tanstack/react-table": "^8.21.3",
@@ -44,15 +44,15 @@
     "farrapa": "^3.0.0-beta.10",
     "intre": "^3.0.0-beta.4",
     "joi": "^18.2.3",
-    "lucide-react": "^1.23.0",
-    "miolo-cli": "^3.0.0-beta.222",
+    "lucide-react": "^1.24.0",
+    "miolo-cli": "^3.0.0-beta.223",
     "miolo-model": "file:../miolo-model",
-    "miolo-react": "^3.0.0-beta.222",
+    "miolo-react": "^3.0.0-beta.223",
     "next-themes": "^0.4.6",
-    "radix-ui": "^1.6.1",
+    "radix-ui": "^1.6.2",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "react-router": "^8.1.0",
+    "react-router": "^8.2.0",
     "recharts": "^3.9.2",
     "sonner": "^2.0.7",
     "tailwind": "^4.0.0",
@@ -61,8 +61,8 @@
     "tw-animate-css": "^1.4.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.5.2",
-    "miolo": "^3.0.0-beta.222",
+    "@biomejs/biome": "2.5.3",
+    "miolo": "^3.0.0-beta.223",
     "sass-embedded": "^1.100.0"
   },
   "overrides": {

package/template/src/cli/context/data/DataProvider.jsx

@@ -3,6 +3,26 @@ import useSessionContext from "#cli/context/session/useSessionContext.mjs"
 import TodoList from "#ns/models/TodoList.mjs"
 import DataContext from "./DataContext.jsx"
 
+/**
+ * @typedef {import('#ns/models/TodoList.mjs').default} TodoList
+ * @typedef {import('#ns/models/Todo.mjs').default} Todo
+ * 
+ * @typedef {Object} DataContextData
+ * @property {TodoList} lastTodos - The list of last todos.
+ * @property {(options?: Object) => Promise<void>} refreshLastTodos - Function to refresh the list of last todos.
+ * @property {boolean} loading - Whether the data is loading.
+ * @property {boolean} loaded - Whether the data is loaded.
+ * @property {Array<Object>} breads - The list of breads.
+ * @property {(breads: Array<Object>) => void} setBreads - Function to set the list of breads.
+ * @property {(title: string) => void} setTitle - Function to set the title of the page.
+ */
+
+/**
+ * @param {Object} props - The props object.
+ * @param {React.ReactNode} props.children - The children of the component.
+ * @returns {React.ReactNode} The provider.
+ * @public
+ */
 const DataProvider = ({ children }) => {
   const [breads, setBreads] = useState([])
   const { useSsrData } = useSessionContext()

package/template/src/cli/context/data/useDataContext.mjs

@@ -1,4 +1,10 @@
 import { useContext } from "react"
 import DataContext from "./DataContext.jsx"
 
-export default () => useContext(DataContext)
+/**
+ * @typedef {import('./DataContext.jsx').DataContextData} DataContextData
+ * @returns {DataContextData}
+ */
+const useDataContext = () => useContext(DataContext)
+
+export default useDataContext

package/template/src/cli/pages/todos/context/TodosProvider.jsx

@@ -5,6 +5,26 @@ import useUIContext from "#cli/context/ui/useUIContext.mjs"
 import TodoList from "#ns/models/TodoList.mjs"
 import TodosContext from "./TodosContext.jsx"
 
+
+/**
+ * @typedef {Object} TodosProviderData
+ * @property {TodoList} todoList - The list of todos.
+ * @property {Function} refreshTodoList - Function to refresh the list of todos.
+ * @property {boolean} loading - Whether the data is loading.
+ * @property {boolean} loaded - Whether the data is loaded.
+ * @property {Function} addTodo - Function to add a todo.
+ * @property {Function} toggleTodo - Function to toggle a todo.
+ * @property {Function} removeTodo - Function to remove a todo.
+ * @property {Function} checkLastHours - Function to check last hours.
+ * @property {Function} insertFakeTodo - Function to insert a fake todo.
+ * @property {boolean} canEdit - Whether the data can be edited.
+ * @property {boolean} useCrud - Whether to use crud.
+ * @property {Function} setUseCrud - Function to set the use crud.
+ * @property {Function} pingSocket - Function to ping the socket.
+ */
+
+
+
 const TodosProvider = ({ children }) => {
   // const [status, setStatus] = useState("loaded")
   const { logger } = useMioloContext()

package/template/src/cli/pages/todos/context/useTodosContext.mjs

@@ -1,4 +1,11 @@
 import { useContext } from "react"
 import TodosContext from "./TodosContext.jsx"
 
-export default () => useContext(TodosContext)
+
+/**
+ * @typedef {import('./TodosProvider.jsx').TodosProviderData} TodosProviderData
+ * @returns {TodosProviderData}
+ */
+const useTodosContext = () => useContext(TodosContext)
+
+export default useTodosContext

package/template/src/ns/models/Todo.mjs

@@ -1,29 +1,73 @@
 import { MioloModel } from "miolo-model"
 
 export default class Todo extends MioloModel {
+  /**
+   * Get the id of the todo.
+   * @returns {number|null} The id of the todo.
+   * @public
+   */
   get id() {
-    return this._get("id", null)
+    return this.get_value("id", null)
   }
+
+  /**
+   * Get the description of the todo.
+   * @returns {string} The description of the todo.
+   * @public
+   */
   get description() {
-    return this._get("description", "")
+    return this.get_value("description", "")
   }
+
+  /**
+   * Get the done status of the todo.
+   * @returns {boolean} The done status of the todo.
+   * @public
+   */
   get done() {
-    return this._get("done", false)
+    return this.get_value("done", false)
   }
+  /**
+   * Toggle the done status of the todo.
+   * @public
+   */
   toggle() {
-    this._set("done", !this.done)
+    this.set_value("done", !this.done)
   }
 
+  /**
+   * Get the creation date of the todo.
+   * @returns {number|undefined} The creation date of the todo.
+   * @public
+   */
   get createdAt() {
-    return this._get("created_at")
+    return this.get_value("created_at")
   }
+
+  /**
+   * Get the last update date of the todo.
+   * @returns {number|undefined} The last update date of the todo.
+   * @public
+   */  
   get lastUpdateAt() {
-    return this._get("last_update_at")
+    return this.get_value("last_update_at")
   }
+
+  /**
+   * Get the user who created the todo.
+   * @returns {number|undefined} The user who created the todo.
+   * @public
+   */
   get createdBy() {
-    return this._get("created_by")
+    return this.get_value("created_by")
   }
+
+  /**
+   * Get the user who last updated the todo.
+   * @returns {number|undefined} The user who last updated the todo.
+   * @public
+   */  
   get lastUpdateBy() {
-    return this._get("last_update_by")
+    return this.get_value("last_update_by")
   }
 }

package/template/src/ns/models/TodoList.mjs

@@ -1,7 +1,12 @@
 import { MioloArray } from "miolo-model"
 import Todo from "./Todo.mjs"
 
+
 export default class TodoList extends MioloArray {
+  /**
+   * @param {Array<Todo> | Array<Object>} [items=[]]
+   * @public
+   */
   constructor(items = []) {
     super(Todo, items)
   }

package/template/src/ns/models/User.mjs

@@ -1,40 +1,111 @@
 import { MioloModel } from "miolo-model"
 
 export default class User extends MioloModel {
+  /**
+   * Get the id of the user.
+   * @returns {number} The id of the user.
+   * @public
+   */  
   get id() {
-    return this._get("id")
+    return this.get_value("id")
   }
+
+  /**
+   * Get the username of the user.
+   * @returns {string|undefined} The username of the user.
+   * @public
+   */    
   get username() {
-    return this._get("username")
+    return this.get_value("username")
   }
+
+  /**
+   * Get the password of the user.
+   * @returns {string|undefined} The password of the user.
+   * @public
+   */    
   get password() {
-    return this._get("password")
+    return this.get_value("password")
   }
+
+  /**
+   * Get the name of the user.
+   * @returns {string|undefined} The name of the user.
+   * @public
+   */    
   get name() {
-    return this._get("name")
+    return this.get_value("name")
   }
+
+  /**
+   * Get the email of the user.
+   * @returns {string|undefined} The email of the user.
+   * @public
+   */    
   get email() {
-    return this._get("email")
+    return this.get_value("email")
   }
+
+  /**
+   * Get the active status of the user.
+   * @returns {boolean|undefined} The active status of the user.
+   * @public
+   */    
   get active() {
-    return this._get("active")
+    return this.get_value("active")
   }
+
+  /**
+   * Get the last login date of the user.
+   * @returns {number|undefined} The last login date of the user.
+   * @public
+   */    
   get lastLoginDate() {
-    return this._get("last_login_date")
+    return this.get_value("last_login_date")
   }
+
+  /**
+   * Get the last login IP of the user.
+   * @returns {string|undefined} The last login IP of the user.
+   * @public
+   */    
   get lastLoginIp() {
-    return this._get("last_login_ip")
+    return this.get_value("last_login_ip")
   }
+
+  /**
+   * Get the login count of the user.
+   * @returns {number} The login count of the user.
+   * @public
+   */  
   get loginCount() {
-    return this._get("login_count")
+    return this.get_value("login_count", 0)
   }
+
+  /**
+   * Get the last connection date of the user.
+   * @returns {number|undefined} The last connection date of the user.
+   * @public
+   */    
   get lastConnAt() {
-    return this._get("last_conn_at")
+    return this.get_value("last_conn_at")
   }
+
+  /**
+   * Get the creation date of the user.
+   * @returns {number|undefined} The creation date of the user.
+   * @public
+   */      
   get createdAt() {
-    return this._get("created_at")
+    return this.get_value("created_at")
   }
+
+  /**
+   * Get the last update date of the user.
+   * @returns {number|undefined} The last update date of the user.
+   * @public
+   */    
   get lastUpdateAt() {
-    return this._get("last_update_at")
+    return this.get_value("last_update_at")
   }
 }