@ductape/mcp 0.1.42 → 0.1.43

package/dist/index.js

@@ -188,11 +188,20 @@ SETUP — register once in AppModule:
         accessKey: process.env.DUCTAPE_ACCESS_KEY,
         product: 'my-product',   // optional default — overridable per controller
         env: process.env.NODE_ENV === 'production' ? 'prd' : 'snd',
+        redisUrl: process.env.REDIS_URL,  // REQUIRED when using events.dispatch() or @Events.Dispatch
       }),
     ],
   })
   export class AppModule {}
 
+  IMPORTANT — redisUrl:
+    ALL *.dispatch() calls (actions.dispatch, features.dispatch, events.dispatch, databases.dispatch,
+    storage.dispatch, graph.dispatch, notifications.dispatch, messageBrokers.dispatch, quotas.dispatch,
+    fallback.dispatch, etc.) enqueue jobs via BullMQ, which requires a Redis connection.
+    Without redisUrl ANY dispatch() call throws "Queues not configured. dispatch() requires a queue connection."
+    Set REDIS_URL (e.g. redis://localhost:6379 or a managed Redis connection string) and pass it as redisUrl.
+    *.run(), events.produce(), and @Events.Consumer do NOT require Redis — only dispatch() does.
+
   // Async (e.g. pulling key from ConfigService):
   DuctapeModule.forRootAsync({
     imports: [ConfigModule],
@@ -201,6 +210,7 @@ SETUP — register once in AppModule:
       accessKey: cfg.get('DUCTAPE_ACCESS_KEY'),
       product: cfg.get('DUCTAPE_PRODUCT'),
       env: cfg.get('DUCTAPE_ENV'),
+      redisUrl: cfg.get('REDIS_URL'),  // required for dispatch
     }),
   })
 
@@ -258,7 +268,7 @@ FOR MESSAGING (events.produce / events.consume / events.dispatch):
     @Events.Produce({ event: 'broker-tag:topic-tag' })
     emitOrderCreated(payload: { orderId: string }) { return payload; }
 
-  Dispatch (scheduled or immediate) — static schedule in decorator:
+  Dispatch (scheduled or immediate) — REQUIRES redisUrl in DuctapeModule.forIntegration:
     @Events.Dispatch({ broker: 'order-events', event: 'order-events:order-created', schedule: { every: 60000 } })
     dispatchHeartbeat(payload: { message: { ping: boolean } }) { return payload; }
 
@@ -273,6 +283,7 @@ FOR MESSAGING (events.produce / events.consume / events.dispatch):
     }
     // method return takes precedence over decorator schedule; use sdk.events.dispatch() directly
     // when even the broker/event must vary at call time.
+    // ALL *.dispatch() calls require redisUrl — BullMQ over Redis. Without it dispatch throws.
 
   Consume (method decorator — method is called for each incoming message):
     @Events.Consumer({ event: 'order-events:order-created' })
@@ -491,7 +502,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   messageBrokers.delete   [product_tag, broker_tag]
   messageBrokers.topics.create  ← FORBIDDEN with publishable key. Use ductape_cli instead:
     ductape_cli("events topics create -f topic.json")
-    topic.json: { tag, name, broker, description?, sample?, idempotent?, queueUrls?: [{ env_slug, url }] }
+    topic.json: { tag: "broker-tag:topic-tag", name, description?, sample?, idempotent?, queueUrls?: [{ env_slug, url }] }
   ← Always required before consuming. For SQS: must include queueUrls per env.
   ← For Pub/Sub, Kafka, RabbitMQ, Redis, NATS: the first produce call auto-registers the topic,
      but you should still create it explicitly so consumers can subscribe before any produce occurs.
@@ -2456,12 +2467,11 @@ Import (register an EXISTING cloud resource):
 
   topic.json schema:
     {
-      "tag": "order-created",           // topic tag only — NOT "broker:topic"
+      "tag": "order-events:order-created",  // ALWAYS "broker-tag:topic-tag" — full event string
       "name": "Order Created",
-      "broker": "order-events",         // broker component tag
-      "description": "...",             // optional
+      "description": "...",                // optional
       "sample": { "orderId": "string", "total": 0 },  // expected message shape
-      "idempotent": false,              // optional — deduplicates by idempotency_key when true
+      "idempotent": false,                 // optional — deduplicates by idempotency_key when true
       // AWS SQS only — per-env queue URL:
       "queueUrls": [
         { "env_slug": "snd", "url": "https://sqs.us-east-1.amazonaws.com/123/queue-snd" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ductape/mcp",
-  "version": "0.1.42",
+  "version": "0.1.43",
   "description": "MCP server that exposes Ductape SDK operations via the backend proxy",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts

@@ -199,11 +199,20 @@ SETUP — register once in AppModule:
         accessKey: process.env.DUCTAPE_ACCESS_KEY,
         product: 'my-product',   // optional default — overridable per controller
         env: process.env.NODE_ENV === 'production' ? 'prd' : 'snd',
+        redisUrl: process.env.REDIS_URL,  // REQUIRED when using events.dispatch() or @Events.Dispatch
       }),
     ],
   })
   export class AppModule {}
 
+  IMPORTANT — redisUrl:
+    ALL *.dispatch() calls (actions.dispatch, features.dispatch, events.dispatch, databases.dispatch,
+    storage.dispatch, graph.dispatch, notifications.dispatch, messageBrokers.dispatch, quotas.dispatch,
+    fallback.dispatch, etc.) enqueue jobs via BullMQ, which requires a Redis connection.
+    Without redisUrl ANY dispatch() call throws "Queues not configured. dispatch() requires a queue connection."
+    Set REDIS_URL (e.g. redis://localhost:6379 or a managed Redis connection string) and pass it as redisUrl.
+    *.run(), events.produce(), and @Events.Consumer do NOT require Redis — only dispatch() does.
+
   // Async (e.g. pulling key from ConfigService):
   DuctapeModule.forRootAsync({
     imports: [ConfigModule],
@@ -212,6 +221,7 @@ SETUP — register once in AppModule:
       accessKey: cfg.get('DUCTAPE_ACCESS_KEY'),
       product: cfg.get('DUCTAPE_PRODUCT'),
       env: cfg.get('DUCTAPE_ENV'),
+      redisUrl: cfg.get('REDIS_URL'),  // required for dispatch
     }),
   })
 
@@ -269,7 +279,7 @@ FOR MESSAGING (events.produce / events.consume / events.dispatch):
     @Events.Produce({ event: 'broker-tag:topic-tag' })
     emitOrderCreated(payload: { orderId: string }) { return payload; }
 
-  Dispatch (scheduled or immediate) — static schedule in decorator:
+  Dispatch (scheduled or immediate) — REQUIRES redisUrl in DuctapeModule.forIntegration:
     @Events.Dispatch({ broker: 'order-events', event: 'order-events:order-created', schedule: { every: 60000 } })
     dispatchHeartbeat(payload: { message: { ping: boolean } }) { return payload; }
 
@@ -284,6 +294,7 @@ FOR MESSAGING (events.produce / events.consume / events.dispatch):
     }
     // method return takes precedence over decorator schedule; use sdk.events.dispatch() directly
     // when even the broker/event must vary at call time.
+    // ALL *.dispatch() calls require redisUrl — BullMQ over Redis. Without it dispatch throws.
 
   Consume (method decorator — method is called for each incoming message):
     @Events.Consumer({ event: 'order-events:order-created' })
@@ -502,7 +513,7 @@ ALL params are passed as a JSON array in positional order matching the SDK signa
   messageBrokers.delete   [product_tag, broker_tag]
   messageBrokers.topics.create  ← FORBIDDEN with publishable key. Use ductape_cli instead:
     ductape_cli("events topics create -f topic.json")
-    topic.json: { tag, name, broker, description?, sample?, idempotent?, queueUrls?: [{ env_slug, url }] }
+    topic.json: { tag: "broker-tag:topic-tag", name, description?, sample?, idempotent?, queueUrls?: [{ env_slug, url }] }
   ← Always required before consuming. For SQS: must include queueUrls per env.
   ← For Pub/Sub, Kafka, RabbitMQ, Redis, NATS: the first produce call auto-registers the topic,
      but you should still create it explicitly so consumers can subscribe before any produce occurs.
@@ -2529,12 +2540,11 @@ Import (register an EXISTING cloud resource):
 
   topic.json schema:
     {
-      "tag": "order-created",           // topic tag only — NOT "broker:topic"
+      "tag": "order-events:order-created",  // ALWAYS "broker-tag:topic-tag" — full event string
       "name": "Order Created",
-      "broker": "order-events",         // broker component tag
-      "description": "...",             // optional
+      "description": "...",                // optional
       "sample": { "orderId": "string", "total": 0 },  // expected message shape
-      "idempotent": false,              // optional — deduplicates by idempotency_key when true
+      "idempotent": false,                 // optional — deduplicates by idempotency_key when true
       // AWS SQS only — per-env queue URL:
       "queueUrls": [
         { "env_slug": "snd", "url": "https://sqs.us-east-1.amazonaws.com/123/queue-snd" },