fix: default rediss:// to standalone TLS, make cluster mode opt-in

[noamsuissa01]

Summary

rediss:// (TLS) URLs no longer force ioredis.Cluster mode. The previous behavior crashed the app on every non-clustered TLS Redis/Valkey provider with ClusterAllFailedError: Failed to refresh slots cache. Cluster mode is now opt-in via sails.config.redis_cluster_mode = true.

Breaking Changes

• Default for rediss:// is now standalone mode. Set sails.config.redis_cluster_mode = true (env: sails_redis_cluster_mode=true) to restore the old cluster behavior.
• TLS cert verification defaults to true (was hardcoded false). Set sails.config.redis_tls_reject_unauthorized = false if needed.

Provider Compatibility

Provider	Mode needed
DigitalOcean Managed Valkey	standalone (default)
Redis Cloud Essentials	standalone (default)
Upstash	standalone (default)
AWS ElastiCache (non-cluster)	standalone (default)
Azure Redis Basic/Standard	standalone (default)
Azure Redis Premium (clustered)	redis_cluster_mode: true
AWS ElastiCache (cluster mode)	redis_cluster_mode: true

Changes

• New sails.config.redis_cluster_mode option — opt-in for clustered deployments
• New sails.config.redis_tls_reject_unauthorized option — configurable TLS cert verification
• Extracted attachKueMethods() helper — eliminates duplication between standalone and cluster paths
• Split monolithic SSL handler into createStandaloneClient() and createClusterClient()
• Updated README with full config docs and breaking changes section
• Version bump: 0.0.12 → 0.1.0

How to Test

Standalone TLS (new default)

// config/env/production.js
module.exports = {
  redis_url: 'rediss://user:pass@your-managed-redis:25061/0',
};

Expect logs: Kue Redis: using ioredis standalone with TLS → Kue Redis standalone connected → Kue Redis standalone ready

Cluster TLS (opt-in)

module.exports = {
  redis_url: 'rediss://user:pass@your-clustered-redis:6380/0',
  redis_cluster_mode: true,
};

Expect logs: Kue Redis: using ioredis Cluster with TLS → Kue Redis Cluster connected → Kue Redis Cluster ready

Plain Redis (unchanged)

module.exports = {
  redis_url: 'redis://localhost:6379',
};

No change in behavior — URL passed directly to kue.

🤖 Generated with Claude Code