webspresso 0.0.112 → 0.0.114

package/README.md

@@ -153,6 +153,31 @@ app.listen(PORT, () => {
 });
 ```
 
+### 5. Client Behavior Controller (`pages/notes.client.ts`)
+
+Co-locate reactive client logic right next to `pages/notes.njk` (`<div data-w-controller="notes">`) with automatic bundling and server-import boundary protection:
+
+```typescript
+import { defineController } from 'webspresso/client';
+
+export default defineController({
+  state: () => ({ title: '', saving: false }),
+  actions: {
+    async create(ctx) {
+      if (!ctx.state.title.trim()) return;
+      ctx.state.saving = true;
+      try {
+        await ctx.api.post('/api/notes', { title: ctx.state.title });
+        ctx.state.title = '';
+        await ctx.fragments.invalidate('notes'); // Refresh SSR fragments tagged with "notes"
+      } finally {
+        ctx.state.saving = false;
+      }
+    },
+  },
+});
+```
+
 ---
 
 ## ⚡ High-Performance Architecture (Cold Start & AOT)
@@ -202,6 +227,7 @@ Detailed topic guides are available in the repository:
 
 - **[Installation & First App](docs/getting-started/installation.md)** — Node.js requirements, setup, and first steps.
 - **[File-Based Routing & API Routes](.agents/ROUTING.md)** — Routing conventions, parameters, and cascading layouts.
+- **[Client Behavior & SSR Fragments](docs/guides/client-behavior.md)** — `defineController`, `defineFragment`, forms, and auto-revalidation.
 - **[SSR Streaming & Chunked Transfer](.agents/STREAMING.md)** — Out-of-order slots, `_loading.njk` skeletons, and TTFB optimization.
 - **[Database & ORM Guide](.agents/ORM.md)** — Repositories, relations, soft deletes, and ambient transactions.
 - **[Dual Authentication System](.agents/AUTH.md)** — Sessions, JWT rotation, magic links, and device management.

package/bin/commands/admin-password.js

@@ -3,13 +3,7 @@
  * Reset admin user password via CLI
  */
 
-let _inquirer;
-const inquirer = {
-  prompt: (...args) => {
-    if (!_inquirer) _inquirer = require('inquirer');
-    return _inquirer.prompt(...args);
-  },
-};
+const inquirer = require('../utils/prompt');
 const { loadDbConfig, createDbInstance } = require('../utils/db');
 
 function registerCommand(program) {

package/bin/commands/api.js

@@ -6,13 +6,7 @@
  * @module bin/commands/api
  */
 
-let _inquirer;
-const inquirer = {
-  prompt: (...args) => {
-    if (!_inquirer) _inquirer = require('inquirer');
-    return _inquirer.prompt(...args);
-  },
-};
+const inquirer = require('../utils/prompt');
 const fs = require('fs');
 const path = require('path');
 

package/bin/commands/new.js

@@ -3,13 +3,7 @@
  * Creates a new Webspresso project
  */
 
-let _inquirer;
-const inquirer = {
-  prompt: (...args) => {
-    if (!_inquirer) _inquirer = require('inquirer');
-    return _inquirer.prompt(...args);
-  },
-};
+const inquirer = require('../utils/prompt');
 const fs = require('fs');
 const path = require('path');
 

package/bin/commands/page.js

@@ -6,13 +6,7 @@
  * @module bin/commands/page
  */
 
-let _inquirer;
-const inquirer = {
-  prompt: (...args) => {
-    if (!_inquirer) _inquirer = require('inquirer');
-    return _inquirer.prompt(...args);
-  },
-};
+const inquirer = require('../utils/prompt');
 const fs = require('fs');
 const path = require('path');
 

package/bin/commands/seed.js

@@ -3,13 +3,7 @@
  * Run database seeders to populate database with fake data
  */
 
-let _inquirer;
-const inquirer = {
-  prompt: (...args) => {
-    if (!_inquirer) _inquirer = require('inquirer');
-    return _inquirer.prompt(...args);
-  },
-};
+const inquirer = require('../utils/prompt');
 const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');

package/bin/commands/service.js

@@ -5,13 +5,7 @@
  */
 
 const path = require('path');
-let _inquirer;
-const inquirer = {
-  prompt: (...args) => {
-    if (!_inquirer) _inquirer = require('inquirer');
-    return _inquirer.prompt(...args);
-  },
-};
+const inquirer = require('../utils/prompt');
 const { resolveDbConfigIfExists, createDbInstance } = require('../utils/db');
 
 /**

package/bin/utils/prompt.js

@@ -0,0 +1,17 @@
+/**
+ * Shared lazy ESM loader for Inquirer v13+ in CommonJS CLI commands.
+ */
+let _inquirer;
+
+const inquirer = {
+  async prompt(...args) {
+    if (!_inquirer) {
+      const mod = await import('inquirer');
+      _inquirer = mod.default || mod;
+    }
+    return _inquirer.prompt(...args);
+  },
+};
+
+module.exports = inquirer;
+

package/core/cache/tagged-lru.js

@@ -165,14 +165,18 @@ class TaggedLruCache {
   set(key, value, options = {}) {
     const tags = normalizeTags(options.tags);
 
-    // If key already had tags, clean them up first before assigning new tags
+    // Clear previous tags before lru.set so stale tags never survive if lru.set rejects (e.g. > maxBytes)
     if (this.keyToTags.has(key)) {
       this._removeKeyFromTags(key);
     }
 
-    this._addKeyToTags(key, tags);
+    // Run lru.set first so any internal _removeEntry('delete') on overwrite fires onEvict BEFORE we bind new tags
     this.lru.set(key, value, options);
 
+    if (tags.length > 0 && this.lru.has(key)) {
+      this._addKeyToTags(key, tags);
+    }
+
     return this;
   }
 
@@ -290,7 +294,9 @@ class TaggedLruCache {
       if (this.keyToTags.has(key)) {
         this._removeKeyFromTags(key);
       }
-      this._addKeyToTags(key, tags);
+      if (tags.length > 0 && this.lru.has(key)) {
+        this._addKeyToTags(key, tags);
+      }
     }
     return val;
   }