@tamyla/clodo-framework 4.0.2 → 4.0.3

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [4.0.3](https://github.com/tamylaa/clodo-framework/compare/v4.0.2...v4.0.3) (2025-12-08)
+
+
+### Bug Fixes
+
+* Export CLI utilities to enable framework CLI commands ([35f1701](https://github.com/tamylaa/clodo-framework/commit/35f1701653ebe01b8fe41d184d2b88dac4c5b8d4))
+
 ## [4.0.2](https://github.com/tamylaa/clodo-framework/compare/v4.0.1...v4.0.2) (2025-12-08)
 
 

package/dist/lib/shared/cloudflare/ops.js

@@ -207,10 +207,30 @@ export async function deployWorker(env = 'production') {
     throw new Error(`Worker deployment failed after retries: ${error.message}`);
   }
 }
-export async function deploySecret(key, value, env = 'production') {
+export async function deploySecret(key, value, env = 'production', options = {}) {
+  const {
+    apiToken,
+    accountId,
+    scriptName
+  } = options;
+
+  // Use API-based operation if credentials provided
+  if (apiToken && accountId && scriptName) {
+    const {
+      CloudflareAPI
+    } = await import('@tamyla/clodo-framework/utils/cloudflare');
+    const cf = new CloudflareAPI(apiToken);
+    await cf.putWorkerSecret(accountId, scriptName, key, {
+      text: value
+    });
+    return;
+  }
+
+  // Fallback to CLI-based operation
   const command = process.platform === 'win32' ? `powershell -Command "Write-Output '${value}' | npx wrangler secret put ${key} --env ${env}"` : `echo "${value}" | npx wrangler secret put ${key} --env ${env}`;
   try {
-    await executeWithRateLimit(command, 'workers', 3); // Lower retries for secrets
+    // Increase retries for secrets due to higher timeout likelihood
+    await executeWithRateLimit(command, 'workers', 5);
   } catch (error) {
     throw new Error(`Secret deployment failed: ${error.message}`);
   }

package/dist/lib/shared/deployment/workflows/interactive-database-workflow.js

@@ -21,9 +21,11 @@ export class InteractiveDatabaseWorkflow {
   /**
    * @param {Object} options - Configuration options
    * @param {Array} options.rollbackActions - Array to track rollback actions
+   * @param {boolean} options.dryRun - Dry run mode
    */
   constructor(options = {}) {
     this.rollbackActions = options.rollbackActions || [];
+    this.dryRun = options.dryRun || false;
   }
 
   /**
@@ -197,6 +199,18 @@ export class InteractiveDatabaseWorkflow {
   async createNewDatabase(name, interactive = true, credentials = {}) {
     console.log(`\n🆕 Creating new database: ${name}`);
 
+    // Check dry-run mode
+    if (this.dryRun) {
+      console.log('   🔍 DRY RUN: Would create database but skipping actual creation');
+      return {
+        name,
+        id: 'dry-run-database-id',
+        created: false,
+        reused: false,
+        dryRun: true
+      };
+    }
+
     // Log which method will be used
     if (credentials.apiToken && credentials.accountId) {
       console.log('   ℹ️  Using Cloudflare API for database creation');

package/dist/lib/shared/deployment/workflows/interactive-deployment-coordinator.js

@@ -68,10 +68,13 @@ export class InteractiveDeploymentCoordinator {
         configCache: null // TODO: Add config cache if available
       }),
       databaseWorkflow: new InteractiveDatabaseWorkflow({
-        interactive: true
+        interactive: true,
+        dryRun: this.options.dryRun
       }),
       secretWorkflow: new InteractiveSecretWorkflow({
-        interactive: true
+        interactive: true,
+        dryRun: this.options.dryRun,
+        credentials: this.options.credentials
       }),
       validation: new InteractiveValidationWorkflow({
         interactive: true
@@ -170,9 +173,10 @@ export class InteractiveDeploymentCoordinator {
   async configureSecrets() {
     console.log('🔐 Phase 3: Configuring Secrets & Credentials');
     console.log('─'.repeat(50));
-    const workerName = `${this.deploymentState.config.domain}-data-service`;
+    const workerName = this.deploymentState.config.worker?.name || `${this.deploymentState.config.domain}-data-service`;
     this.deploymentState.resources.secrets = await this.workflows.secretWorkflow.handleSecretManagement(this.deploymentState.config.domain, this.deploymentState.config.environment, workerName, {
-      interactive: true
+      interactive: true,
+      credentials: this.deploymentState.config.credentials
     });
     console.log('✅ Secrets configuration complete\n');
   }

package/dist/lib/shared/deployment/workflows/interactive-domain-info-gatherer.js

@@ -101,7 +101,16 @@ export class InteractiveDomainInfoGatherer {
     }
     const confirmWorkerConfig = await askYesNo('Is this worker configuration correct?', 'y');
     if (!confirmWorkerConfig) {
-      config.worker.name = await askUser('Enter custom worker name', config.worker.name);
+      let customWorkerName = await askUser('Enter custom worker name', config.worker.name);
+
+      // Validate worker name - should not be a full URL
+      if (customWorkerName.includes('.') || customWorkerName.includes('/') || customWorkerName.includes('://')) {
+        console.log('   ⚠️  Worker name should be just the name, not a full URL');
+        console.log('   💡 Example: "my-service" not "my-service.workers.dev"');
+        customWorkerName = customWorkerName.split('.')[0]; // Extract just the first part
+        console.log(`   🔧 Using extracted name: ${customWorkerName}`);
+      }
+      config.worker.name = customWorkerName;
       config.worker.url = `https://${config.worker.name}.tamylatrading.workers.dev`;
       console.log(`\n✅ Updated worker configuration`);
     }

package/dist/lib/shared/deployment/workflows/interactive-secret-workflow.js

@@ -21,9 +21,13 @@ export class InteractiveSecretWorkflow {
   /**
    * @param {Object} options - Configuration options
    * @param {Array} options.rollbackActions - Array to track rollback actions
+   * @param {boolean} options.dryRun - Dry run mode
+   * @param {Object} options.credentials - Cloudflare credentials
    */
   constructor(options = {}) {
     this.rollbackActions = options.rollbackActions || [];
+    this.dryRun = options.dryRun || false;
+    this.credentials = options.credentials || {};
   }
 
   /**
@@ -161,6 +165,12 @@ export class InteractiveSecretWorkflow {
    */
   async deploySecrets(secrets, workerName, environment, interactive = true) {
     console.log('\n☁️ Deploying secrets to Cloudflare Workers...');
+
+    // Check dry-run mode
+    if (this.dryRun) {
+      console.log(`   🔍 DRY RUN: Would deploy ${Object.keys(secrets).length} secrets to worker '${workerName}' but skipping actual deployment`);
+      return;
+    }
     if (interactive) {
       const deployConfirmed = await askYesNo(`Deploy ${Object.keys(secrets).length} secrets to worker '${workerName}'?`, 'y');
       if (!deployConfirmed) {
@@ -170,7 +180,11 @@ export class InteractiveSecretWorkflow {
     for (const [key, value] of Object.entries(secrets)) {
       console.log(`   🔑 Deploying ${key}...`);
       try {
-        await deploySecret(key, value, environment);
+        await deploySecret(key, value, environment, {
+          apiToken: this.credentials?.token,
+          accountId: this.credentials?.accountId,
+          scriptName: workerName
+        });
         console.log(`      ✅ ${key} deployed`);
 
         // Add to rollback actions

package/dist/utils/cloudflare/api.js

@@ -242,6 +242,22 @@ export class CloudflareAPI {
     }));
   }
 
+  /**
+   * Put a secret for a worker
+   * @param {string} accountId - Account ID
+   * @param {string} scriptName - Worker script name
+   * @param {string} secretName - Secret name
+   * @param {Object} secretValue - Secret value object with 'text' property
+   * @returns {Promise<Object>} API response
+   */
+  async putWorkerSecret(accountId, scriptName, secretName, secretValue) {
+    const data = await this.request(`/accounts/${accountId}/workers/scripts/${scriptName}/secrets/${secretName}`, {
+      method: 'PUT',
+      body: JSON.stringify(secretValue)
+    });
+    return data;
+  }
+
   /**
    * List D1 databases for an account
    * @param {string} accountId - Account ID

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tamyla/clodo-framework",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "description": "Reusable framework for Clodo-style software architecture on Cloudflare Workers + D1",
   "type": "module",
   "sideEffects": [
@@ -100,6 +100,7 @@
     "check:bundle": "node scripts/utilities/check-bundle.js || echo 'Bundle check passed'",
     "check:imports": "node scripts/utilities/check-import-paths.js",
     "check:all": "npm run type-check && npm run test",
+    "diagnose": "node scripts/framework-diagnostic.js",
     "analyze:bundle": "echo 'Bundle analysis not implemented yet'",
     "docs": "echo 'JSDoc documentation generation not configured yet'",
     "validate": "npm run check:all",