duto 0.0.0 → 0.260906.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present, HUB.BI
+
+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

@@ -1,17 +1,26 @@
-### Verify if name exists:
+<h1 align="left">Duto<br/><a href="https://pr.new/attla/duto"><img align="right" src="https://developer.stackblitz.com/img/start_pr_dark_small.svg" alt="Start new PR in StackBlitz Codeflow"></a><a href="https://npmjs.com/package/duto"><img align="right" src="https://img.shields.io/npm/v/duto.svg" alt="npm package"></a></h1>
 
-```bash
-npm view PACKAGE_NAME
-```
+> ⚠️ Duto is under ALFA development — expect updates, rough edges, and occasional breack changes.
+<br/>
 
-ou
+This framework is fully geared towards the serverless world, specifically for static pages.
 
-```bash
-bun info PACKAGE_NAME
-```
+- 💡 SSG
+- ⚡️ Dynamic static routes
+- 📦 Optimized Build
 
-### Publish package
+[Read the Docs to Learn More](https://github.com/attla/duto/blob/main/DOCS.md)
 
-```bash
-bun publish
-```
+## Ecosystem Packages
+
+| Package | Version | Description |
+| -: | :- | :- |
+| [rajt](https://github.com/attla/rajt) | [![rajt version](https://img.shields.io/npm/v/rajt.svg?label=%20)](https://npm.im/rajt) | 🧱 The core of Rajt serverless framework. |
+| [create-rajt](https://github.com/attla/create-rajt) | [![create-rajt version](https://img.shields.io/npm/v/create-rajt.svg?label=%20)](https://npm.im/create-rajt) | 📁 CLI tool for create new Rajt projects, from starter templates. |
+| [forj](https://github.com/attla/forj) | [![forj version](https://img.shields.io/npm/v/forj.svg?label=%20)](https://npm.im/forj) | 🗂️ Just another query builder in typescript |
+| [t0n](https://github.com/attla/t0n) | [![t0n version](https://img.shields.io/npm/v/t0n.svg?label=%20)](https://npm.im/t0n) | 🧰 Collection of elegant typescript resources for web artisans. |
+| [cripta](https://github.com/attla/cripta) | [![cripta version](https://img.shields.io/npm/v/cripta.svg?label=%20)](https://npm.im/cripta) | 🧛 A layer of encryption a little too judicious. |
+
+## License
+
+This package is licensed under the [MIT license](https://github.com/attla/duto/blob/main/LICENSE) © [HUB](https://hub.bi)

package/package.json

@@ -1,4 +1,93 @@
 {
-"name": "duto",
-"version": "0.0.0"
+  "name": "duto",
+  "description": "All-in-one serverless framework for web artisans",
+  "version": "0.260906.0",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.d.ts",
+  "bin": "./src/cli.ts",
+  "files": ["src"],
+  "exports": {
+    ".": "./src/index.ts",
+    "./auth": "./src/server/auth/index.ts",
+    "./db": "./src/db/index.ts",
+    "./database": "./src/db/index.ts",
+    "./d1": "./src/server/db/d1.ts",
+    "./d1/types": "./src/server/db/d1.d.ts",
+    "./dynamodb": "./src/server/db/dynamodb.ts",
+    "./dynamodb/types": "./src/server/db/dynamodb.d.ts",
+    "./enum": "./src/enum.ts",
+    "./http": "./src/server/http.ts",
+    "./middleware": "./src/middleware.ts",
+    "./types": "./src/server/types.ts",
+    "./types/global": "./global.d.ts",
+    "./env": "./src/server/utils/environment.ts",
+    "./length": "./src/server/utils/length.ts"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.19.11",
+    "@hono/standard-validator": "^0.2.2",
+    "@hono/zod-validator": "^0.7.6",
+    "@scalar/hono-api-reference": "^0.12.0",
+    "@minify-html/node": "^0.18.1",
+    "@preact/signals": "^2.9.2",
+    "@swc/core": "^1.15.21",
+    "chokidar": "^3.5.2",
+    "citty": "^0.2.2",
+    "consola": "^3.4.2",
+    "cripta": "0.x",
+    "dotenv": "^16.5.0",
+    "esbuild": "^0.25.2",
+    "filesize": "^11.0",
+    "forj": "0.x",
+    "hono": "^4.13.7",
+    "hono-openapi": "^1.3.0",
+    "localflare-api": "^0.5.0",
+    "localflare-core": "^0.5.0",
+    "miniflare": "^4.20260730.0",
+    "pathe": "^2.0",
+    "preact": "^10.29.7",
+    "preact-render-to-string": "^6.6.6",
+    "quansync": "^0.2.11",
+    "t0n": "0.x",
+    "wouter-preact": "^3.10.0",
+    "wrangler": "^4.128.0",
+    "zod": "^4.3.6",
+    "zod-openapi": "^5.4.6"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260113.0",
+    "@types/node": "^26.4.1",
+    "bun-types": "^1.4.0",
+    "typescript": "^5.9.3"
+  },
+  "resolutions": {
+    "@smithy/types": "^4.3.0",
+    "zod": "^4.3.6"
+  },
+  "sideEffects": false,
+  "packageManager": "bun@1.4.0",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "author": "HUB <foss@hub.bi>",
+  "license": "MIT",
+  "homepage": "https://hub.bi/docs/duto",
+  "repository": "git://github.com/attla/duto",
+  "bugs": "https://github.com/attla/duto/issues",
+  "keywords": [
+    "SSG",
+    "app",
+    "http",
+    "application",
+    "framework",
+    "router",
+    "serverless",
+    "typescript",
+    "cloudflare",
+    "workers",
+    "workerd",
+    "vercel",
+    "bun"
+  ]
 }

package/src/cli.ts

@@ -0,0 +1,42 @@
+#!/usr/bin/env bun
+
+function exit(msg?: string, desc?: string) {
+  msg && console.error(msg)
+  desc && console.log(desc)
+  process.exit(0)
+}
+
+if (!import.meta.main)
+  exit('Error: Duto must be used directly as CLI command.')
+
+if (!process?.isBun || typeof Bun === 'undefined')
+  exit('Error: "Bun" is not available.', '  Try install: https://bun.sh/get')
+
+global.__st = performance.now()
+
+import { join } from 'pathe'
+import { cli } from 't0n/cli'
+import { Envir } from 't0n'
+import { version } from '!/package.json'
+import { _root, _duto } from './utils'
+
+let commands = {
+  // new:
+  // upgrade:
+}
+let pkg
+try {
+  pkg = await import(join(_root, 'package.json'))
+  if (!pkg || !pkg.duto || !pkg?.duto?.type || !['pages', 'server'].includes(pkg.duto.type))
+    exit('Error: invalid app type.')
+
+  Envir.set('duto', pkg.duto)
+  commands = (await import(join(_duto, pkg.duto.type, 'cli')))?.default
+} catch {}
+
+cli({
+  name: 'duto',
+  description: 'Duto',
+  version,
+  commands,
+})

package/src/enum.ts

@@ -0,0 +1,2 @@
+export { Enum } from 't0n'
+export type { EnumStatic, EnumValue, EnumType } from 't0n'

package/src/index.d.ts

@@ -0,0 +1,61 @@
+/// <reference types='bun-types' />
+/// <reference types='node' />
+
+// export { }
+
+import * as Duto from './'
+
+declare global {
+  // Duto
+  var __st: number
+  var __hmr: boolean
+
+  type Req = Duto.Req
+  type Res = Duto.Res
+  type $v = Duto.$v
+  type IRequest = Duto.IRequest
+  type IResponse = Duto.IResponse
+  type IValidator = Duto.IValidator
+
+  type Context = Duto.Context
+  type Next = Duto.Next
+
+  type Abilities = Duto.Abilities
+  type Roles = Duto.Roles
+
+  type EnumStatic = Duto.EnumStatic
+  type EnumValue = Duto.EnumValue
+  type EnumType = Duto.EnumType
+
+
+  // Bun:test
+  var test: typeof import('bun:test').test
+  var describe: typeof import('bun:test').describe
+  var it: typeof import('bun:test').it
+  var expect: typeof import('bun:test').expect
+  // Hooks
+  var beforeAll: typeof import('bun:test').beforeAll
+  var afterAll: typeof import('bun:test').afterAll
+  var beforeEach: typeof import('bun:test').beforeEach
+  var afterEach: typeof import('bun:test').afterEach
+  // Mocking
+  var mock: typeof import('bun:test').mock
+  var vi: typeof import('bun:test').vi
+  var jest: typeof import('bun:test').jest
+  var spyOn: typeof import('bun:test').spyOn
+  // Utils
+  var setSystemTime: typeof import('bun:test').setSystemTime
+  var setDefaultTimeout: typeof import('bun:test').setDefaultTimeout
+  // Types
+  var Test: typeof import('bun:test').Test
+  var Describe: typeof import('bun:test').Describe
+  var Expect: typeof import('bun:test').Expect
+  var Mock: typeof import('bun:test').Mock
+  var TestOptions: typeof import('bun:test').TestOptions
+  var Matchers: typeof import('bun:test').Matchers
+  // Namespace
+  namespace jest {
+    var fn: typeof import('bun:test').vi.fn
+    var mock: typeof import('bun:test').vi.mock
+  }
+}

package/src/index.ts

@@ -0,0 +1,19 @@
+export { default as Response } from './server/response'
+export { default as Config } from './server/config'
+
+export { Enum, Envir } from 't0n'
+export type { EnumStatic, EnumValue, EnumType } from 't0n'
+
+export type {
+  IRequest, IRequest as Req, IRequest as $req,
+  IResponse, IResponse as Res, IResponse as $res,
+  IValidator, IValidator as $v,
+  Context, Next,
+} from './server/types'
+
+// Auth
+export { Ability } from './server/auth/ability'
+export { Authnz } from './server/auth/authnz'
+export { Token } from './server/auth/token'
+
+export type { Abilities, Roles } from './server/auth/types'

package/src/middleware.ts

@@ -0,0 +1,2 @@
+export { auth } from './server/middlewares/auth'
+// export { cors } from './server/middlewares/cors'

package/src/pages/client/app.tsx

@@ -0,0 +1,123 @@
+// @ts-ignore
+import ':duto/client/hmr'
+
+import { render, hydrate, h } from 'preact'
+import { Switch, Route, Router } from 'wouter-preact'
+import { useLocation, useParams, useSearchParams, } from 'wouter-preact'
+
+import {
+  fallbackLocale, locales, messages, routes, routeMap,
+// @ts-ignore
+} from ':duto/i18n'
+// import i18n from '../i18n/client'
+import i18n, { updatePickers } from '../i18n/client'
+
+i18n(fallbackLocale, locales, messages, routes, routeMap)
+
+import EI18n from '../i18n/element'
+import Island from './island'
+import Link from './link'
+
+// import Router from './router'
+
+import {
+  views, SRoutes,
+// @ts-ignore
+} from ':duto'
+// @ts-ignore
+import ':root/styles'
+
+window.$duto = {
+  sroutes: SRoutes,
+  location: '/',
+  navigate: {},
+  params: {},
+  search: {},
+  setSearch: {},
+}
+import { renderRoute } from './router'
+// import { navigate } from 'wouter-preact/use-hash-location'
+
+for (let [tag, el, opts] of [
+  ['i-i', EI18n],
+  ['i-l', Link, { extends: 'a' }],
+  ['i-s', Island],
+] as [string, new () => HTMLElement, ElementDefinitionOptions?][]) {
+  if (!customElements.get(tag))
+    customElements.define(tag, el, opts)
+}
+// Router.load(SRoutes).mount(views)
+
+// render(h(Router, null,
+//   h(() => {
+//     // const __ = useRoute(location.pathname)
+//     document.body.removeAttribute('hidden')
+//     const [, navigate] = useLocation()
+//     // console.log(navigate)
+//     // this.navigate = navigate
+
+//     // TODO: talvez registrar todos os valores pelo id do elemento em uma fila e atualizar nesse tick...
+//     // input, select etc registra um update val e aqui popula..
+//     updatePickers()
+//     return null
+//   }, null),
+//   h(Switch, null,
+//     h(Route, { path: SRoutes.has(location.pathname) ? location.pathname : '/' }),
+//     ...views.map(([path, Component, defs, getProps]) =>
+//     h(Route, {
+//       path,
+//       component: ({ params }: { params: Record<string, string> }) => {
+//         // Trigger async render (updates container imperatively to avoid
+//         // React/Preact hook rules issues with async components)
+
+//         renderRoute(document.body, Component, params, defs, getProps)
+//         // Return null — renderRoute will call render() directly on the container
+//         return null
+//       },
+//     })
+//   ),
+
+// ) ), document.body)
+render(<Router>
+  {h(() => {
+    document.body.removeAttribute('hidden')
+    const [location, navigate] = useLocation()
+    window.$duto.location = location
+    window.$duto.navigate = navigate
+    window.$duto.params = useParams()
+    const [search, setSearch] = useSearchParams()
+    window.$duto.search = search
+    window.$duto.setSearch = setSearch
+
+    // TODO: talvez registrar todos os valores pelo id do elemento em uma fila e atualizar nesse tick...
+    // input, select etc registra um update val e aqui popula..
+    updatePickers()
+
+    // React.useEffect(() => {
+    //   document.body.removeAttribute('hidden');
+    //   navigateRef.current = navigate;
+    //   updatePickers();
+    // }, [navigate]);
+    // return null;
+  }, null)}
+  <Switch>
+    <Route path={SRoutes.has(location.pathname) ? location.pathname : '/'} component={({ params }) => {
+      delete params[0]
+      window.$duto.route = { pattern: location.pathname, params, path: location.pathname }
+    }} />
+    {/* @ts-ignore */}
+    {...views.map(([path, Component, defs, getProps, layouts]) => (
+      <Route path={path} component={({ params }: { params: Record<string, string> }) => {
+        // Trigger async render (updates container imperatively to avoid
+        // React/Preact hook rules issues with async components)
+
+        delete params[0]
+        window.$duto.route = { pattern: path, params, path: location.pathname }
+
+        renderRoute(document.body, Component, params, defs, getProps, layouts)
+        // Return null — renderRoute will call render() directly on the container
+        return null
+      }} />
+    ))}
+  </Switch>
+</Router>, document.body)

package/src/pages/client/hmr.ts

@@ -0,0 +1,13 @@
+let hmr: WebSocket | null = null
+const url = `ws${location.protocol === 'https:' ? 'ws' : ''}://${location.host}`
+
+const connect = () => {
+  hmr = new WebSocket(url, 'duto')
+  hmr.onmessage = ({ data }) => data === 'reload' && location.reload()
+  hmr.onerror = () => hmr?.close()
+}
+const reconect = () => (!hmr || hmr?.readyState === WebSocket.CLOSED) && location.reload()
+connect()
+document.addEventListener('visibilitychange', () => document.visibilityState === 'visible' && reconect())
+window.addEventListener('focus', reconect)
+window.addEventListener('pageshow', reconect)

package/src/pages/client/island.ts

@@ -0,0 +1,136 @@
+import hydrator from '../preact/client'
+
+const propTypes: { [k: string]: (value: any) => any } = {
+  0: (value) => reviveObject(value),
+  1: (value) => reviveArray(value),
+  2: (value) => new RegExp(value),
+  3: (value) => new Date(value),
+  4: (value) => new Map(reviveArray(value)),
+  5: (value) => new Set(reviveArray(value)),
+  6: (value) => BigInt(value),
+  7: (value) => new URL(value),
+  8: (value) => new Uint8Array(value),
+  9: (value) => new Uint16Array(value),
+  10: (value) => new Uint32Array(value),
+  11: (value) => Number.POSITIVE_INFINITY * value,
+}
+
+// Not using JSON.parse reviver because it's bottom-up but we want top-down
+const reviveTuple = (raw: any): any => {
+  const [type, value] = raw
+  return type in propTypes ? propTypes[type](value) : undefined
+}
+
+const reviveArray = (raw: any): any => (raw as Array<any>).map(reviveTuple)
+const reviveObject = (raw: any): any => {
+  if (typeof raw !== 'object' || raw === null) return raw
+  return Object.fromEntries(Object.entries(raw).map(([key, value]) => [key, reviveTuple(value)]))
+}
+
+// 🌊🏝🌴
+export default class Island extends HTMLElement {
+  public Component: any
+  private _hydrated = false
+  static observedAttributes = ['props']
+
+  connectedCallback() {
+    if (!this.hasAttribute('await-children') || document.readyState === 'interactive' || document.readyState === 'complete') {
+      this.build()
+      return
+    }
+
+    setTimeout(() => {
+      this.build()
+    }, 0)
+  }
+
+  disconnectedCallback() {
+  	// document.removeEventListener('d:after-swap', this.unmount);
+  	// document.addEventListener('d:after-swap', this.unmount, { once: true });
+
+    this.unmount()
+  }
+
+  attributeChangedCallback(name: string, oldValue: string, newValue: string) {
+    if (this.Component) {
+      // console.log(`[AttributeChanged] O atributo "${name}" mudou de "${oldValue}" para "${newValue}".`, this)
+      this._hydrated = false
+      this.hydrate()
+    }
+  }
+
+  async build() {
+    const componentModule = await import(this.getAttribute('url')!)
+    const componentExport = this.getAttribute('export') || 'default'
+    if (!componentExport.includes('.')) {
+      this.Component = componentModule[componentExport]
+    } else {
+      this.Component = componentModule
+      for (const part of componentExport.split('.'))
+        this.Component = this.Component[part]
+    }
+
+    await this.hydrate()
+  }
+
+  // hydrate = async () => {
+   async hydrate() {
+    // Make sure the island is mounted on the DOM before hydrating. It could be unmounted
+    // when the parent island hydrates and re-creates this island.
+    if (!this.isConnected || this._hydrated) return
+
+    // Wait for parent island to hydrate first so we hydrate top-down. The `ssr` attribute
+    // represents that it has not completed hydration yet.
+    const parent = this.parentElement?.closest('i-s')
+    if (parent) {
+      parent.addEventListener('d:hydrate', this.hydrate, { once: true })
+      return
+    }
+
+    const slotted = this.querySelectorAll('d-b')
+    const slots: Record<string, string> = {};
+    // Always check to see if there are templates.
+    // This happens if slots were passed but the client component did not render them
+    const templates = this.querySelectorAll('template[d-template]')
+    for (const template of templates) {
+      const closest = template.closest(this.tagName)
+      if (!closest?.isSameNode(this)) continue
+      slots[template.getAttribute('d-template') || 'default'] = template.innerHTML
+      template.remove()
+    }
+    for (const slot of slotted) {
+      const closest = slot.closest(this.tagName)
+      if (!closest?.isSameNode(this)) continue
+      slots[slot.getAttribute('name') || 'default'] = slot.innerHTML
+    }
+
+    let props: Record<string, unknown>
+
+    try {
+      props = this.hasAttribute('props') ? reviveObject(JSON.parse(this.getAttribute('props')!)) : {}
+    } catch (e) {
+      let componentName: string = this.getAttribute('url') || '<unknown>'
+      const componentExport = this.getAttribute('export')
+
+      if (componentExport)
+        componentName += ` (export ${componentExport})`
+
+      console.error(
+        `[hydrate] Error parsing props for component ${componentName}`,
+        this.getAttribute('props'),
+        e,
+      )
+      throw e
+    }
+
+    // @ts-ignore
+    await hydrator(this, this.Component, props, slots)
+
+    this._hydrated = true
+    this.dispatchEvent(new CustomEvent('d:hydrate'))
+  }
+
+  unmount() {
+    if (!this.isConnected) this.dispatchEvent(new CustomEvent('d:unmount'))
+  }
+}

package/src/pages/client/link.ts

@@ -0,0 +1,70 @@
+export default class Link extends HTMLAnchorElement {
+  static observedAttributes = [
+    'href',
+    'target',
+    'download',
+    'rel',
+    'hreflang',
+    'referrerpolicy',
+    'ping',
+    'type',
+  ]
+
+  constructor() {
+    super()
+
+    this.addEventListener('click', this.#onClick)
+  }
+
+  disconnectedCallback() {
+    this.removeEventListener('click', this.#onClick)
+  }
+
+  #onClick = (e: MouseEvent) => {
+    // Respeita comportamento padrão
+    if (
+      e.defaultPrevented
+      || this.target === '_blank'
+      || e.metaKey
+      || e.ctrlKey
+      || e.shiftKey
+      || e.altKey
+      || e.button !== 0
+    ) {
+      return
+    }
+    // Allow ctrl/cmd+click to open in new tab normally
+    if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return
+    // e.preventDefault()
+    if ((e.target as HTMLAnchorElement).hasAttribute('href'))
+      window.dispatchEvent(new CustomEvent('d:navigate', { detail: e.target }))
+
+    // Exemplo: interceptar navegação SPA
+    // event.preventDefault()
+    // router.push(this.href)
+  }
+
+  // Proxy opcional para facilitar typings
+  get url() {
+    return new URL(this.href)
+  }
+}
+
+
+window.addEventListener('d:navigate', e => {
+  const el = (e as CustomEvent<HTMLAnchorElement>).detail
+
+  console.warn('d:navigate', el)
+  // if (href) _navigate?.(href)
+  // _navigate?.('/haha-2')
+})
+
+// const links = document.querySelectorAll('a[d]')
+// for (const link of links) { // @ts-ignore
+//   link.addEventListener('click', (e: MouseEvent) => {
+//     // Allow ctrl/cmd+click to open in new tab normally
+//     if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return
+//     e.preventDefault()
+//     window.dispatchEvent(new CustomEvent('d:navigate', { detail: e.target }))
+//   })
+// }