create-bsky-collection.sh

1#!/usr/bin/env bash23# =========================================================4# BLUESKY CUSTOM COLLECTION CREATOR5# This script demonstrates how to create custom collections in the AT Protocol.6# Collections allow you to store custom data structures in your repository.7# =========================================================89# Exit on error to prevent continuing with partial success10set -e1112# Set up cleanup to happen automatically when the script exits13# This ensures we don't leave sensitive authentication data behind14trap cleanup EXIT1516# Create a secure temporary directory to store sensitive information17# Using mktemp ensures the directory has restricted permissions and a unique name18TEMP_DIR=$(mktemp -d)19AUTH_FILE="${TEMP_DIR}/auth.json"20RECORD_FILE="${TEMP_DIR}/record.json"2122# Define a cleanup function to remove temporary files securely23# This prevents sensitive data from being left on disk24cleanup() {25  echo "Cleaning up temporary files..."26  rm -rf "${TEMP_DIR}"27}2829# =========================================================30# CONFIGURATION31# These variables set up the user identity and collection details32# =========================================================33HANDLE="${BLUESKY_IDENTIFIER}"34APP_PASSWORD="${BLUESKY_PASSWORD}"35COLLECTION_NAME="is.rud.bsky.bookshelf.book"36RECORD_TYPE="book"3738# Validate that required credentials are available39# This prevents confusing errors later in the script40if [ -z "$HANDLE" ] || [ -z "$APP_PASSWORD" ]; then41  echo "Please edit this script to add your Bluesky handle and app password"42  exit 143fi4445# =========================================================46# AUTHENTICATION47# Authenticating with Bluesky to get an access token48# The AT Protocol uses JWT tokens for authenticated requests49# =========================================================5051# Create the authentication payload as a JSON file52cat > "${AUTH_FILE}" << EOF53{54  "identifier": "$HANDLE",55  "password": "$APP_PASSWORD"56}57EOF5859# Send authentication request to the Bluesky API60# This uses the createSession endpoint to get tokens61echo "Authenticating with Bluesky..."62AUTH_RESPONSE=$(curl -s -X POST "https://bsky.social/xrpc/com.atproto.server.createSession" \63  -H "Content-Type: application/json" \64  -d @"${AUTH_FILE}")6566# Extract the access token and DID (Decentralized Identifier)67# The DID is your unique identifier in the AT Protocol68ACCESS_TOKEN=$(echo "$AUTH_RESPONSE" | jq -r .accessJwt)69DID=$(echo "$AUTH_RESPONSE" | jq -r .did)7071# Validate authentication success72if [ -z "$ACCESS_TOKEN" ] || [ "$ACCESS_TOKEN" == "null" ]; then73  echo "Authentication failed. Please check your credentials."74  exit 175fi7677echo "Authentication successful! DID: $DID"7879# =========================================================80# RECORD CREATION81# Preparing and creating a custom record in your repository82# Each record needs a collection name, repository key, and content83# =========================================================8485# Create ISO 8601 timestamp for the record86# AT Protocol typically uses ISO timestamps for time fields87TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%S.%3NZ")8889# Create the record payload with sample book data90# The $type field is required and must match the collection name91cat > "${RECORD_FILE}" << EOF92{93  "repo": "$DID",94  "collection": "$COLLECTION_NAME",95  "rkey": "$RECORD_TYPE-$(date +%s)",96  "record": {97    "\$type": "$COLLECTION_NAME",98    "title": "The Great Gatsby",99    "author": "F. Scott Fitzgerald",100    "rating": 5,101    "review": "A classic American novel that explores themes of wealth, class, and the American Dream.",102    "readDate": "$TIMESTAMP",103    "createdAt": "$TIMESTAMP"104  }105}106EOF107108# =========================================================109# PUBLISHING THE RECORD110# Sending the record to the AT Protocol repository111# This makes it part of your public data graph112# =========================================================113114# Send the create record request to the API115echo "Creating new record in collection $COLLECTION_NAME..."116CREATE_RESPONSE=$(curl -s -X POST "https://bsky.social/xrpc/com.atproto.repo.createRecord" \117  -H "Content-Type: application/json" \118  -H "Authorization: Bearer $ACCESS_TOKEN" \119  -d @"${RECORD_FILE}")120121# Validate the response and extract record identifiers122# URI is the canonical identifier for the record123# CID is the content identifier (hash of the record data)124URI=$(echo "$CREATE_RESPONSE" | jq -r .uri)125CID=$(echo "$CREATE_RESPONSE" | jq -r .cid)126127if [ -z "$URI" ] || [ "$URI" == "null" ]; then128  echo "Failed to create record. Response: $CREATE_RESPONSE"129  exit 1130fi131132# =========================================================133# RESULTS134# Successfully created a custom collection record135# =========================================================136echo "Success! Created new record in collection."137echo "URI: $URI"138echo "CID: $CID"139echo ""140echo "Note: This is an experimental collection. To make this a proper collection,"141echo "you would need to define a lexicon schema for it."142