feat(bluesky): add live bluesky loader for real-time content collections (#91)

- Add liveBlueskyLoader for Astro's experimental Live Content Collections
- Support real-time data fetching using AT Protocol's getPosts method
- Flexible configuration with identifier in options or collection filter
- Comprehensive filtering: limit, date ranges, post types, identifier override
- Robust error handling with specific error codes and helpful messages
- Full TypeScript support with exported interfaces
- Configurable service URLs for custom Bluesky instances
- Complete demo site integration with live collection and individual post pages
- Comprehensive test suite with 67 tests covering all functionality
- Clean code organization with barrel exports separating build-time and live loaders

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <noreply@anthropic.com>

Author: ascorbic

.changeset/live-bluesky-loader.md

@@ -0,0 +1,62 @@
+---
+"@ascorbic/bluesky-loader": minor
+---
+
+# Add live Bluesky loader
+
+Adds `liveBlueskyLoader` for Astro's experimental Live Content Collections feature. This loader fetches Bluesky posts in real-time, complementing the existing build-time `authorFeedLoader`.
+
+The key difference is that while `authorFeedLoader` fetches data at build time for static generation, `liveBlueskyLoader` retrieves fresh content on-demand during server-side rendering or client-side navigation.
+
+## Getting Started
+
+### Prerequisites
+
+- Astro 5.10.0+ with experimental Live Content Collections enabled
+- `@ascorbic/bluesky-loader` package installed
+
+### Basic Usage
+
+Create a live collection in your `live.config.ts`:
+
+```typescript
+import { defineLiveCollection } from "astro:content";
+import { liveBlueskyLoader } from "@ascorbic/bluesky-loader";
+
+const liveBluesky = defineLiveCollection({
+  type: "live",
+  loader: liveBlueskyLoader({
+    identifier: "your-handle.bsky.social", // Optional: can also be set in filters
+    service: "https://public.api.bsky.app", // Optional: defaults to public API
+  }),
+});
+
+export const collections = { liveBluesky };
+```
+
+### Using in Pages
+
+Fetch posts in your Astro pages:
+
+```astro
+---
+import { getLiveCollection, getLiveEntry } from 'astro:content';
+
+// Get filtered posts
+const posts = await getLiveCollection('liveBluesky', (post) =>
+  post.data.record.text.includes('astro')
+);
+
+// Get a specific post by AT URI
+const post = await getLiveEntry('liveBluesky', 'at://did:plc:user/app.bsky.feed.post/id');
+---
+```
+
+## Features
+
+- Real-time data fetching using AT Protocol's `getPosts` method
+- Flexible configuration - set identifier globally or per-request
+- Filtering options: limit, date ranges, post types, and more
+- Error handling with specific error codes and helpful messages
+- Full TypeScript support with exported interfaces
+- Configurable service URLs for custom Bluesky instances

demos/loaders/src/content/config.ts demos/loaders/src/content.config.tsdemos/loaders/src/content/config.ts renamed to demos/loaders/src/content.config.ts

@@ -70,6 +70,7 @@ const spacecraft = defineCollection({
 const bluesky = defineCollection({
   loader: authorFeedLoader({
     identifier: "mk.gg",
+    limit: 100,
   }),
 });
 

demos/loaders/src/live.config.ts

@@ -1,11 +1,20 @@
-import { defineLiveCollection } from 'astro:content';
-import { liveFeedLoader } from '@ascorbic/feed-loader';
+import { defineLiveCollection } from "astro:content";
+import { liveFeedLoader } from "@ascorbic/feed-loader";
+import { liveBlueskyLoader } from "@ascorbic/bluesky-loader";
 
 const news = defineLiveCollection({
-  type: 'live',
+  type: "live",
   loader: liveFeedLoader({
-    url: 'https://feeds.bbci.co.uk/news/science_and_environment/rss.xml',
+    url: "https://feeds.bbci.co.uk/news/science_and_environment/rss.xml",
   }),
 });
 
-export const collections = { news };
+const liveBluesky = defineLiveCollection({
+  type: "live",
+  loader: liveBlueskyLoader({
+    identifier: "mk.gg",
+    service: "https://public.api.bsky.app",
+  }),
+});
+
+export const collections = { news, liveBluesky };

demos/loaders/src/pages/index.astro

@@ -16,8 +16,16 @@ const formatter = new Intl.DateTimeFormat("en-CA", {
 ---
 
 <Layout title="Releases">
-  <h2>Live News Feed</h2>
-  <p><a href="/news">BBC Science & Environment News (Live Feed Demo)</a></p>
+  <h2>Live Collections</h2>
+  <ul>
+    <li><a href="/news">BBC Science & Environment News (Live Feed Demo)</a></li>
+    <li><a href="/live-bluesky">Live Bluesky Posts (Real-time)</a></li>
+  </ul>
+  
+  <h2>Build-time Collections</h2>
+  <ul>
+    <li><a href="/bluesky">Bluesky Posts (Build-time)</a></li>
+  </ul>
 
   <h2>Spacecraft</h2>
   {