16 |
18 | )
19 | }
20 |
21 | if (error) {
22 | return (
23 | {randomEmoji}
17 |
24 |
36 |
37 | )
38 | }
39 |
40 | return (
41 |
42 |
53 | )
54 | }
55 |
56 | export default HomePage
57 |
--------------------------------------------------------------------------------
/packages/lexicon/src/types/com/atproto/repo/deleteRecord.ts:
--------------------------------------------------------------------------------
1 | /**
2 | * GENERATED CODE - DO NOT MODIFY
3 | */
4 | import { BlobRef, ValidationResult } from '@atproto/lexicon'
5 | import { HeadersMap, XRPCError } from '@atproto/xrpc'
6 | import { CID } from 'multiformats/cid'
7 |
8 | import { validate as _validate } from '../../../../lexicons'
9 | import { is$typed as _is$typed, $Typed, OmitKey } from '../../../../util'
10 | import type * as ComAtprotoRepoDefs from './defs.js'
11 |
12 | const is$typed = _is$typed,
13 | validate = _validate
14 | const id = 'com.atproto.repo.deleteRecord'
15 |
16 | export interface QueryParams {}
17 |
18 | export interface InputSchema {
19 | /** The handle or DID of the repo (aka, current account). */
20 | repo: string
21 | /** The NSID of the record collection. */
22 | collection: string
23 | /** The Record Key. */
24 | rkey: string
25 | /** Compare and swap with the previous record by CID. */
26 | swapRecord?: string
27 | /** Compare and swap with the previous commit by CID. */
28 | swapCommit?: string
29 | }
30 |
31 | export interface OutputSchema {
32 | commit?: ComAtprotoRepoDefs.CommitMeta
33 | }
34 |
35 | export interface CallOptions {
36 | signal?: AbortSignal
37 | headers?: HeadersMap
38 | qp?: QueryParams
39 | encoding?: 'application/json'
40 | }
41 |
42 | export interface Response {
43 | success: boolean
44 | headers: HeadersMap
45 | data: OutputSchema
46 | }
47 |
48 | export class InvalidSwapError extends XRPCError {
49 | constructor(src: XRPCError) {
50 | super(src.status, src.error, src.message, src.headers, { cause: src })
51 | }
52 | }
53 |
54 | export function toKnownErr(e: any) {
55 | if (e instanceof XRPCError) {
56 | if (e.error === 'InvalidSwap') return new InvalidSwapError(e)
57 | }
58 |
59 | return e
60 | }
61 |
--------------------------------------------------------------------------------
/lexicons/app/bsky/actor/profile.json:
--------------------------------------------------------------------------------
1 | {
2 | "lexicon": 1,
3 | "id": "app.bsky.actor.profile",
4 | "defs": {
5 | "main": {
6 | "type": "record",
7 | "description": "A declaration of a Bluesky account profile.",
8 | "key": "literal:self",
9 | "record": {
10 | "type": "object",
11 | "properties": {
12 | "displayName": {
13 | "type": "string",
14 | "maxGraphemes": 64,
15 | "maxLength": 640
16 | },
17 | "description": {
18 | "type": "string",
19 | "description": "Free-form profile description text.",
20 | "maxGraphemes": 256,
21 | "maxLength": 2560
22 | },
23 | "avatar": {
24 | "type": "blob",
25 | "description": "Small image to be displayed next to posts from account. AKA, 'profile picture'",
26 | "accept": ["image/png", "image/jpeg"],
27 | "maxSize": 1000000
28 | },
29 | "banner": {
30 | "type": "blob",
31 | "description": "Larger horizontal image to display behind profile view.",
32 | "accept": ["image/png", "image/jpeg"],
33 | "maxSize": 1000000
34 | },
35 | "labels": {
36 | "type": "union",
37 | "description": "Self-label values, specific to the Bluesky application, on the overall account.",
38 | "refs": ["com.atproto.label.defs#selfLabels"]
39 | },
40 | "joinedViaStarterPack": {
41 | "type": "ref",
42 | "ref": "com.atproto.repo.strongRef"
43 | },
44 | "pinnedPost": {
45 | "type": "ref",
46 | "ref": "com.atproto.repo.strongRef"
47 | },
48 | "createdAt": { "type": "string", "format": "datetime" }
49 | }
50 | }
51 | }
52 | }
53 | }
54 |
--------------------------------------------------------------------------------
/packages/appview/README.md:
--------------------------------------------------------------------------------
1 | # Statusphere AppView
2 |
3 | This is the backend API for the Statusphere application. It provides REST endpoints for the React frontend to consume.
4 |
5 | ## Development
6 |
7 | ```bash
8 | # Install dependencies
9 | pnpm install
10 |
11 | # Start development server
12 | pnpm dev
13 |
14 | # Build for production
15 | pnpm build
16 |
17 | # Start production server
18 | pnpm start
19 | ```
20 |
21 | ## Environment Variables
22 |
23 | Create a `.env` file in the root of this package with the following variables:
24 |
25 | ```
26 | NODE_ENV=development
27 | HOST=localhost
28 | PORT=3001
29 | DB_PATH=./data.sqlite
30 | COOKIE_SECRET=your_secret_here_at_least_32_characters_long
31 | ATPROTO_SERVER=https://bsky.social
32 | PUBLIC_URL=http://localhost:3001
33 | NGROK_URL=your_ngrok_url_here
34 | ```
35 |
36 | ## Using ngrok for OAuth Development
37 |
38 | Due to OAuth requirements, we need to use HTTPS for development. The easiest way to do this is with ngrok:
39 |
40 | 1. Install ngrok: https://ngrok.com/download
41 | 2. Run ngrok to create a tunnel to your local server:
42 | ```bash
43 | ngrok http 3001
44 | ```
45 | 3. Copy the HTTPS URL provided by ngrok (e.g., `https://abcd-123-45-678-90.ngrok.io`)
46 | 4. Add it to your `.env` file:
47 | ```
48 | NGROK_URL=https://abcd-123-45-678-90.ngrok.io
49 | ```
50 | 5. Also update the API URL in the client package:
51 | ```
52 | # In packages/client/src/services/api.ts
53 | const API_URL = 'https://abcd-123-45-678-90.ngrok.io';
54 | ```
55 |
56 | ## API Endpoints
57 |
58 | - `GET /oauth-client-metadata.json` - OAuth client metadata
59 | - `GET /oauth/callback` - OAuth callback endpoint
60 | - `POST /login` - Login with handle
61 | - `POST /logout` - Logout current user
62 | - `GET /user` - Get current user info
63 | - `GET /statuses` - Get recent statuses
64 | - `POST /status` - Create a new status
65 |
--------------------------------------------------------------------------------
/packages/appview/src/lexicons/types/com/atproto/repo/getRecord.ts:
--------------------------------------------------------------------------------
1 | /**
2 | * GENERATED CODE - DO NOT MODIFY
3 | */
4 | import { BlobRef, ValidationResult } from '@atproto/lexicon'
5 | import { HandlerAuth, HandlerPipeThrough } from '@atproto/xrpc-server'
6 | import express from 'express'
7 | import { CID } from 'multiformats/cid'
8 |
9 | import { validate as _validate } from '../../../../lexicons'
10 | import { is$typed as _is$typed, $Typed, OmitKey } from '../../../../util'
11 |
12 | const is$typed = _is$typed,
13 | validate = _validate
14 | const id = 'com.atproto.repo.getRecord'
15 |
16 | export interface QueryParams {
17 | /** The handle or DID of the repo. */
18 | repo: string
19 | /** The NSID of the record collection. */
20 | collection: string
21 | /** The Record Key. */
22 | rkey: string
23 | /** The CID of the version of the record. If not specified, then return the most recent version. */
24 | cid?: string
25 | }
26 |
27 | export type InputSchema = undefined
28 |
29 | export interface OutputSchema {
30 | uri: string
31 | cid?: string
32 | value: { [_ in string]: unknown }
33 | }
34 |
35 | export type HandlerInput = undefined
36 |
37 | export interface HandlerSuccess {
38 | encoding: 'application/json'
39 | body: OutputSchema
40 | headers?: { [key: string]: string }
41 | }
42 |
43 | export interface HandlerError {
44 | status: number
45 | message?: string
46 | error?: 'RecordNotFound'
47 | }
48 |
49 | export type HandlerOutput = HandlerError | HandlerSuccess | HandlerPipeThrough
50 | export type HandlerReqCtx
47 |
52 | 48 | Recent Statuses 49 |
50 |
19 |
58 | 20 | 24 | Statusphere 25 | 26 |
27 | 57 |
69 |
96 | )
97 | }
98 |
99 | export default OAuthCallbackPage
100 |
--------------------------------------------------------------------------------
/packages/client/src/hooks/useAuth.tsx:
--------------------------------------------------------------------------------
1 | import { createContext, ReactNode, useContext, useState } from 'react'
2 | import { useQuery, useQueryClient } from '@tanstack/react-query'
3 | import { XRPCError } from '@atproto/xrpc'
4 | import { XyzStatusphereGetUser } from '@statusphere/lexicon'
5 |
6 | import api from '#/services/api'
7 |
8 | interface AuthContextType {
9 | user: XyzStatusphereGetUser.OutputSchema | null
10 | loading: boolean
11 | error: string | null
12 | login: (handle: string) => Promise<{ redirectUrl: string }>
13 | logout: () => Promise
70 | {error ? (
71 |
95 |
72 |
83 | ) : (
84 | 73 | Authentication Failed 74 |
75 |{error}
76 | 82 |
85 |
93 | )}
94 | 86 | Authentication in Progress 87 |
88 |
89 |
90 |
91 | {message}
92 |
35 |
42 | )
43 | }
44 |
45 | if (isError) {
46 | return (
47 |
36 | {randomEmoji}
37 |
38 |
39 | Loading statuses...
40 |
41 |
48 | {(error as Error)?.message || 'Failed to load statuses'}
49 |
50 | )
51 | }
52 |
53 | if (statuses.length === 0) {
54 | return (
55 |
56 | No statuses yet.
57 |
58 | )
59 | }
60 |
61 | // Helper to format dates
62 | const formatDate = (dateString: string) => {
63 | const date = new Date(dateString)
64 | const today = new Date()
65 | const isToday =
66 | date.getDate() === today.getDate() &&
67 | date.getMonth() === today.getMonth() &&
68 | date.getFullYear() === today.getFullYear()
69 |
70 | if (isToday) {
71 | return 'today'
72 | } else {
73 | return date.toLocaleDateString(undefined, {
74 | year: 'numeric',
75 | month: 'long',
76 | day: 'numeric',
77 | })
78 | }
79 | }
80 |
81 | return (
82 |
83 |
129 | )
130 | }
131 |
132 | export default StatusList
133 |
--------------------------------------------------------------------------------
/lexicons/com/atproto/repo/applyWrites.json:
--------------------------------------------------------------------------------
1 | {
2 | "lexicon": 1,
3 | "id": "com.atproto.repo.applyWrites",
4 | "defs": {
5 | "main": {
6 | "type": "procedure",
7 | "description": "Apply a batch transaction of repository creates, updates, and deletes. Requires auth, implemented by PDS.",
8 | "input": {
9 | "encoding": "application/json",
10 | "schema": {
11 | "type": "object",
12 | "required": ["repo", "writes"],
13 | "properties": {
14 | "repo": {
15 | "type": "string",
16 | "format": "at-identifier",
17 | "description": "The handle or DID of the repo (aka, current account)."
18 | },
19 | "validate": {
20 | "type": "boolean",
21 | "description": "Can be set to 'false' to skip Lexicon schema validation of record data across all operations, 'true' to require it, or leave unset to validate only for known Lexicons."
22 | },
23 | "writes": {
24 | "type": "array",
25 | "items": {
26 | "type": "union",
27 | "refs": ["#create", "#update", "#delete"],
28 | "closed": true
29 | }
30 | },
31 | "swapCommit": {
32 | "type": "string",
33 | "description": "If provided, the entire operation will fail if the current repo commit CID does not match this value. Used to prevent conflicting repo mutations.",
34 | "format": "cid"
35 | }
36 | }
37 | }
38 | },
39 | "output": {
40 | "encoding": "application/json",
41 | "schema": {
42 | "type": "object",
43 | "required": [],
44 | "properties": {
45 | "commit": {
46 | "type": "ref",
47 | "ref": "com.atproto.repo.defs#commitMeta"
48 | },
49 | "results": {
50 | "type": "array",
51 | "items": {
52 | "type": "union",
53 | "refs": ["#createResult", "#updateResult", "#deleteResult"],
54 | "closed": true
55 | }
56 | }
57 | }
58 | }
59 | },
60 | "errors": [
61 | {
62 | "name": "InvalidSwap",
63 | "description": "Indicates that the 'swapCommit' parameter did not match current commit."
64 | }
65 | ]
66 | },
67 | "create": {
68 | "type": "object",
69 | "description": "Operation which creates a new record.",
70 | "required": ["collection", "value"],
71 | "properties": {
72 | "collection": { "type": "string", "format": "nsid" },
73 | "rkey": {
74 | "type": "string",
75 | "maxLength": 512,
76 | "format": "record-key",
77 | "description": "NOTE: maxLength is redundant with record-key format. Keeping it temporarily to ensure backwards compatibility."
78 | },
79 | "value": { "type": "unknown" }
80 | }
81 | },
82 | "update": {
83 | "type": "object",
84 | "description": "Operation which updates an existing record.",
85 | "required": ["collection", "rkey", "value"],
86 | "properties": {
87 | "collection": { "type": "string", "format": "nsid" },
88 | "rkey": { "type": "string", "format": "record-key" },
89 | "value": { "type": "unknown" }
90 | }
91 | },
92 | "delete": {
93 | "type": "object",
94 | "description": "Operation which deletes an existing record.",
95 | "required": ["collection", "rkey"],
96 | "properties": {
97 | "collection": { "type": "string", "format": "nsid" },
98 | "rkey": { "type": "string", "format": "record-key" }
99 | }
100 | },
101 | "createResult": {
102 | "type": "object",
103 | "required": ["uri", "cid"],
104 | "properties": {
105 | "uri": { "type": "string", "format": "at-uri" },
106 | "cid": { "type": "string", "format": "cid" },
107 | "validationStatus": {
108 | "type": "string",
109 | "knownValues": ["valid", "unknown"]
110 | }
111 | }
112 | },
113 | "updateResult": {
114 | "type": "object",
115 | "required": ["uri", "cid"],
116 | "properties": {
117 | "uri": { "type": "string", "format": "at-uri" },
118 | "cid": { "type": "string", "format": "cid" },
119 | "validationStatus": {
120 | "type": "string",
121 | "knownValues": ["valid", "unknown"]
122 | }
123 | }
124 | },
125 | "deleteResult": {
126 | "type": "object",
127 | "required": [],
128 | "properties": {}
129 | }
130 | }
131 | }
132 |
--------------------------------------------------------------------------------
/packages/appview/src/index.ts:
--------------------------------------------------------------------------------
1 | import events from 'node:events'
2 | import fs from 'node:fs'
3 | import type http from 'node:http'
4 | import path from 'node:path'
5 | import { DAY, SECOND } from '@atproto/common'
6 | import compression from 'compression'
7 | import cors from 'cors'
8 | import express from 'express'
9 | import { pino } from 'pino'
10 |
11 | import API, { health, oauth } from '#/api'
12 | import { createClient } from '#/auth/client'
13 | import { AppContext } from '#/context'
14 | import { createDb, migrateToLatest } from '#/db'
15 | import * as error from '#/error'
16 | import { createBidirectionalResolver, createIdResolver } from '#/id-resolver'
17 | import { createFirehoseIngester, createJetstreamIngester } from '#/ingestors'
18 | import { createServer } from '#/lexicons'
19 | import { env } from '#/lib/env'
20 |
21 | export class Server {
22 | constructor(
23 | public app: express.Application,
24 | public server: http.Server,
25 | public ctx: AppContext,
26 | ) {}
27 |
28 | static async create() {
29 | const { NODE_ENV, HOST, PORT, DB_PATH } = env
30 | const logger = pino({ name: 'server start' })
31 |
32 | // Set up the SQLite database
33 | const db = createDb(DB_PATH)
34 | await migrateToLatest(db)
35 |
36 | // Create the atproto utilities
37 | const oauthClient = await createClient(db)
38 | const baseIdResolver = createIdResolver()
39 | const ingester = await createJetstreamIngester(db)
40 | // Alternative: const ingester = await createFirehoseIngester(db, baseIdResolver)
41 | const resolver = createBidirectionalResolver(baseIdResolver)
42 | const ctx = {
43 | db,
44 | ingester,
45 | logger,
46 | oauthClient,
47 | resolver,
48 | }
49 |
50 | // Subscribe to events on the firehose
51 | ingester.start()
52 |
53 | const app = express()
54 | app.use(cors({ maxAge: DAY / SECOND }))
55 | app.use(compression())
56 | app.use(express.json())
57 | app.use(express.urlencoded({ extended: true }))
58 |
59 | // Create our server
60 | let server = createServer({
61 | validateResponse: env.isDevelopment,
62 | payload: {
63 | jsonLimit: 100 * 1024, // 100kb
64 | textLimit: 100 * 1024, // 100kb
65 | // no blobs
66 | blobLimit: 0,
67 | },
68 | })
69 |
70 | server = API(server, ctx)
71 |
72 | app.use(health.createRouter(ctx))
73 | app.use(oauth.createRouter(ctx))
74 | app.use(server.xrpc.router)
75 | app.use(error.createHandler(ctx))
76 |
77 | // Serve static files from the frontend build - prod only
78 | if (env.isProduction) {
79 | const frontendPath = path.resolve(
80 | __dirname,
81 | '../../../packages/client/dist',
82 | )
83 |
84 | // Check if the frontend build exists
85 | if (fs.existsSync(frontendPath)) {
86 | logger.info(`Serving frontend static files from: ${frontendPath}`)
87 |
88 | // Serve static files
89 | app.use(express.static(frontendPath))
90 |
91 | // For any other requests, send the index.html file
92 | app.get('*', (req, res) => {
93 | // Only handle non-API paths
94 | if (!req.path.startsWith('/xrpc/')) {
95 | res.sendFile(path.join(frontendPath, 'index.html'))
96 | } else {
97 | res.status(404).json({ error: 'API endpoint not found' })
98 | }
99 | })
100 | } else {
101 | logger.warn(`Frontend build not found at: ${frontendPath}`)
102 | app.use('*', (_req, res) => {
103 | res.sendStatus(404)
104 | })
105 | }
106 | } else {
107 | app.set('trust proxy', true)
108 | }
109 |
110 | // Use the port from env (should be 3001 for the API server)
111 | const httpServer = app.listen(env.PORT)
112 | await events.once(httpServer, 'listening')
113 | logger.info(
114 | `API Server (${NODE_ENV}) running on port http://${HOST}:${env.PORT}`,
115 | )
116 |
117 | return new Server(app, httpServer, ctx)
118 | }
119 |
120 | async close() {
121 | this.ctx.logger.info('sigint received, shutting down')
122 | await this.ctx.ingester.destroy()
123 | await new Promise
84 |
85 | {statuses.map((status) => {
86 | const handle =
87 | status.profile.handle || status.profile.did.substring(0, 15) + '...'
88 | const formattedDate = formatDate(status.createdAt)
89 | const isToday = formattedDate === 'today'
90 |
91 | return (
92 |
128 |
96 |
125 | )
126 | })}
127 |
97 |
99 | {status.status}
98 |
100 |
124 |
101 |
107 | @{handle}
108 | {' '}
109 | {isToday ? (
110 |
111 | is feeling{' '}
112 | {status.status}{' '}
113 | today
114 |
115 | ) : (
116 |
117 | was feeling{' '}
118 | {status.status} on{' '}
119 | {formattedDate}
120 |
121 | )}
122 |
123 |
49 |
129 | )
130 | }
131 |
132 | export default LoginPage
133 |
--------------------------------------------------------------------------------
/packages/appview/src/lexicons/types/com/atproto/repo/applyWrites.ts:
--------------------------------------------------------------------------------
1 | /**
2 | * GENERATED CODE - DO NOT MODIFY
3 | */
4 | import { BlobRef, ValidationResult } from '@atproto/lexicon'
5 | import { HandlerAuth, HandlerPipeThrough } from '@atproto/xrpc-server'
6 | import express from 'express'
7 | import { CID } from 'multiformats/cid'
8 |
9 | import { validate as _validate } from '../../../../lexicons'
10 | import { is$typed as _is$typed, $Typed, OmitKey } from '../../../../util'
11 | import type * as ComAtprotoRepoDefs from './defs.js'
12 |
13 | const is$typed = _is$typed,
14 | validate = _validate
15 | const id = 'com.atproto.repo.applyWrites'
16 |
17 | export interface QueryParams {}
18 |
19 | export interface InputSchema {
20 | /** The handle or DID of the repo (aka, current account). */
21 | repo: string
22 | /** Can be set to 'false' to skip Lexicon schema validation of record data across all operations, 'true' to require it, or leave unset to validate only for known Lexicons. */
23 | validate?: boolean
24 | writes: ($Typed
52 |
128 | Login with ATProto
53 | 54 | {error && ( 55 |
56 | {error}
57 |
58 | )}
59 |
60 |
118 |
119 |
120 |
124 | Cancel
125 |
126 |
127 |