@tamyla/clodo-framework 4.2.0 → 4.3.0

package/CHANGELOG.md

@@ -1,46 +1,36 @@
-# [4.2.0](https://github.com/tamylaa/clodo-framework/compare/v4.1.0...v4.2.0) (2026-01-31)
-
-
-### Features
-
-* **validation:** integrate ConfigurationValidator into ValidationHandler; add post-generation validation in ServiceOrchestrator; tests ([#5](https://github.com/tamylaa/clodo-framework/issues/5)) ([2889864](https://github.com/tamylaa/clodo-framework/commit/28898641bac4c2d6d206e12dbba8216e1de386a3))
-
-# [4.1.0](https://github.com/tamylaa/clodo-framework/compare/v4.0.15...v4.1.0) (2026-01-31)
+# [4.3.0](https://github.com/tamylaa/clodo-framework/compare/v4.2.0...v4.3.0) (2026-02-01)
 
 
 ### Bug Fixes
 
-* **lint:** remove unnecessary escape in serviceName regex to satisfy no-useless-escape ([ac4dcda](https://github.com/tamylaa/clodo-framework/commit/ac4dcdabb39dda3dba3f4e06022f28936a53d645))
+* ensure programmatic feature normalization and DO middleware support are included ([e2e6867](https://github.com/tamylaa/clodo-framework/commit/e2e6867ed96f0619cfd3a07b117a49717c47ac68))
+* only include D1 binding in wrangler.toml when D1 feature enabled; adjust e2e assertion for forced validation report ([7a7b549](https://github.com/tamylaa/clodo-framework/commit/7a7b549aca3b8359ee76825b1bc64cb0815b35c1))
+* **wrangler:** emit KV and R2 bindings conditionally; add unit tests ([36702f3](https://github.com/tamylaa/clodo-framework/commit/36702f3146ce1f12fef6838010e20d2efbfed306))
 
 
 ### Features
 
-* **programmatic-service-api:** programmatic createService + configurable validation ([#4](https://github.com/tamylaa/clodo-framework/issues/4)) ([040f68b](https://github.com/tamylaa/clodo-framework/commit/040f68b9115b604b3f27d7baa14c63122494c5f3))
+* **generator:** emit Durable Object import/binding into middleware runtime when feature enabled ([22b9b14](https://github.com/tamylaa/clodo-framework/commit/22b9b14567038a0f7f73221f31925ee9a2066736))
+* normalize features (kv -> upstash) and add unit tests ([14e5a56](https://github.com/tamylaa/clodo-framework/commit/14e5a564b5cec4016ddbafd2b39e944eee74d40a))
 
-## [4.0.15](https://github.com/tamylaa/clodo-framework/compare/v4.0.14...v4.0.15) (2026-01-31)
+# [4.2.0](https://github.com/tamylaa/clodo-framework/compare/v4.1.0...v4.2.0) (2026-01-31)
 
 
-### Bug Fixes
+### Features
 
-* **lint:** remove unnecessary escape in semver regex ([72751bd](https://github.com/tamylaa/clodo-framework/commit/72751bdf9a98b2f6b1f97706b175ea31f3aa0df1))
+* **validation:** integrate ConfigurationValidator into ValidationHandler; add post-generation validation in ServiceOrchestrator; tests ([#5](https://github.com/tamylaa/clodo-framework/issues/5)) ([2889864](https://github.com/tamylaa/clodo-framework/commit/28898641bac4c2d6d206e12dbba8216e1de386a3))
 
-## [4.0.14](https://github.com/tamylaa/clodo-framework/compare/v4.0.13...v4.0.14) (2026-01-19)
+# [4.1.0](https://github.com/tamylaa/clodo-framework/compare/v4.0.15...v4.1.0) (2026-01-31)
 
 
 ### Bug Fixes
 
-* middleware packaging, generators, tests, and packaged-artifact smoke test ([b001434](https://github.com/tamylaa/clodo-framework/commit/b001434697da2145e8778b5c0afd02275cd1604e))
-* resolve Windows filesystem timing issues in tests ([7092ca6](https://github.com/tamylaa/clodo-framework/commit/7092ca6ffc230a19d25c96333c0313ead1739f15))
+* **lint:** remove unnecessary escape in serviceName regex to satisfy no-useless-escape ([ac4dcda](https://github.com/tamylaa/clodo-framework/commit/ac4dcda))
 
-## [4.0.13](https://github.com/tamylaa/clodo-framework/compare/v4.0.12...v4.0.13) (2025-12-17)
 
+### Features
 
-### Bug Fixes
-
-* collapse 4-level '../../../../lib/' imports to '../../../lib/' in dist ([e0a329e](https://github.com/tamylaa/clodo-framework/commit/e0a329e94390ddad37c7ccd8e6163410c874d7d0))
-* handle deeper dist/service-management imports pointing outside dist ([f70d63c](https://github.com/tamylaa/clodo-framework/commit/f70d63cc24571e9691fe900d6a8384ce7f040992))
-* resolve CHANGELOG.md merge conflict ([25a044d](https://github.com/tamylaa/clodo-framework/commit/25a044d0d4e2c8f674f777567de1d812c8b49cfa))
-* special-case generators/config deep lib import path ([cb74ab0](https://github.com/tamylaa/clodo-framework/commit/cb74ab0a9fb0958cae5065adc750377f751f0b21))
+* **programmatic-service-api:** programmatic createService + configurable validation ([#4](https://github.com/tamylaa/clodo-framework/issues/4)) ([040f68b](https://github.com/tamylaa/clodo-framework/commit/040f68b9115b604b3f27d7baa14c63122494c5f3))
 
 ## [4.0.10](https://github.com/tamylaa/clodo-framework/compare/v4.0.9...v4.0.10) (2025-12-10)
 
@@ -191,8 +181,14 @@ Benefits:
 * enable missing exports and remove lib-dependent modules from npm ([1645a58](https://github.com/tamylaa/clodo-framework/commit/1645a58d1e1f5d7126fd02766e9b4d006fa45be7))
 ## [Unreleased]
 
+### Features
+
+* **programmatic-service-api:** Improve programmatic createService parity and feature normalization. Programmatic payloads now normalize legacy and plural feature names (for example, `kv` → `upstash`, and `durableObjects` ↔ `durableObject`) and merge normalized features into confirmed configuration values. The service middleware generator now emits Durable Object imports/bindings into the generated middleware runtime when Durable Objects are enabled. (refs: #6; commits: `14e5a56`, `7c0ce37`, `22b9b14`)
+
 ### Bug Fixes
 
+* **compatibility:** Accept legacy `kv` alias in payload validation and normalize to `upstash` to preserve backward compatibility with older programmatic payloads. (commits: `14e5a56`, `52b8090`)
+* **durable objects:** Accept `durableObjects` plural in allowed feature enums and ensure generated middleware includes Durable Object imports/bindings when enabled; fixed E2E parity tests. (commits: `779040c`, `22b9b14`)
 * Fix import paths in `dist/` to ensure packaged artifact resolves internal modules correctly (fixed `wrangler-deployer` and `WranglerTomlGenerator`).
 * Add `scripts/utilities/check-dist-imports.js` and `scripts/utilities/test-packaged-artifact.js` and include packaged-artifact smoke test in release workflow.
 

package/dist/config/service-schema-config.js

@@ -3,7 +3,7 @@
 
 let config = {
   serviceTypes: ['api-service', 'data-service', 'worker', 'pages', 'gateway', 'generic'],
-  features: ['d1', 'upstash', 'r2', 'pages', 'ws', 'durableObject', 'cron', 'metrics']
+  features: ['d1', 'upstash', 'kv', 'r2', 'pages', 'ws', 'durableObject', 'durableObjects', 'cron', 'metrics']
 };
 export function getConfig() {
   return {
@@ -17,6 +17,6 @@ export function setConfig(updates = {}) {
 export function resetConfig() {
   config = {
     serviceTypes: ['api-service', 'data-service', 'worker', 'pages', 'gateway', 'generic'],
-    features: ['d1', 'upstash', 'r2', 'pages', 'ws', 'durableObject', 'cron', 'metrics']
+    features: ['d1', 'upstash', 'kv', 'r2', 'pages', 'ws', 'durableObject', 'durableObjects', 'cron', 'metrics']
   };
 }

package/dist/service-management/ServiceOrchestrator.js

@@ -13,6 +13,7 @@ import { ConfirmationHandler } from './handlers/ConfirmationHandler.js';
 import { GenerationHandler } from './handlers/GenerationHandler.js';
 import { WranglerConfigManager } from '../utils/deployment/wrangler-config-manager.js';
 import { ValidationHandler } from './handlers/ValidationHandler.js';
+import { normalizeFeatures } from '../validation/payloadNormalization.js';
 
 // Legacy imports for backward compatibility
 import { ErrorTracker } from './ErrorTracker.js';
@@ -126,7 +127,24 @@ export class ServiceOrchestrator {
     };
     try {
       // Generate derived confirmations and run generation
-      const confirmedValues = await this.confirmationHandler.generateAndConfirm(coreInputs);
+      let confirmedValues = await this.confirmationHandler.generateAndConfirm(coreInputs);
+
+      // Respect features passed in the programmatic payload by merging them into confirmedValues
+      if (payload.features && Array.isArray(payload.features)) {
+        // Normalize features (e.g., accept legacy 'kv' alias and enable provider flags like 'upstash')
+        payload.features = normalizeFeatures(payload.features);
+        const featureMap = payload.features.reduce((acc, f) => ({
+          ...acc,
+          [f]: true
+        }), {});
+        confirmedValues = {
+          ...confirmedValues,
+          features: {
+            ...(confirmedValues.features || {}),
+            ...featureMap
+          }
+        };
+      }
       const generationResult = await this.generationHandler.generateService(coreInputs, confirmedValues, {
         outputPath: options.outputDir || this.outputPath,
         middlewareStrategy: this.middlewareStrategy

package/dist/service-management/generators/code/ServiceMiddlewareGenerator.js

@@ -140,7 +140,13 @@ export function registerMiddleware(registry, serviceName) {
     this.logger.info(`Generated: ${filePath}`);
 
     // Also generate a lightweight runtime helper for middleware composition and registry
-    const runtimeContent = `// Lightweight middleware runtime for generated services
+    let runtimeContent = '';
+
+    // If Durable Objects are enabled (support both singular/plural feature names), inject DO imports/bindings
+    if (confirmedValues.features && (confirmedValues.features.durableObjects || confirmedValues.features.durableObject)) {
+      runtimeContent += `// Durable Object imports and bindings\nimport { DurableObject } from '@cloudflare/workers-types';\nexport const DURABLE_OBJECT = { type: 'durable_object', className: 'MyDurableObject' };\n\n`;
+    }
+    runtimeContent += `// Lightweight middleware runtime for generated services
 export const MiddlewareRegistry = (() => {
   const map = new Map();
   return {

package/dist/service-management/generators/config/WranglerTomlGenerator.js

@@ -147,6 +147,34 @@ export class WranglerTomlGenerator extends BaseGenerator {
       // Fall back to default configuration if detection fails
       console.warn(`⚠️  Wrangler compatibility detection failed, using defaults: ${error.message}`);
     }
+
+    // Only include D1/kv/r2 bindings when the confirmed values indicate features are enabled
+    const d1Block = confirmedValues.features && confirmedValues.features.d1 ? `
+
+# Database bindings
+[[d1_databases]]
+binding = "DB"
+database_name = "${confirmedValues.databaseName}"
+database_id = ""  # To be configured during setup
+` : '';
+
+    // Support both generic KV flag and provider-specific flag (upstash)
+    const kvEnabled = confirmedValues.features && (confirmedValues.features.kv || confirmedValues.features.upstash);
+    const kvBlock = kvEnabled ? `
+
+# KV namespaces
+[[kv_namespaces]]
+binding = "KV"
+namespace_id = ""  # To be configured during setup
+` : '';
+    const r2Block = confirmedValues.features && confirmedValues.features.r2 ? `
+
+# R2 buckets
+[[r2_buckets]]
+binding = "R2_STORAGE"
+bucket_name = "${confirmedValues.bucketName || confirmedValues.databaseName || ''}"
+bucket_id = ""  # To be configured during setup
+` : '';
     return `# Cloudflare Workers Configuration for ${confirmedValues.displayName}
 name = "${confirmedValues.workerName}"
 main = "src/worker/index.js"
@@ -169,12 +197,7 @@ name = "${confirmedValues.workerName}-staging"
 [env.production]
 name = "${confirmedValues.workerName}"
 
-# Database bindings
-[[d1_databases]]
-binding = "DB"
-database_name = "${confirmedValues.databaseName}"
-database_id = ""  # To be configured during setup
-
+${d1Block}${kvBlock}${r2Block}
 # Environment variables
 [vars]
 SERVICE_NAME = "${coreInputs.serviceName}"

package/dist/service-management/generators/utils/ServiceManifestGenerator.js

@@ -13,10 +13,17 @@ export class ServiceManifestGenerator {
    * @returns {Object} Service manifest
    */
   createManifest(coreInputs, confirmedValues, generatedFiles) {
+    // Derive explicit top-level feature booleans for quick manifest checks (e.g., D1/KV/R2)
+    const features = confirmedValues.features || {};
     return {
       manifestVersion: '1.0.0',
       frameworkVersion: '3.0.0',
       generatedAt: new Date().toISOString(),
+      // Top-level feature flags for ConfigurationValidator compatibility
+      d1: !!features.d1,
+      // kv may be represented via a provider flag (e.g., upstash) - accept either
+      kv: !!(features.kv || features.upstash),
+      r2: !!features.r2,
       service: {
         name: coreInputs.serviceName,
         displayName: confirmedValues.displayName,

package/dist/validation/payloadNormalization.js

@@ -0,0 +1,20 @@
+// Normalize feature arrays for consistent internal representation
+export function normalizeFeatures(featuresArray = []) {
+  if (!Array.isArray(featuresArray)) return [];
+  const normalized = new Set(featuresArray.map(f => f && String(f).trim()));
+
+  // Backwards compatibility: if 'kv' is present, ensure provider flag 'upstash' is also present
+  if (normalized.has('kv') && !normalized.has('upstash')) {
+    normalized.add('upstash');
+  }
+
+  // Durable Objects: accept both singular/plural variants for compatibility
+  if (normalized.has('durableObject') && !normalized.has('durableObjects')) {
+    normalized.add('durableObjects');
+  }
+  if (normalized.has('durableObjects') && !normalized.has('durableObject')) {
+    normalized.add('durableObject');
+  }
+  return Array.from(normalized);
+}
+export default normalizeFeatures;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tamyla/clodo-framework",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "Reusable framework for Clodo-style software architecture on Cloudflare Workers + D1",
   "type": "module",
   "sideEffects": [