@b9g/shovel 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -2,209 +2,51 @@
 
 All notable changes to Shovel will be documented in this file.
 
-## [0.2.0-beta.12] - 2026-01-14
+## [0.2.3] - 2026-02-02
 
-### Breaking Changes
-
-- **`shovel activate` command removed** - Use `shovel build --lifecycle` instead
-- **`loadServiceWorker()` removed** - Use `platform.serviceWorker.register()` instead
-- **`getEntryWrapper()` removed** - Use `getProductionEntryPoints()` instead
-
-### Build System Unification
-
-Major refactor of the build system to be platform-driven and unified across all commands.
+### Features
 
-- **New `ServerBundler` class** - Unified bundler replacing separate build/watch logic
-- **Platform-driven entry points** - Platforms define their output structure via `getProductionEntryPoints()`:
-  - Node/Bun: `{ index: "<supervisor>", worker: "<worker>" }` - two files
-  - Cloudflare: `{ worker: "<code>" }` - single file
-- **Deleted `activate` command** - Replaced with `shovel build --lifecycle` flag
-  - `--lifecycle` - runs activate stage (default)
-  - `--lifecycle install` - runs install stage only
+- **Enable code splitting for client-side bundles** - Dynamic imports in client scripts now create separate chunks instead of being inlined, allowing heavy dependencies to be lazy-loaded. ([#39](https://github.com/bikeshaving/shovel/pull/39), fixes [#38](https://github.com/bikeshaving/shovel/issues/38))
 
-### API Changes
+### Bug Fixes
 
-- **New `platform.serviceWorker.register()` API** - Mirrors browser's `navigator.serviceWorker.register()`
-- **Deleted `loadServiceWorker()`** - Use `serviceWorker.register()` instead
-- **New `platform.listen()` / `close()`** - Server lifecycle management
-- **New `runLifecycle()` and `dispatchRequest()`** - Public runtime utilities
+- **Use unique manifest keys for chunks** - Chunk files are now keyed by URL to avoid collisions when the same chunk appears in different assetBase directories.
 
-### Code Quality
+## [0.2.2] - 2026-01-30
 
-- Extracted `mergeConfigWithDefaults()` helper to reduce duplication
-- Added JSDoc to platform `create*` methods documenting defaults
-- Standardized import organization (node builtins → external → @b9g/* → relative)
-- Renamed `isDynamicCode` → `containsRuntimeExpressions` for clarity
+### Bug Fixes
 
-### Package Updates
+- **Fix asset manifest invalidation in dev mode** - Assets with new content hashes after client bundle changes no longer return 404. The root cause was build-time manifest resolution reading stale data from disk during rebuilds. ([#36](https://github.com/bikeshaving/shovel/pull/36), fixes [#35](https://github.com/bikeshaving/shovel/issues/35))
 
-- `@b9g/platform` → 0.1.14-beta.0
-- `@b9g/platform-node` → 0.1.14-beta.0
-- `@b9g/platform-bun` → 0.1.12-beta.0
-- `@b9g/platform-cloudflare` → 0.1.12-beta.0
+## [0.2.1] - 2026-01-28
 
-### Deleted Files
+### Improvements
 
-- `src/commands/activate.ts` - Replaced by `build --lifecycle`
-- `src/utils/watcher.ts` - Merged into `ServerBundler`
-- `src/plugins/shovel.ts` - Split into `config.ts` + `entry.ts`
-- `packages/platform/test/single-threaded.test.ts`
-- `SingleThreadedRuntime` class - All platforms now use `ServiceWorkerPool`
+- **Improved create-shovel UX** - Better templates and user experience for project scaffolding
 
----
+## [0.2.0] - 2026-01-28
 
-## [0.2.0-beta.11] - 2026-01-10
+This is a major release that establishes Shovel as a complete ServiceWorker-based meta-framework with locked-down APIs for core packages, a unified configuration system, and comprehensive platform support.
 
-### Changes since beta.10
-- **ESBuild configuration support (#18)** - Custom esbuild options in shovel.json
-- **Config expression syntax** - `$PORT || 3000`, `$DATABASE_URL ?? null`
-- **Null fallback fix** - Allow intentional null fallbacks in config expressions
-- **DatabaseStorage API redesign** - New open/get pattern with IndexedDB-style migrations
-- **Migrated from Drizzle to @b9g/zen** - Simpler, more portable database layer
-- **Logging DX improvements** - Better defaults, consolidated categories
-- **`impl` key unification** - Simplified resource configuration
-- **CI/lint enforcement** - ESLint and Prettier standardized
-- **Documentation** - Comprehensive docs for all APIs
+### Highlights
 
-### Package Updates
-- `@b9g/router` → 0.2.0-beta.1 (CORS middleware, trailingSlash moved)
-- `@b9g/node-webworker` → 0.2.0-beta.1 (CloseEvent, onclose, env option)
-- `@b9g/cache-redis` → 0.2.0-beta.1 (logger category fix)
-- `@b9g/assets` → 0.2.0-beta.0
-- `@b9g/async-context` → 0.2.0-beta.0
-- `@b9g/cache` → 0.2.0-beta.0
-- `@b9g/http-errors` → 0.2.0-beta.0
-- `@b9g/match-pattern` → 0.2.0-beta.0
+- **Consistent Worker Execution Model** - ServiceWorker code always runs in a worker thread
+- **ESBuild Configuration Support** - Custom esbuild options in shovel.json
+- **Config Expression Syntax** - `$PORT || 3000`, `$DATABASE_URL ?? null`
+- **Comprehensive Logging System** - Built-in LogTape integration
+- **Database Storage API** - IndexedDB-style migrations with `self.databases`
+- **CORS Middleware** - New middleware in `@b9g/router/middleware`
+- **Unified Build System** - New `ServerBundler` class, platform-driven entry points
 
----
-
-## [0.2.0-beta.10] - Previous Beta
+### Breaking Changes
 
-This is a major release that establishes Shovel as a complete ServiceWorker-based meta-framework. The 0.2.0 beta introduces locked-down APIs for core packages, a unified configuration system, and comprehensive platform support.
+- `self.buckets` renamed to `self.directories`
+- `shovel activate` command removed - Use `shovel build --lifecycle` instead
+- `loadServiceWorker()` removed - Use `platform.serviceWorker.register()` instead
+- `@b9g/router` trailingSlash middleware moved to `@b9g/router/middleware`
+- `self.loggers.get()` now takes an array: `self.loggers.get(["app", "db"])`
 
-### Breaking Changes
+### CLI
 
-- **`self.buckets` renamed to `self.directories`** - The file system API now uses `directories` to align with web standards terminology
-- **`@b9g/router` middleware moved** - `trailingSlash` middleware moved from main export to `@b9g/router/middleware`
-- **`self.loggers.get()` signature changed** - Now takes an array: `self.loggers.get(["app", "db"])` instead of dot notation
-- **Config `module`/`export` unified to `impl`** - Resource configurations now use a single `impl` key for reified implementations
-
-### New Features
-
-#### Consistent Worker Execution Model (#17)
-ServiceWorker code now ALWAYS runs in a worker thread, never the main thread. This ensures:
-- Same globals/environment in dev and prod (eliminates mode-only bugs)
-- Worker isolation preserved
-- Simplified mental model
-
-#### ESBuild Configuration Support (#18)
-Custom ESBuild options can now be specified in `shovel.json`:
-```json
-{
-  "esbuild": {
-    "external": ["lightningcss"],
-    "define": { "DEBUG": "true" }
-  }
-}
-```
-
-#### Config Expression Syntax
-Environment variables and expressions in `shovel.json`:
-```json
-{
-  "port": "$PORT || 3000",
-  "databases": {
-    "main": {
-      "url": "$DATABASE_URL"
-    }
-  }
-}
-```
-
-#### Comprehensive Logging System
-- Built-in LogTape integration with console sink by default
-- Configurable sinks (file, OpenTelemetry, Sentry, etc.)
-- Category-based log levels
-- `shovel` category logs at `info` level by default
-
-#### Database Storage API
-New `self.databases` API with IndexedDB-style migrations:
-```typescript
-self.addEventListener("activate", (event) => {
-  event.waitUntil(
-    databases.open("main", 2, (e) => {
-      e.waitUntil(e.db.exec`CREATE TABLE users (...)`);
-    })
-  );
-});
-
-// In fetch handlers
-const db = databases.get("main");
-const users = await db.all`SELECT * FROM users`;
-```
-
-#### CORS Middleware
-New CORS middleware in `@b9g/router/middleware`:
-```typescript
-import { cors } from "@b9g/router/middleware";
-router.use(cors({ origin: "https://example.com" }));
-```
-
-### Package Updates
-
-#### Locked at 0.2.0-beta.0 (API stable)
-- `@b9g/async-context` - AsyncContext polyfill
-- `@b9g/match-pattern` - URLPattern implementation
-- `@b9g/assets` - Static asset pipeline with content hashing
-- `@b9g/cache` - Cache API implementation (memory, postmessage)
-- `@b9g/http-errors` - HTTP error classes
-
-#### Updated to 0.2.0-beta.1
-- `@b9g/router` - Added CORS middleware, moved trailingSlash to /middleware
-- `@b9g/node-webworker` - Added CloseEvent, onclose handler, env option
-- `@b9g/cache-redis` - Logger category updates
-
-#### Still Evolving (0.1.x)
-- `@b9g/platform` - Core runtime and platform abstraction
-- `@b9g/platform-bun` - Bun platform adapter
-- `@b9g/platform-node` - Node.js platform adapter
-- `@b9g/platform-cloudflare` - Cloudflare Workers adapter
-- `@b9g/filesystem` - File System Access API implementation
-- `@b9g/filesystem-s3` - S3 filesystem adapter
-
-### CLI Changes
-
-- `shovel develop` - Development server with hot reload (note: `dev` alias removed)
-- `shovel build` - Production build (use `--lifecycle` flag to run lifecycle events)
-- Removed `--verbose` flags (use logging config instead)
-
-### Infrastructure
-
-- Migrated from Drizzle ORM to `@b9g/zen` for database operations
-- Added GitHub Actions CI with parallel test execution
-- ESLint and Prettier configuration standardized
-- Comprehensive test suites with `bun:test`
-
-### Documentation
-
-New documentation pages:
-- Getting Started guide
-- CLI reference
-- Configuration (shovel.json) reference
-- Deployment guide
-- ServiceWorker lifecycle
-- Routing and middleware
-- Storage APIs (databases, caches, directories)
-- Cookies and AsyncContext
-
----
-
-## [0.1.x] - Previous Releases
-
-Initial development releases establishing core architecture:
-- ServiceWorker-based request handling
-- Platform abstraction layer
-- Router with generator-based middleware
-- Cache API implementations
-- File System Access API
-- Hot reload in development
+- `shovel develop` - Development server with hot reload
+- `shovel build` - Production build with `--lifecycle` flag for lifecycle events

package/README.md

@@ -69,7 +69,9 @@ Your code uses standards. Shovel makes them work everywhere.
 
 ## Meta-Framework
 
-Shovel is a meta-framework: it provides and implements primitives rather than opinions. Instead of dictating how you build, it gives you portable building blocks that work everywhere.
+Shovel is a meta-framework: it generates bundles and compiles your code with ESBuild.
+You write code, and it runs in development and production with the exact same APIs.
+Shovel takes care of single file bundle requirements, and transpiling JSX/TypeScript.
 
 ## True Portability
 

package/bin/cli.js

@@ -75,7 +75,7 @@ program.command("develop <entrypoint>").description("Start development server wi
   DEFAULTS.WORKERS
 ).option("--platform <name>", "Runtime platform (node, cloudflare, bun)").action(async (entrypoint, options) => {
   checkPlatformReexec(options);
-  const { developCommand } = await import("../src/_chunks/develop-UJ7PMMOM.js");
+  const { developCommand } = await import("../src/_chunks/develop-6DPQE5H4.js");
   await developCommand(entrypoint, options, config);
 });
 program.command("build <entrypoint>").description("Build app for production").option("--platform <name>", "Runtime platform (node, cloudflare, bun)").option(
@@ -83,7 +83,7 @@ program.command("build <entrypoint>").description("Build app for production").op
   "Run ServiceWorker lifecycle after build (install or activate, default: activate)"
 ).action(async (entrypoint, options) => {
   checkPlatformReexec(options);
-  const { buildCommand } = await import("../src/_chunks/build-QZE6GNRD.js");
+  const { buildCommand } = await import("../src/_chunks/build-BM4A74RI.js");
   await buildCommand(entrypoint, options, config);
   process.exit(0);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b9g/shovel",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "ServiceWorker-first universal deployment platform. Write ServiceWorker apps once, deploy anywhere (Node/Bun/Cloudflare). Registry-based multi-app orchestration.",
   "license": "MIT",
   "bin": {

package/src/_chunks/{build-QZE6GNRD.js → build-BM4A74RI.js}

@@ -1,7 +1,7 @@
 import {
   ServerBundler,
   loadPlatformModule
-} from "./chunk-LVKYX67O.js";
+} from "./chunk-WVHECOTO.js";
 import {
   findProjectRoot,
   findWorkspaceRoot

package/src/_chunks/{chunk-LVKYX67O.js → chunk-WVHECOTO.js}

@@ -98,6 +98,7 @@ function assetsPlugin(options = {}) {
           let content;
           let outputExt = ext;
           let mimeType;
+          let chunkFiles = [];
           if (needsTranspilation) {
             const defaultPlugins = [
               NodeModulesPolyfillPlugin(),
@@ -111,11 +112,12 @@ function assetsPlugin(options = {}) {
               entryPoints: [args.path],
               bundle: true,
               format: "esm",
+              splitting: true,
               target: ["es2022", "chrome90"],
               platform: "browser",
               write: false,
               minify: true,
-              // outdir is required for esbuild to know where to put extracted CSS
+              // outdir is required for esbuild to know where to put extracted CSS and chunks
               outdir: outDir,
               // Apply polyfills and user-provided build options
               plugins,
@@ -152,10 +154,10 @@ function assetsPlugin(options = {}) {
               outputExt = ".css";
               mimeType = "text/css";
             } else {
-              const jsOutput = result.outputFiles.find(
+              const jsOutputFiles = result.outputFiles.filter(
                 (f) => f.path.endsWith(".js")
               );
-              if (!jsOutput) {
+              if (jsOutputFiles.length === 0) {
                 return {
                   errors: [
                     {
@@ -164,9 +166,30 @@ function assetsPlugin(options = {}) {
                   ]
                 };
               }
-              content = Buffer.from(jsOutput.text);
+              const entryBaseName = name + ".js";
+              const entryFile = jsOutputFiles.find(
+                (f) => basename(f.path) === entryBaseName
+              );
+              if (!entryFile) {
+                return {
+                  errors: [
+                    {
+                      text: `Could not find entry file ${entryBaseName} in output`
+                    }
+                  ]
+                };
+              }
+              content = Buffer.from(entryFile.text);
               outputExt = ".js";
               mimeType = "application/javascript";
+              for (const file of jsOutputFiles) {
+                if (file === entryFile)
+                  continue;
+                chunkFiles.push({
+                  filename: basename(file.path),
+                  content: Buffer.from(file.text)
+                });
+              }
             }
           } else if (needsCSSBundling) {
             const entryPath = args.path;
@@ -274,6 +297,23 @@ function assetsPlugin(options = {}) {
           }
           const outputPath = join(outputDir, filename);
           writeFileSync(outputPath, content);
+          for (const chunk of chunkFiles) {
+            const chunkPath = join(outputDir, chunk.filename);
+            writeFileSync(chunkPath, chunk.content);
+            const chunkUrl = `${basePath}${chunk.filename}`;
+            const chunkHash = createHash("sha256").update(chunk.content).digest("hex").slice(0, HASH_LENGTH);
+            manifest.assets[chunkUrl] = {
+              source: chunk.filename,
+              output: chunk.filename,
+              url: chunkUrl,
+              hash: chunkHash,
+              size: chunk.content.length,
+              type: "application/javascript"
+            };
+            if (sharedManifest) {
+              sharedManifest.assets[chunkUrl] = manifest.assets[chunkUrl];
+            }
+          }
           const sourcePath = relative(process.cwd(), args.path);
           const manifestEntry = {
             source: sourcePath,
@@ -475,6 +515,12 @@ function createAssetsManifestPlugin(projectRoot, outDir = "dist", sharedManifest
         namespace: "shovel-assets"
       }));
       build2.onLoad({ filter: /.*/, namespace: "shovel-assets" }, () => {
+        if (sharedManifest) {
+          return {
+            contents: `export default ${MANIFEST_PLACEHOLDER};`,
+            loader: "js"
+          };
+        }
         if (existsSync2(manifestPath)) {
           try {
             const manifest = JSON.parse(readFileSync2(manifestPath, "utf8"));

package/src/_chunks/{develop-UJ7PMMOM.js → develop-6DPQE5H4.js}

@@ -1,7 +1,7 @@
 import {
   ServerBundler,
   loadPlatformModule
-} from "./chunk-LVKYX67O.js";
+} from "./chunk-WVHECOTO.js";
 import {
   DEFAULTS
 } from "./chunk-NZVIBZYG.js";