https://github.com/vaguul/social-feed-inputs
Zemiax helpers by Vaguul for normalizing social feed inputs and resolving feed URLs.
https://github.com/vaguul/social-feed-inputs
alerts feeds reddit rss social social-feeds twitch typescript vaguul youtube zemiax
Last synced: 19 days ago
JSON representation
Zemiax helpers by Vaguul for normalizing social feed inputs and resolving feed URLs.
- Host: GitHub
- URL: https://github.com/vaguul/social-feed-inputs
- Owner: vaguul
- License: mit
- Created: 2026-03-20T23:05:16.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-31T22:03:37.000Z (20 days ago)
- Last Synced: 2026-06-01T00:22:35.520Z (20 days ago)
- Topics: alerts, feeds, reddit, rss, social, social-feeds, twitch, typescript, vaguul, youtube, zemiax
- Language: TypeScript
- Homepage:
- Size: 17.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# social-feed-inputs
Helpers to normalize user input and resolve feed URLs for social alert systems, maintained by Vaguul under the Zemiax personal software studio.
## Supported cases
- YouTube channel IDs and feed URLs
- Twitch logins and channel URLs
- Reddit subreddits and users
- generic RSS-backed social sources
## Provider support matrix
| Provider input | Stored provider | Accepted input example | Normalized output example |
| --- | --- | --- | --- |
| YouTube | `youtube` | `UC_x5XG1OV2P6uZZ5FSM9Ttw` | `https://www.youtube.com/feeds/videos.xml?channel_id=UC_x5XG1OV2P6uZZ5FSM9Ttw` |
| Twitch | `twitch` | `https://www.twitch.tv/Shroud` | `https://api.twitch.tv/helix/streams?user_login=shroud` |
| Reddit subreddit | `reddit` | `https://www.reddit.com/r/typescript/?sort=new` | `https://www.reddit.com/r/typescript/new.json?limit=10&raw_json=1` |
| Generic RSS-backed source | `rss` | `https://example.com/feeds/announcements.xml` | `https://example.com/feeds/announcements.xml` |
## Normalization examples
### YouTube
- Valid input: `https://www.youtube.com/feeds/videos.xml?channel_id=UC_x5XG1OV2P6uZZ5FSM9Ttw`
- Stored provider: `youtube`
- Normalized feed URL: `https://www.youtube.com/feeds/videos.xml?channel_id=UC_x5XG1OV2P6uZZ5FSM9Ttw`
### Twitch
- Valid input: `https://www.twitch.tv/Shroud`
- Stored provider: `twitch`
- Normalized stream URL: `https://api.twitch.tv/helix/streams?user_login=shroud`
### Reddit subreddit
- Valid input: `r/typescript`
- Valid URL input: `https://www.reddit.com/r/typescript/?sort=new`
- Stored provider: `reddit`
- Normalized feed URL: `https://www.reddit.com/r/typescript/new.json?limit=10&raw_json=1`
### Generic RSS-backed sources
Use these providers when the source itself is not normalized by this package and
the caller already has a stable feed URL.
- Valid input label: `Instagram`
- Valid feed URL: `https://example.com/feeds/announcements.xml`
- Stored provider: `rss`
- Normalized feed URL: `https://example.com/feeds/announcements.xml`
Provider-specific parsers do not guess across unsupported domains. For example,
`https://example.com/r/typescript` is rejected as a subreddit input instead of
being treated as Reddit.
## Why this exists
Bots and dashboards often need the same input cleanup rules for social alerts. This package keeps the normalization and feed-resolution logic in one reusable place.
## Install
```bash
npm install
```
## Validate
```bash
npm run typecheck
npm test
```
## Maintenance
- Keep provider parsing deterministic and covered by tests.
- Do not add API keys, OAuth secrets, cookies, or live account data to fixtures.
- Update the README when a new provider or output shape is added.
## Author
Built and maintained by Vaguul for Zemiax.
## License
MIT