chore: initial commit

.gitignore

···
+tangled-rss

LICENSE

···
+The MIT License (MIT)
+
+Copyright (c) 2025 boB Rudis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

···
+# Tangled RSS
+
+## Overview
+
+Tangled RSS is a simple application that generates RSS feeds for [Tangled.sh](https://tangled.sh) repositories, making it easy to follow updates from specific users on the Bluesky network. It works by resolving Bluesky handles to DIDs, fetching all records from a user's Tangled repository, and generating an RSS feed.
+
+## Features
+
+- Convert Bluesky handles to RSS feeds for Tangled repositories
+- Sort entries by date (most recent first)
+- Properly escaped XML output
+- Simple API interface
+
+## Installation
+
+You'll need [Deno](https://deno.land) installed on your system.
+
+1. Clone this repository
+2. Navigate to the project directory
+
+## Usage
+
+### Running the application
+
+```bash
+# Start the application
+just start
+
+# Run in development mode with auto-reload
+just dev
+
+# Build a standalone executable
+just build
+```
+
+### API Endpoints
+
+Access RSS feeds by making a GET request to:
+
+```
+http://localhost:8000/{bluesky_handle}
+```
+
+For example:
+```
+http://localhost:8000/alice.bsky.social
+```
+
+### Environment Variables
+
+- `PORT`: The port on which the server will run (default: 8000)
+
+## How It Works
+
+1. The application takes a Bluesky handle as input
+2. Resolves the handle to a DID using Bluesky's API
+3. Fetches the DID document from PLC directory
+4. Uses the service endpoint to retrieve all Tangled repositories
+5. Generates an RSS feed with the repositories sorted by date
+
+## Development
+
+This application is built with:
+- [Deno](https://deno.land) - A secure JavaScript and TypeScript runtime
+- [Hono](https://hono.dev) - A lightweight web framework
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

deno.json

···
+{
+  "imports": {
+    "hono": "jsr:@hono/hono@^4.7.5"
+  },
+  "tasks": {
+    "start": "deno run --allow-net main.ts",
+    "dev": "deno run --watch --allopw-env --allow-net main.ts",
+    "build": " deno compile --allow-net --allow-env --output tangled-rss main.ts"
+  },
+  "compilerOptions": {
+    "jsx": "precompile",
+    "jsxImportSource": "hono/jsx"
+  }
+}

deno.lock

···
+{
+  "version": "4",
+  "specifiers": {
+    "jsr:@hono/hono@^4.7.5": "4.7.5"
+  },
+  "jsr": {
+    "@hono/hono@4.7.5": {
+      "integrity": "36a7e1b3db8a58e5dc2bd36a76be53346f0966e04c24c635c4d6f58875575b0a"
+    }
+  },
+  "workspace": {
+    "dependencies": [
+      "jsr:@hono/hono@^4.7.5"
+    ]
+  }
+}

justfile

···
+# Default task: list all available tasks
+default:
+    @just --list
+
+# Start the application
+start:
+    deno run --allow-net main.ts
+
+# Run the application in development mode with watching
+dev:
+    deno run --watch --allow-env --allow-net main.ts
+
+# Build the application into an executable
+build:
+    deno compile --allow-net --allow-env --output tangled-rss main.ts

main.ts

···
+import { Hono } from "hono";
+
+const app = new Hono();
+
+app.get("/:handle?", async (c) => {
+  const handle = c.req.param("handle");
+
+  if (!handle) {
+    return c.text("Please provide a Bluesky handle", 400);
+  }
+
+  try {
+    // Resolve handle to DID
+    const handleResolveResponse = await fetch(
+      `https://bsky.social/xrpc/com.atproto.identity.resolveHandle?handle=${handle}`,
+    );
+    const { did } = await handleResolveResponse.json();
+
+    // Fetch DID document
+    const didDocResponse = await fetch(`https://plc.directory/${did}`);
+    const didDoc = await didDocResponse.json();
+    const serviceEndpoint = didDoc.service[0].serviceEndpoint;
+
+    // Fetch all records
+    const allRecords = await fetchAllRecords(serviceEndpoint, did);
+
+    // Generate RSS feed
+    const selfUrl = new URL(c.req.url).toString();
+    const rssFeed = generateRSSFeed(handle, allRecords, selfUrl);
+
+    return new Response(rssFeed, {
+      headers: {
+        "Content-Type": "application/xml; charset=utf-8",
+      },
+    });
+  } catch (error: any) {
+    const msg = (error as Error).message;
+    return c.text(`Error processing request: ${msg}`, 500);
+  }
+});
+
+async function fetchAllRecords(serviceEndpoint: string, did: string): Promise<any[]> {
+  const allRecords: any[] = [];
+  let cursor = "";
+
+  while (true) {
+    const url = new URL(`${serviceEndpoint}/xrpc/com.atproto.repo.listRecords`);
+    url.searchParams.set("repo", did);
+    url.searchParams.set("collection", "sh.tangled.repo");
+    url.searchParams.set("limit", "100");
+    if (cursor) url.searchParams.set("cursor", cursor);
+
+    const response = await fetch(url.toString());
+    const data = await response.json();
+
+    if (!data.records || data.records.length === 0) break;
+
+    allRecords.push(...data.records);
+    cursor = data.cursor || "";
+
+    if (!cursor) break;
+  }
+
+  return allRecords.sort((a, b) => new Date(b.value.addedAt).getTime() - new Date(a.value.addedAt).getTime());
+}
+
+function escapeXml(unsafe: string): string {
+  return unsafe.replace(/[<>&'"]/g, function (c) {
+    switch (c) {
+      case "<":
+        return "&lt;";
+      case ">":
+        return "&gt;";
+      case "&":
+        return "&amp;";
+      case "'":
+        return "&apos;";
+      case '"':
+        return "&quot;";
+      default:
+        return c;
+    }
+  });
+}
+
+function generateRSSFeed(handle: string, records: any[], selfUrl: string): string {
+  const rssItems = records
+    .map((record) => {
+      const { name, description, addedAt } = record.value;
+      const itemLink = `https://tangled.sh/@${handle}/${name}`;
+      return `
+      <item>
+        <title>${escapeXml(name)}</title>
+        <description>${escapeXml(description)}</description>
+        <link>${itemLink}</link>
+        <pubDate>${new Date(addedAt).toUTCString()}</pubDate>
+        <guid isPermaLink="true">${itemLink}</guid>
+      </item>
+    `;
+    })
+    .join("\n");
+
+  return `<?xml version="1.0" encoding="UTF-8" ?>
+<rss version="2.0"
+     xmlns:atom="http://www.w3.org/2005/Atom"
+     xmlns:content="http://purl.org/rss/1.0/modules/content/">
+<channel>
+  <title>${escapeXml(`${handle}'s Tangled Repos`)}</title>
+  <link>https://tangled.sh/@${handle}</link>
+  <description>Repositories for ${escapeXml(handle)}</description>
+  <atom:link href="${escapeXml(selfUrl)}" rel="self" type="application/rss+xml" />
+  ${rssItems}
+</channel>
+</rss>`;
+}
+
+const port = parseInt(Deno.env.get("PORT") || "8000");
+
+Deno.serve({ port }, app.fetch);