Repository navigation
Releases
v1.2.6 - Security Hardening, Monorepo Workspaces & Enhanced Rollbacks
Security
- Project Root Deployment Protection:
validateDistDirectoryinsrc/core/config.tsandsrc/core/deployer.tsstrictly rejects deploying the repository or project root (dist_path: "."), requiring a genuine build output directory to prevent inadvertent deployment of source code,.git,.envfiles, andnode_modules.- Guarded root
index.htmlfallback insrc/core/detector.tsso detected bundler frameworks (Vite, Nuxt, Next.js, Astro, SvelteKit, Remix, Angular) never fall back todist_path: ".".
- Sensitive File Exclusion in Archiver:
- Added
isSensitiveArchiveEntryinsrc/core/archiver.tsto strictly filter out.env*,.git,.github,.gitlab,.vscode,node_modules, and credentials even if accidentally placed inside the distribution directory.
- Added
- OAuth PKCE Loopback Hardening:
- Non-OAuth loopback requests (e.g.
/favicon.ico, root/, network scanners) insrc/client/pkce-auth.tsnow return HTTP 404 rather than stalling or triggering invalid token exchanges. - Exchange authorization code for tokens before rendering the browser success page, ensuring OAuth failures display immediate errors in the browser.
- Active and idle HTTP sockets are cleanly closed with
closeIdleConnectionsto prevent dangling process listeners.
- Non-OAuth loopback requests (e.g.
- Credential Sanitization in Error Reporting:
KodallNodeClientstrips HTTP Basic Auth credentials from target URLs in error messages and logs.
- Secret Stripping on Environment Duplication:
cloneEnvironmentinsrc/core/env-manager.tsstripsapi_key,token, and secrets when duplicating environments unless explicitly overridden.
Added
- HTTP DELETE Method:
- Added
client.delete()toKodallNodeClientsupporting automatic handling of HTTP 204 No Content responses.
- Added
- Cookie Store Eviction:
- Added
deleteCookie()method toCookieStoreinsrc/client/cookie-store.ts.
- Added
Fixed
- Monorepo Ancestor Workspace Resolution:
src/core/pm-detector.tstraverses ancestor directories up to the filesystem root to identify monorepo workspace roots (pnpm-workspace.yaml,turbo.json,lerna.json, root lockfiles), resolving package managers when executing from nested package folders.
- Cookie Header Parsing & Expiration:
- Fixed cookie corruption when
Set-Cookieheaders contain RFC 1123 HTTP dates with commas without splitting single cookies into invalid fragments. - Automatically prune expired cookies (
Max-Age=0or pastExpires).
- Fixed cookie corruption when
- Nuxt / Nitro DevProxy Path Duplication:
- Configured
prependPath: falseinsrc/core/proxy-helpers.ts(getNitroProxy) to prevent Nitro from duplicating route prefixes.
- Configured
- Proxy Header & Compression Forwarding:
- Stripped
content-encodingandcontent-lengthheaders increateNextProxyHandlerwhen upstream bodies are already decompressed byfetch. - Filtered hop-by-hop headers (
connection,keep-alive,transfer-encoding,upgrade) increateNitroProxyHandlerNode proxying. - Added dynamic
rule.rewriteingetDevProxywheninstanceUrlcontains subpaths (e.g.https://host.com/subpath).
- Stripped
- Rollback Engine & History Integrity:
- Rollback updates both
id_storage_file_versionandid_storage_fileto keep server entity state consistent. - Fixed rollback history to record metadata safely without overwriting commit hashes.
- Added support for negative step syntax (e.g.
-R -1or--steps 2). - Added support for comma-separated environment strings (
-e dev,staging) in rollback and status commands.
- Rollback updates both
- CLI Argument Parsing & Command Routing:
- Handled options preceding subcommands (e.g.
kodall-deploy -c custom.json use devor--config foo.json build). - Fixed
--buildflag routing during deployment commands (-e dev --build) so it does not intercept as standalonebuildsubcommand. - Handled short options with equals syntax (e.g.
-e=dev,-t=prod,-R=137). - Handled bare
--add-env,--update-env, and--edit-envopening interactive prompts without throwing argument parsing errors.
- Handled options preceding subcommands (e.g.
- Headless & Non-Interactive CI Safety:
- Added headless guards across interactive commands (
envs,use,set-default,add-env,remove-env,clone-env,manage-envs,rollback,init) to fail fast with code 1 instead of hanging on piped input or CI runners. - Added 5-second timeout in
src/commands/auth-probe.tsto prevent hanging on unreachable instances.
- Added headless guards across interactive commands (
- UI Prompts & Stream Robustness:
- Handled stream
close/endevents inaskTextandaskPassword. - Ignored ANSI escape sequences in
askPassword. - Restored terminal cursor on
SIGINT/exitinaskSelect. - Unrefed background spinner timer intervals to prevent blocking process termination.
- Handled stream
- CI Template Generator:
- Configured
pnpm/action-setup@v4before Node setup in generated GitHub Actions workflows. - Added
KODALL_INSTANCEsecret variables in Jenkinsfile and AWS CodeBuild templates.
- Configured
- Status Dashboard Query Syntax:
- Converted SQL queries in
src/commands/status.tsto Kodall query syntax (FILTER AND (...)) and forwarded CLI API keys.
- Converted SQL queries in
v1.2.5 - Nuxt Live Proxy Reload & Dynamic Route Adapters
Added
- Dynamic Nitro / Nuxt Server Proxy Handlers:
- Exported
createNitroProxyHandlerandcreateNuxtProxyHandlerfor zero-restart dynamic per-request proxying in Nuxt 3/4 server routes (server/routes/[...proxy].tsorserver/middleware/proxy.ts). - Supports streaming Node
http/httpsand Web StandardRequest/Responsefetch proxying with real-time environment resolution.
- Exported
Fixed
- Nuxt Dev Proxy Live Reload & Active-Environment Watching:
- Updated
kodallProxyNuxtmodule to auto-watch.kodall-deploy/active-envand.kodall-deploy/alongsidekodall-webapp.config.json. - Added Nuxt
builder:watchhook to trigger immediate dev server restart whennpx kodall-deploy use <env>or--clear-activeis executed.
- Updated
v1.2.4 - Smart Build Commands & PM Auto-Detection
Added
- Dedicated
kodall-deploy buildCLI Runner:- Run framework and package-manager aware project builds standalone via
kodall-deploy buildorkodall-deploy --build. - Added
Build web application (run build script)action directly to the main interactive CLI menu (npx kodall-deploy). - Supports custom build command overrides via
--build-cmd <cmd>or positional arguments. - Verifies target output folder (e.g.
./dist/index.htmlor./.output/public/index.html) after execution and provides framework-specific tips.
- Run framework and package-manager aware project builds standalone via
- Zero-Configuration-Drift Package Manager Detection:
- Dynamically auto-detects
pnpm,yarn,bun, andnpmat runtime from CorepackpackageManageror project lockfiles. - Avoids hardcoding package manager prefixes (
npm run,pnpm, etc.) insidekodall-webapp.config.json.
- Dynamically auto-detects
- Smart Script References & Interactive Filtering:
- Config files store clean
package.jsonscript name references (e.g."build","generate","generate:prod"). - Interactive selection lists in
--init,--add-env, andbuildautomatically filter out non-build lifecycle and dev scripts (dev,start,serve,preview,test,lint,postinstall,deploy). - Nuxt static generation scripts (
generate,generate:dev,generate:staging,generate:prod) are automatically detected and prioritized at the top of selection menus. - Prompts offer automatic persistence to
kodall-webapp.config.jsonwhen running builds interactively.
- Config files store clean
- Environment Management Aliases:
- Added
--update-env [name]and--edit-env [name]as direct CLI aliases for--add-env.
- Added
- Programmatic API Exports:
- Exported
resolveBuildCommand,formatCommandOrScript,getAvailableBuildScripts,resolvePackageManager,getRunScriptCommand, andgetExecCommand.
- Exported
v1.2.3 - Multi-Framework Dev Proxies & Modular CLI Architecture
Highlights in v1.2.3
- **Multi-Framework Dev Proxies**: Native adapters for Nuxt 3/4 (`kodallProxyNuxt`), Next.js App Router
(createNextProxyHandler), Webpack DevServer (kodallProxyWebpack), and Angular CLI (kodallProxyAngular).
- Live Proxy Switching: Dynamic per-request proxy routing during npm run dev with zero server restarts
required.
- Local Proxy State Isolation: kodall-deploy use <env> now saves local overrides to .kodall-deploy/active- env without dirtying kodall-webapp.config.json in git.
- New Commands: --set-default <env>, --clear-active, and enhanced -l / --list-envs indicators.
- Modular CLI Architecture & 100% Test Coverage: Complete refactor into modular command suites with 320+ unit
and integration tests.
[Read the Full Documentation →](https://docs.kodall.io)
v1.2.2 - Native Vite Dev Proxy Plugin & Environment Switcher
### Highlights in v1.2.2
- **Native Vite Plugin**: Added `kodallProxy` / `@kodall/kodall-deploy/plugin/vite` for automated dev proxy
configuration in Vite projects.
- Programmatic Proxy Resolution: Added getDevProxy and resolveProxyConfig.
- CLI Switcher: Added kodall-deploy use [env] and kodall-deploy switch [env].
- Security: Hardened URL and path sanitization to prevent traversal and malformed target instances.
v1.2.1 - Dual Module Packaging & CLI Bin Fixes
### Highlights in v1.2.1
- Dual ESM/CJS build outputs with TypeScript declarations (`.d.ts` / `.d.cts`).
- Binary entrypoint alignment for `kodall-deploy` and `one-deploy` CLI commands.
v1.2.0 - TypeScript Rewrite, Multi-Environment & CI/CD Generator
Added
- TypeScript Rewrite & Rebrand to
@kodall/kodall-deploy: Migrated and upgraded from legacyone-deploy/kodall-one-deploycodebase into modern TypeScript package. - Multi-Environment Configuration:
- Configuration schema supporting
environments: { dev, staging, prod, ... }inkodall-webapp.config.json. - Batch deployments with
--all,--type <type>, and comma-separated-e dev,staging. - Automatic migration from legacy
.one-deploy.jsonconfiguration files.
- Configuration schema supporting
- Live Remote Status Dashboard (
--status):- Real-time HTTP health check, latency measurement, active storage ID, and entity key inspection across instances.
- Deployment History & Instant Rollback:
- Local deployment audit log (
.kodall-deploy/history.json). - Server-side rollback and
web_app_log/storage_file_versionquerying for Kodall instances>= 1.8.0.
- Local deployment audit log (
- 1-Click OAuth 2.0 / OpenID Connect PKCE Login:
- Automatic detection of OpenID Connect authentication endpoints.
- Interactive browser-based authentication flow capturing and caching access tokens.
- Multi-environment batch deployment realm session reuse (one login per realm).
- CI/CD Pipeline Generator:
- Interactive
kodall-deploy --init-cicommand. - Support for 7 CI/CD platforms: GitHub Actions, GitLab CI, Bitbucket Pipelines, Jenkins, Azure DevOps, CircleCI, AWS CodeBuild.
- Interactive
- Framework Auto-Detection:
- Automatic detection of Vite, Next.js, Nuxt, Angular, Astro, SvelteKit, React, Vue projects and build output directories.
- Pre-Deployment Build Verification:
- Stale build detection comparing source files against build artifact timestamps.
- Post-deployment live HTTP health check ping.