Feature: introduce space.details endpoint

[lekkerelou]

🔗 Related Issue

#416

❓ Type of Change

• 📖 Documentation (docs, README, or comments)
• 🐞 Bug fix (non-breaking fix for an issue)
• 👌 Enhancement (improvement to existing functionality)
• ✨ New feature (adds new functionality)
• 🧹 Chore (build, tooling, dependencies)
• ⚠️ Breaking change (affects existing usage)

📚 Description

This PR introduces a new member in the Rettiwt-API library for handling Twitter Spaces.

A new method space.details has been added, allowing users to retrieve information about a Space (whether it is currently live or has already taken place).

This improves Space management support within the API and makes it easier to access metadata such as title, host, state, and timing.

📝 Checklist

• Issue/discussion linked above.
• Documentation updated (if needed).
• Code follows project conventions and ESLint rules.
• No sensitive data or credentials are included.

[lekkerelou]

I've send the Commit so the CI can now pass.

[Rishikant181]

@lekkerelou There linting issues still. If possible, please fix that up and I'll test and merge this once I get back from work today.

[lekkerelou]

Should be good this time

[lekkerelou]

node dist/cli.js space details 1YqJDNEzvoVKV

{
    "id": "1YqJDNEzvoVKV",
    "state": "Ended",
    "title": "DIVE into DeepNode",
    "mediaKey": "28_2005645335054659585",
    "createdAt": "2025-12-29T14:21:25.603Z",
    "scheduledStart": "2025-12-30T17:00:00.000Z",
    "startedAt": "2025-12-30T17:00:07.627Z",
    "endedAt": "2025-12-30T18:00:44.466Z",
    "updatedAt": "2025-12-30T18:00:45.619Z",
    "creatorId": "1986491156507860994",
    "conversationControls": 0,
    "disallowJoin": false,
    "isEmployeeOnly": false,
    "isLocked": false,
    "isMuted": false,
    "isSpaceAvailableForClipping": false,
    "isSpaceAvailableForReplay": true,
    "noIncognito": false,
    "totalLiveListeners": 7418,
    "totalReplayWatched": 1559,
    "participantCount": 0,
    "participants": {
        "total": 0,
        "admins": [
            {
                "id": "1986491156507860994",
                "screenName": "DeepNodeAI",
                "displayName": "DeepNode AI",
                "avatarUrl": "https://pbs.twimg.com/profile_images/1990877535547113473/Pp9s30E3_normal.jpg",
                "isVerified": true,
                "isMutedByAdmin": false,
                "isMutedByGuest": false
            },
            {
                "id": "85686777",
                "screenName": "chinsanity",
                "displayName": "Chinsanity",
                "avatarUrl": "https://pbs.twimg.com/profile_images/1941978094996193280/tZtEDMRE_normal.jpg",
                "isVerified": true,
                "isMutedByAdmin": false,
                "isMutedByGuest": false
            }
        ],
        "speakers": [],
        "listeners": []
    }
}

[Rishikant181]

@lekkerelou Lgtm. Merging this now.