duto 0.260906.0 → 0.260915.0

package/README.md

@@ -1,25 +1,47 @@
-<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
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "duto",
   "description": "All-in-one serverless framework for web artisans",
-  "version": "0.260906.0",
+  "version": "0.260915.0",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.d.ts",
@@ -25,6 +25,10 @@
     "./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",
@@ -38,7 +42,6 @@
     "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",
@@ -50,6 +53,7 @@
     "preact-render-to-string": "^6.6.6",
     "quansync": "^0.2.11",
     "t0n": "0.x",
+    "vite": "^8.0.0",
     "wouter-preact": "^3.10.0",
     "wrangler": "^4.128.0",
     "zod": "^4.3.6",
@@ -57,7 +61,9 @@
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20260113.0",
-    "@types/node": "^26.4.1",
+    "@minify-html/node": "^0.18.1",
+    "@preact/preset-vite": "^2.10.5",
+    "@tailwindcss/vite": "^4.3.1",
     "bun-types": "^1.4.0",
     "typescript": "^5.9.3"
   },

package/src/cli.ts

@@ -16,21 +16,20 @@ global.__st = performance.now()
 
 import { join } from 'pathe'
 import { cli } from 't0n/cli'
-import { Envir } from 't0n'
+import { setEnv } from 't0n'
 import { version } from '!/package.json'
 import { _root, _duto } from './utils'
 
-let commands = {
-  // new:
-  // upgrade:
-}
+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.')
 
-  Envir.set('duto', pkg.duto)
+  setEnv('duto', pkg.duto)
   commands = (await import(join(_duto, pkg.duto.type, 'cli')))?.default
 } catch {}
 
@@ -38,5 +37,9 @@ cli({
   name: 'duto',
   description: 'Duto',
   version,
-  commands,
+  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"
+  ]
+}

package/src/commands/templates/workerd/wrangler.toml

@@ -0,0 +1,47 @@
+name = "duto-api"
+main = ".duto/index.js"
+compatibility_date = "2026-08-06"
+
+# workers_dev = false
+# preview_urls = false
+no_bundle = true
+send_metrics = false
+compatibility_flags = [ "no_nodejs_compat", "no_nodejs_compat_v2" ]
+
+# route = "example.com"
+# route = { pattern = "api.example.com", custom_domain = true }
+
+# [[routes]]
+# pattern = "api.example.com/*"
+# zone_name = "example.com"
+# [[routes]]
+# pattern = "api.example.com"
+# custom_domain = true
+
+# [observability]
+# enabled = true
+# head_sampling_rate = 0.1 # 10% of requests are logged
+
+# PAID
+# [limits]
+# # The maximum CPU time allowed per invocation, in milliseconds
+# cpu_ms = 100
+
+# Bindings (KV, D1, R2..)
+# kv_namespaces = []
+# d1_databases = []
+
+# [[d1_databases]]
+# binding = "SCRIPT_NAME"
+# database_name = "DB_NAME"
+# database_id = "DB_UUID"
+# preview_database_id = "PREVIEW_UUID"
+# migrations_table = "MIGRATION_TABLE_NAME"
+# migrations_dir = "migrations/sql"
+# persist_to = "./.wrangler/state"
+
+# [env.production]
+# name = "rajt-api-prod"
+
+# [vars]
+# API_HOST = "api.example.com"

package/src/commands/upgrade.ts

@@ -0,0 +1,30 @@
+import { command } from 't0n/cli'
+import { dim, green } from 't0n/color'
+import { event, error, step, log, rn } from 't0n/log'
+import { _root } from '@/utils'
+import { version } from '!/package.json'
+
+import { createSpinner } from 'nanospinner'
+
+export default command({
+	meta: {
+		name: 'upgrade',
+		description: '📄 Upgrade to latest version of Duto\n',
+	},
+  async run({ args }) { // @ts-ignore
+    const spinner = createSpinner('Upgrading...').start()
+
+    const proc = Bun.spawn(['bun', 'update', '-g', 'duto'], { stdout: 'ignore', stderr: 'ignore' })
+    const exitCode = await proc.exited
+
+    if (exitCode === 0) {
+      spinner.success({ text: 'Upgraded' })
+    } else {
+      spinner.error({ text: `Falha ao atualizar duto (exit ${exitCode})` })
+      process.exit(exitCode)
+    }
+
+    event(green('Congrats!') + ` You're already on the latest version of Duto.`)
+    // event(green('Congrats!') + ` You're already on the latest version of Duto ${dim(`(which is v${version})`)}`)
+	},
+})

package/src/index.ts

@@ -1,7 +1,12 @@
+export * from './pages'
+
 export { default as Response } from './server/response'
-export { default as Config } from './server/config'
+export * from './server/config'
 
-export { Enum, Envir } from 't0n'
+export {
+  Enum,
+  Envir, hasEnv, getEnv, setEnv, addEnv, removeEnv
+} from 't0n'
 export type { EnumStatic, EnumValue, EnumType } from 't0n'
 
 export type {