duto 0.260808.0 → 0.260915.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025-present, ZUNQ.com
+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
@@ -18,4 +18,4 @@ 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.
+SOFTWARE.

package/README.md

@@ -1,26 +1,48 @@
-<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>
+<h1 align="left">
+  🛢 Duto &nbsp;
+  <a href="https://npmjs.com/package/duto"><img  src="https://img.shields.io/npm/v/duto.svg" alt="npm package"></a>
+  <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>
+</h1>
 
 > ⚠️ Duto is under ALFA development — expect updates, rough edges, and occasional breack changes.
 <br/>
 
-This framework is fully geared towards the serverless world, specifically for static pages.
-
-- 💡 SSG
-- ⚡️ Dynamic static routes
-- 📦 Optimized Build
-
-[Read the Docs to Learn More](https://github.com/attla/duto/blob/main/DOCS.md)
+Duto is minimalist framework, focused on client-side pages and serverless APIs.
+
+Principles:
+ - No vendor lock-in! Deploy anywhere with: `duto deploy`
+ - Developer happiness as a design constraint
+ - Optimized by default!
+
+Pages features:
+ - Static pages `/blog.tsx` `getStaticProps()`
+ - Prerendered dynamic pages `/blog/[slug].tsx` `getStaticProps()`
+ - Dynamic pages on client-side `/blog/[slug].tsx` `getProps()`
+ - Not found page on client-side `/blog/not-found.tsx`
+ - Efficient route hierarchy `/not-found.tsx`
+ - Catch-all page whitout SSR! `/blog/[...slug].tsx`
+ - Optional catch-all routes whitout SSR! `/blog/[[...slug]].tsx`
+ - Simple internationalization (i18n) integration `tˋfeaturesˋ`
+
+Server features:
+ - Instant server and cold starts
+ - Optimized build, greater efficiency in less bundle size
+ - Built-in core shims for compatibility with custom runtimes
+ - Fully typed OpenAPI documentation
+ - Powerful request validations
+ - Fine-grained authentication
+
+[Read the Docs to Learn More](https://hub.bi/docs/duto)
 
 ## 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. |
+| [forj](https://github.com/attla/forj) | [![forj version](https://img.shields.io/npm/v/forj.svg?label=%20)](https://npm.im/forj) | 🗂️ Fast and lightweight query builder in typescript |
 | [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. |
+| [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. |
 
 ## License
 
-This package is licensed under the [MIT license](https://github.com/attla/duto/blob/main/LICENSE) © [Zunq](https://zunq.com)
+This package is licensed under the [MIT license](https://github.com/attla/duto/blob/main/LICENSE) © [HUB](https://hub.bi)

package/package.json

@@ -1,50 +1,90 @@
 {
   "name": "duto",
-  "description": "Static framework for web artisans",
-  "version": "0.260808.0",
+  "description": "All-in-one serverless framework for web artisans",
+  "version": "0.260915.0",
   "type": "module",
   "main": "./src/index.ts",
+  "types": "./src/index.d.ts",
+  "bin": "./src/cli.ts",
   "files": ["src"],
-  "bin": "./src/cli/index.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": "./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": {
+    "@inquirer/confirm": "^5.1.8",
+    "@inquirer/input": "^4.1.8",
+    "@inquirer/select": "^4.1.0",
+    "nanospinner": "^1.2.2",
+    "@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",
-    "filesize": "^11.0",
+    "cripta": "0.x",
+    "dotenv": "^16.5.0",
+    "esbuild": "^0.25.2",
+    "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",
     "vite": "^8.0.0",
-    "wouter-preact": "^3.10.0"
+    "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",
     "@minify-html/node": "^0.18.1",
     "@preact/preset-vite": "^2.10.5",
     "@tailwindcss/vite": "^4.3.1",
-    "@types/node": "^25.9.0",
-    "bun-types": "^1.3.14",
+    "bun-types": "^1.4.0",
     "typescript": "^5.9.3"
   },
-  "packageManager": "bun@1.3.14",
-  "engines": {
-    "node": ">=18.0.0"
+  "resolutions": {
+    "@smithy/types": "^4.3.0",
+    "zod": "^4.3.6"
   },
+  "sideEffects": false,
+  "packageManager": "bun@1.4.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   },
-  "author": "Zunq <open-source@zunq.com>",
+  "author": "HUB <foss@hub.bi>",
   "license": "MIT",
-  "homepage": "https://zunq.dev",
+  "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",
@@ -52,6 +92,7 @@
     "typescript",
     "cloudflare",
     "workers",
+    "workerd",
     "vercel",
     "bun"
   ]

package/src/cli.ts

@@ -0,0 +1,45 @@
+#!/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 { setEnv } from 't0n'
+import { version } from '!/package.json'
+import { _root, _duto } from './utils'
+
+const cmd = (c: string) => join(import.meta.dirname, 'commands', c)
+
+let pkg
+let commands = {}
+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.')
+
+  setEnv('duto', pkg.duto)
+  commands = (await import(join(_duto, pkg.duto.type, 'cli')))?.default
+} catch {}
+
+cli({
+  name: 'duto',
+  description: 'Duto',
+  version,
+  commands: {
+    new: cmd('new'),
+    upgrade: cmd('upgrade'),
+    ...commands,
+  },
+})

package/src/commands/new.ts

@@ -0,0 +1,147 @@
+import { basename, join, relative, resolve } from 'pathe'
+import { command } from 't0n/cli'
+import { bold, dim, green, red } from 't0n/color'
+import { event, error, step, log, rn } from 't0n/log'
+import { _root } from '@/utils'
+
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'
+import confirm from '@inquirer/confirm'
+import input from '@inquirer/input'
+import select from '@inquirer/select'
+import { createSpinner } from 'nanospinner'
+import { exit } from 'node:process'
+
+const templates = [
+  'aws',
+  'workerd',
+  'vercel',
+]
+
+const renameFiles: Record<string, string | undefined> = {
+  _gitignore: '.gitignore',
+  _gitkeep: '.gitkeep',
+}
+
+
+function mkdirp(dir: string) {
+  try {
+    mkdirSync(dir, { recursive: true })
+  } catch (e) {
+    if (e instanceof Error) {
+      if ('code' in e && e.code === 'EEXIST') {
+        return
+      }
+    }
+    throw e
+  }
+}
+
+function copy(src: string, dest: string) {
+  const stat = statSync(src)
+  stat.isDirectory()
+    ? copyDir(src, dest)
+    : copyFileSync(src, dest)
+}
+function copyDir(srcDir: string, destDir: string) {
+  mkdirSync(destDir, { recursive: true })
+  for (const file of readdirSync(srcDir)) {
+    const srcFile = resolve(srcDir, file)
+    const destFile = resolve(destDir, file)
+    copy(srcFile, destFile)
+  }
+}
+
+export default command({
+	meta: {
+		name: 'new',
+		description: '📄 Create new project with duto\n',
+	},
+  args: {
+    install: {
+			alias: 'i',
+      description: 'Install dependencies',
+      type: 'boolean',
+      default: false,
+    },
+    template: {
+			alias: 't',
+      description: 'Template to use',
+      type: 'enum',
+      options: templates,
+    },
+  },
+	async run({ args }) { // @ts-ignore
+    const root = process.cwd() || process.env?.PWD || process.stdin?.path
+    let dir = args._[0]
+    if (dir) {
+      step(bold('Using target directory: '+ dim('/'+ dir.replace(/^\//, ''))))
+    } else {
+      dir = await input({ message: 'Target directory', default: root })
+      if (!dir.startsWith(root))
+        dir = join(root, dir)
+    }
+
+    const name = basename(/^(\.\/|\.\\|\.)$/.test(dir) ? root : dir)
+    const template = args.template || (await select({
+      loop: true,
+      message: 'Which template do you want to use?',
+      choices: templates.map(v => ({ title: v, value: v})),
+      default: 'workerd',
+    }))
+
+    if (!template)
+      throw new Error('No template selected')
+
+    if (!templates.includes(template))
+      throw new Error(`Invalid template selected: ${template}`)
+
+    if (existsSync(dir) && readdirSync(dir).length > 0) {
+      const response = await confirm({ message: 'Directory not empty. Continue?', default: false })
+      if (!response) process.exit(1)
+    } else {
+      mkdirp(dir)
+    }
+
+    const spinner = createSpinner('Cloning the template').start()
+    for (const t of ['base', template]) {
+      const templateDir = resolve(import.meta.dir, './templates/'+ t)
+      const files = readdirSync(templateDir)
+      for (const file of files.filter(f => f !== 'package.json'))
+        copy(join(templateDir, file), join(dir, renameFiles[file] ?? file))
+    }
+
+    spinner.success()
+
+    const pkgPath = resolve(__dirname, `./templates/base/package.json`)
+    if (existsSync(pkgPath)) {
+      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
+      pkg.name = name
+      writeFileSync(join(dir, 'package.json'), JSON.stringify(pkg, null, 2))
+    }
+
+    if (args?.install) {
+      const spinner2 = createSpinner('Installing project dependencies').start()
+      const proc = Bun.spawn(['bun', 'i'], { stdout: 'ignore', stderr: 'inherit' })
+      const procExit = await proc.exited
+
+      if (procExit === 0) {
+        spinner2.success()
+      } else {
+        spinner2.stop({
+          mark: red('×'),
+          text: 'Failed to install project dependencies',
+        })
+        exit(procExit)
+      }
+    }
+
+    event('New project successfully created')
+    if (dir != root) {
+      rn()
+      console.log(
+        dim('Get started with:'),
+        bold(`cd ${name}`),
+      )
+    }
+	},
+})

package/src/commands/templates/base/.editorconfig

@@ -0,0 +1,21 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+# [*.{js,jsx,ts,tsx,json,yaml,yml}]
+# Inherits all settings from [*] and applies to these extensions
+
+[*.{json,jsonc}]
+insert_final_newline = false
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Dockerfile]
+indent_size = 4

package/src/commands/templates/base/.env.dev.example

@@ -0,0 +1,2 @@
+APP_NAME=duto-api
+KEY=YOUR_ENCRYPT_KEY

package/src/commands/templates/base/.env.prod.example

@@ -0,0 +1,2 @@
+APP_NAME=duto-api
+KEY=YOUR_ENCRYPT_KEY

package/src/commands/templates/base/README.md

@@ -0,0 +1,29 @@
+# Duto - Starter Template
+
+This template should help get you started developing.
+
+## Install dependencies
+
+To install, run:
+
+```bash
+bun i
+```
+
+## Tests
+
+To perform the tests, run:
+
+```bash
+bun test
+```
+
+## Development environment
+
+Test the application locally in an environment identical to production using the command:
+
+```bash
+duto dev
+```
+
+[Read the Full Docs to Learn More](https://hub.bi/docs/duto)

package/src/commands/templates/base/_gitignore

@@ -0,0 +1,100 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+## custom
+.duto/
+.trash
+.trash*
+.aws-sam
+lambda.zip
+packaged.yaml
+
+# dependencies
+.wrangler/
+node_modules
+dist/
+out/
+dist-ssr
+
+# production
+/build
+
+# misc
+*.pem
+
+# debug
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# local env files
+.env*.local
+*.local
+# .env
+
+# vercel
+.vercel
+
+# tinybird
+.venv
+.tinyb
+
+# typescript
+*.tsbuildinfo
+
+# miscellaneous
+/pages/api/scripts*
+apps/docs/openapi.json
+packages/stripe-app/.build/*
+.react-email
+.contentlayer
+.vscode
+!.vscode/extensions.json
+.idea
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+*.csv
+*.ndjson
+.vitest
+
+# tests
+coverage
+/cypress/videos/
+/cypress/screenshots/
+
+### macOS ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### macOS Patch ###
+# iCloud generated files
+*.icloud
+# Localflare generated files
+.localflare/

package/src/commands/templates/base/actions/blog/index.get.ts

@@ -0,0 +1,9 @@
+import type { Req, Res } from 'duto'
+import { newID } from 't0n'
+
+export async function handle(req: Req, res: Res) {
+  return res.ok(Array.from({ length: 5 }, () => {
+    const id = newID()
+    return { id, desc: 'Blog post #'+ id }
+  }))
+}

package/src/commands/templates/base/actions/blog/post/[id].get.ts

@@ -0,0 +1,9 @@
+import type { Req, Res } from 'duto'
+
+export async function handle(req: Req, res: Res) {
+  const id = req.param('id')
+
+  return res.ok({
+    id, desc: 'Blog post #'+ id,
+  })
+}

package/src/commands/templates/base/actions/index.get.ts

@@ -0,0 +1,5 @@
+import type { Req, Res } from 'duto'
+
+export async function handle(req: Req, res: Res) {
+  return res.ok({ message: 'Duto index' })
+}

package/src/commands/templates/base/configs/duto.ts

@@ -0,0 +1,11 @@
+export default {
+  docs: {
+    path: '/docs',
+    agent: false,
+    // auth: {
+    //   username: 'duto',
+    //   password: 'duto',
+    //   realm: 'Docs',
+    // },
+  }
+}

package/src/commands/templates/base/configs/roles.ts

@@ -0,0 +1,5 @@
+export default {
+  admin: '*',
+  user: [],
+  guest: [],
+}

package/src/commands/templates/base/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "$NAME",
+  "version": "0.0.0",
+  "private": true,
+  "main": ".duto/index.js",
+  "type": "module",
+  "dependencies": {
+    "cripta": "0.x",
+    "t0n": "0.x"
+  },
+  "devDependencies": {
+    "bun-types": "catalog:",
+    "duto": "workspace:*",
+    "typescript": "catalog:",
+    "wrangler": "catalog:"
+  },
+  "duto": {
+    "type": "server",
+    "platform": "workerd",
+    "dev": {
+      "port": 3000
+    }
+  }
+}

package/src/commands/templates/base/tsconfig.json

@@ -0,0 +1,42 @@
+{
+  "compilerOptions": {
+    "noEmit": true,
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022"],
+    "types": ["duto"],
+    "strict": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "skipLibCheck": true,
+    "allowJs": true,
+    "resolveJsonModule": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "useDefineForClassFields": false,
+    "rootDir": "./",
+    "paths": {
+      "@/*": [
+        "./*"
+      ]
+    }
+  },
+  "include": [
+    "actions",
+    "features",
+    "routes",
+    "configs",
+    "enums",
+    "libs",
+    "locales",
+    "middlewares",
+    "models",
+    "utils",
+    "tests/**/*"
+  ],
+  "exclude": [
+    ".duto",
+    "node_modules"
+  ]
+}