Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
115 changes: 115 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,121 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.16.0] - 2026-01-19

### Added

- Signed config and signature support for HMAC authentication in Web CLI
- ISO8601 UTC timestamps and sequence numbers to long-running commands
- `--show-others` flag to `channels presence enter` command
- Multi-room support to `rooms messages subscribe` command
- Time-based filtering flags to `rooms messages history` command

### Changed

- Reorganized logs commands for better discoverability and removed channel-lifecycle duplication
- Standardized naming conventions across commands (BREAKING CHANGE - see migration notes below)
- Standardized success confirmation messages for create operations
- Confirmation prompts now accept both 'y' and 'yes' for better user experience
- History limit defaults now consistent between channels and rooms commands

### Fixed

- Web CLI auto-connect detection with signed config in rate limiter
- Web CLI consistent secret priority and domain-scoped credential clearing
- App ID resolution now only matches on name, preventing incorrect matches
- Queues delete command error handling
- channels/presence/enter no longer unnecessarily calls presence.get
- rooms list JSON error handling
- Inconsistent exit codes - now ensures non-zero on all errors
- rooms occupancy get no longer forces process.exit(0)

### Migration Notes

#### Breaking Changes: Standardized Command Parameter Naming

To improve consistency and clarity across the CLI, we've standardized parameter names in several commands. If you have scripts or automation that use these commands, please update them accordingly:

**Parameter Naming Changes:**
- `apps delete [ID]``apps delete [APPID]` - Now explicitly uses `APPID` for clarity
- `integrations delete RULEID``integrations delete INTEGRATIONID` - More accurately reflects that integrations are not rules
- `queues delete QUEUENAME``queues delete QUEUEID` - Changed to use ID instead of name for consistency

**Command Changes:**
- `rooms messages subscribe ROOM``rooms messages subscribe ROOMS` - Now supports multiple rooms (space-separated)
- Logs commands reorganized:
- `apps logs` commands moved to `logs` top-level
- Removed duplicate channel-lifecycle commands from channels namespace
- All log commands now consistently under `logs` namespace

**What You Need to Do:**

If you're using any of these commands in scripts or CI/CD pipelines:
1. Update parameter names to match the new conventions
2. Update command paths for reorganized logs commands
3. Test your scripts to ensure they work with the new naming

**Example Updates:**

```bash
# Before (0.15.x)
ably apps delete my-app-123
ably integrations delete rule-456
ably queues delete my-queue-name
ably rooms messages subscribe my-room

# After (0.16.0)
ably apps delete my-app-123 # APPID parameter
ably integrations delete integration-456 # INTEGRATIONID parameter
ably queues delete queue-id-789 # QUEUEID parameter
ably rooms messages subscribe room1 room2 # Multiple rooms supported
```

The interactive CLI will continue to guide you through the correct parameter names, but programmatic usage should be updated to match the new conventions.

### Migration Notes

#### Breaking Changes: Standardized Command Parameter Naming

To improve consistency and clarity across the CLI, we've standardized parameter names in several commands. If you have scripts or automation that use these commands, please update them accordingly:

**Parameter Naming Changes:**
- `apps delete [ID]``apps delete [APPID]` - Now explicitly uses `APPID` for clarity
- `integrations delete RULEID``integrations delete INTEGRATIONID` - More accurately reflects that integrations are not rules
- `queues delete QUEUENAME``queues delete QUEUEID` - Changed to use ID instead of name for consistency

**Command Changes:**
- `rooms messages subscribe ROOM``rooms messages subscribe ROOMS` - Now supports multiple rooms (space-separated)
- Logs commands reorganized:
- `apps logs` commands moved to `logs` top-level
- Removed duplicate channel-lifecycle commands from channels namespace
- All log commands now consistently under `logs` namespace

**What You Need to Do:**

If you're using any of these commands in scripts or CI/CD pipelines:
1. Update parameter names to match the new conventions
2. Update command paths for reorganized logs commands
3. Test your scripts to ensure they work with the new naming

**Example Updates:**

```bash
# Before (0.15.x)
ably apps delete my-app-123
ably integrations delete rule-456
ably queues delete my-queue-name
ably rooms messages subscribe my-room

# After (0.16.0)
ably apps delete my-app-123 # APPID parameter
ably integrations delete integration-456 # INTEGRATIONID parameter
ably queues delete queue-id-789 # QUEUEID parameter
ably rooms messages subscribe room1 room2 # Multiple rooms supported
```

The interactive CLI will continue to guide you through the correct parameter names, but programmatic usage should be updated to match the new conventions.

## [0.15.0] - 2025-12-03

### Added
Expand Down
Loading
Loading