pleroma librarian setup

One-time xAuth exchange. The password is sent only to Instapaper and is not stored by this service.

`);\n}\n\nasync function handleSetup(request: Request): Promise {\n const environment = envValues();\n const status = configurationStatus(environment);\n if (!status.setupEnabled) return new Response(\"setup disabled\", { status: 404 });\n if (request.method === \"GET\") return setupForm();\n if (request.method !== \"POST\") return new Response(\"method not allowed\", { status: 405 });\n\n const form = await request.formData();\n const submittedSetupToken = String(form.get(\"setup_token\") ?? \"\");\n if (!isBearerAuthorized(`Bearer ${submittedSetupToken}`, environment.SETUP_TOKEN)) {\n return secureHtml(\"

Unauthorized

\", 401);\n }\n const username = String(form.get(\"username\") ?? \"\");\n let password = String(form.get(\"password\") ?? \"\");\n if (!username || !password) return secureHtml(\"

Missing credentials

\", 400);\n\n try {\n const bootstrapClient = new InstapaperClient({\n consumerKey: environment.INSTAPAPER_CONSUMER_KEY!,\n consumerSecret: environment.INSTAPAPER_CONSUMER_SECRET!,\n });\n const tokens = await bootstrapClient.exchangeAccessToken(username, password);\n password = \"\";\n return secureHtml(`tokens generated

Access tokens generated

Add these two values to the Val Town environment, then remove SETUP_TOKEN.

INSTAPAPER_ACCESS_TOKEN

${escapeHtml(tokens.oauth_token)}

INSTAPAPER_ACCESS_TOKEN_SECRET

${escapeHtml(tokens.oauth_token_secret)}

Do not send these values through chat.

`);\n } catch (error) {\n password = \"\";\n const message = error instanceof Error ? error.message : \"setup failed\";\n return secureHtml(`

Setup failed

${escapeHtml(message)}

`, 400);\n }\n}\n\nexport default async function handler(request: Request): Promise {\n const url = new URL(request.url);\n if (url.pathname === \"/health\") {\n return Response.json({\n ok: true,\n service: SERVICE,\n configuration: configurationStatus(envValues()),\n }, { headers: { \"cache-control\": \"no-store\" } });\n }\n if (url.pathname === \"/setup\") return await handleSetup(request);\n if (url.pathname === \"/\") {\n return new Response(\"pleroma librarian\\npersonal reading and research integration\\n\", {\n headers: { \"content-type\": \"text/plain; charset=utf-8\" },\n });\n }\n if (url.pathname !== \"/mcp\") return new Response(\"not found\", { status: 404 });\n\n const environment = envValues();\n if (!isBearerAuthorized(request.headers.get(\"authorization\"), environment.MCP_BEARER_TOKEN)) {\n return new Response(\"unauthorized\", {\n status: 401,\n headers: { \"www-authenticate\": \"Bearer\" },\n });\n }\n return await mcpHandler.fetch(request);\n}\n",[70],"a0015f8b-5be3-41e6-acd6-c15cb936730f",["D",1787183991142],"export function percentEncode(value: string | number): string {\n return encodeURIComponent(String(value)).replace(/[!'()*]/g, (character) =>\n `%${character.charCodeAt(0).toString(16).toUpperCase()}`\n );\n}\n\nexport type OAuthAuthorizationOptions = {\n method: string;\n url: string;\n consumerKey: string;\n consumerSecret: string;\n token?: string;\n tokenSecret?: string;\n bodyParams?: Record;\n nonce?: string;\n timestamp?: string;\n};\n\nfunction bytesToBase64(bytes: ArrayBuffer): string {\n let binary = \"\";\n for (const byte of new Uint8Array(bytes)) binary += String.fromCharCode(byte);\n return btoa(binary);\n}\n\nexport async function createOAuthAuthorization(\n options: OAuthAuthorizationOptions,\n): Promise<{ header: string; signature: string; baseString: string }> {\n const parsedUrl = new URL(options.url);\n const oauthParams: Record = {\n oauth_consumer_key: options.consumerKey,\n oauth_nonce: options.nonce ?? crypto.randomUUID().replaceAll(\"-\", \"\"),\n oauth_signature_method: \"HMAC-SHA1\",\n oauth_timestamp: options.timestamp ?? String(Math.floor(Date.now() / 1000)),\n };\n if (options.token) oauthParams.oauth_token = options.token;\n\n const allParams: Array<[string, string]> = [];\n for (const [key, value] of parsedUrl.searchParams.entries()) {\n allParams.push([percentEncode(key), percentEncode(value)]);\n }\n for (const [key, value] of Object.entries(options.bodyParams ?? {})) {\n allParams.push([percentEncode(key), percentEncode(value)]);\n }\n for (const [key, value] of Object.entries(oauthParams)) {\n allParams.push([percentEncode(key), percentEncode(value)]);\n }\n allParams.sort(([keyA, valueA], [keyB, valueB]) =>\n keyA === keyB ? valueA.localeCompare(valueB) : keyA.localeCompare(keyB)\n );\n\n const normalizedParams = allParams.map(([key, value]) => `${key}=${value}`).join(\"&\");\n const baseUrl = `${parsedUrl.protocol}//${parsedUrl.host}${parsedUrl.pathname}`;\n const baseString = [\n options.method.toUpperCase(),\n percentEncode(baseUrl),\n percentEncode(normalizedParams),\n ].join(\"&\");\n const signingKey = `${percentEncode(options.consumerSecret)}&${percentEncode(options.tokenSecret ?? \"\")}`;\n const key = await crypto.subtle.importKey(\n \"raw\",\n new TextEncoder().encode(signingKey),\n { name: \"HMAC\", hash: \"SHA-1\" },\n false,\n [\"sign\"],\n );\n const signature = bytesToBase64(\n await crypto.subtle.sign(\"HMAC\", key, new TextEncoder().encode(baseString)),\n );\n const headerParams = { ...oauthParams, oauth_signature: signature };\n const header = \"OAuth \" + Object.entries(headerParams)\n .sort(([a], [b]) => a.localeCompare(b))\n .map(([key, value]) => `${percentEncode(key)}=\\\"${percentEncode(value)}\\\"`)\n .join(\", \");\n\n return { header, signature, baseString };\n}\n\nexport function parseFormEncoded(body: string): Record {\n return Object.fromEntries(new URLSearchParams(body).entries());\n}\n\nexport function isBearerAuthorized(\n authorizationHeader: string | null,\n expectedToken: string | undefined,\n): boolean {\n if (!authorizationHeader || !expectedToken) return false;\n const prefix = \"Bearer \";\n if (!authorizationHeader.startsWith(prefix)) return false;\n const actualToken = authorizationHeader.slice(prefix.length);\n if (actualToken.length !== expectedToken.length) return false;\n let difference = 0;\n for (let index = 0; index < expectedToken.length; index++) {\n difference |= actualToken.charCodeAt(index) ^ expectedToken.charCodeAt(index);\n }\n return difference === 0;\n}\n",[85],"f7ccf328-c474-4349-9315-376a3fa6bf4d",["D",1787381456328],"import { createOAuthAuthorization, parseFormEncoded } from \"./lib.ts\";\n\nexport type InstapaperCredentials = {\n consumerKey: string;\n consumerSecret: string;\n token?: string;\n tokenSecret?: string;\n fetcher?: typeof fetch;\n};\n\nexport type BookmarkInput = {\n url: string;\n title?: string;\n description?: string;\n folderId?: number;\n tags?: string[];\n};\n\ntype ApiRecord = Record & { type?: string; error_code?: number };\n\nexport class InstapaperClient {\n private readonly fetcher: typeof fetch;\n private readonly credentials: InstapaperCredentials;\n\n constructor(credentials: InstapaperCredentials) {\n this.credentials = credentials;\n this.fetcher = credentials.fetcher ?? fetch;\n }\n\n private async signedPost(\n path: string,\n params: Record = {},\n expectText = false,\n includeToken = true,\n ): Promise {\n const url = `https://www.instapaper.com/api/${path}`;\n const body = new URLSearchParams();\n for (const [key, value] of Object.entries(params)) body.set(key, String(value));\n const authorization = await createOAuthAuthorization({\n method: \"POST\",\n url,\n consumerKey: this.credentials.consumerKey,\n consumerSecret: this.credentials.consumerSecret,\n token: includeToken ? this.credentials.token : undefined,\n tokenSecret: includeToken ? this.credentials.tokenSecret : undefined,\n bodyParams: params,\n });\n const response = await this.fetcher(url, {\n method: \"POST\",\n headers: {\n authorization: authorization.header,\n \"content-type\": \"application/x-www-form-urlencoded; charset=utf-8\",\n },\n body,\n });\n const responseBody = await response.text();\n\n if (expectText && response.ok) return responseBody;\n\n let parsed: unknown;\n try {\n parsed = JSON.parse(responseBody);\n } catch {\n throw new Error(`Instapaper API temporary failure (${response.status || 503})`);\n }\n const records = Array.isArray(parsed) ? parsed as ApiRecord[] : [];\n const apiError = records.find((record) => record.type === \"error\");\n if (apiError) {\n throw new Error(`Instapaper API ${apiError.error_code ?? \"error\"}`);\n }\n if (!response.ok) throw new Error(`Instapaper API HTTP ${response.status}`);\n return parsed;\n }\n\n async exchangeAccessToken(username: string, password: string): Promise<{\n oauth_token: string;\n oauth_token_secret: string;\n }> {\n const url = \"https://www.instapaper.com/api/1/oauth/access_token\";\n const params = {\n x_auth_username: username,\n x_auth_password: password,\n x_auth_mode: \"client_auth\",\n };\n const body = new URLSearchParams(params);\n const authorization = await createOAuthAuthorization({\n method: \"POST\",\n url,\n consumerKey: this.credentials.consumerKey,\n consumerSecret: this.credentials.consumerSecret,\n bodyParams: params,\n });\n const response = await this.fetcher(url, {\n method: \"POST\",\n headers: {\n authorization: authorization.header,\n \"content-type\": \"application/x-www-form-urlencoded; charset=utf-8\",\n },\n body,\n });\n const text = await response.text();\n if (!response.ok) throw new Error(`Instapaper xAuth failed (${response.status})`);\n const result = parseFormEncoded(text);\n if (!result.oauth_token || !result.oauth_token_secret) {\n throw new Error(\"Instapaper xAuth returned an invalid token response\");\n }\n return {\n oauth_token: result.oauth_token,\n oauth_token_secret: result.oauth_token_secret,\n };\n }\n\n private requireFirstType(result: unknown, type: string): ApiRecord {\n if (!Array.isArray(result)) throw new Error(`Instapaper API omitted ${type}`);\n const found = (result as ApiRecord[]).find((record) => record.type === type);\n if (!found) throw new Error(`Instapaper API omitted ${type}`);\n return found;\n }\n\n async verifyCredentials(): Promise {\n return this.requireFirstType(await this.signedPost(\"1/account/verify_credentials\"), \"user\");\n }\n\n async listBookmarks(folderId = \"unread\", limit = 25): Promise {\n return await this.signedPost(\"1/bookmarks/list\", {\n folder_id: folderId,\n limit: Math.max(1, Math.min(500, limit)),\n });\n }\n\n async addBookmark(input: BookmarkInput): Promise {\n const params: Record = { url: input.url, resolve_final_url: 1 };\n if (input.title) params.title = input.title;\n if (input.description) params.description = input.description;\n if (input.folderId !== undefined) params.folder_id = input.folderId;\n if (input.tags?.length) params.tags = JSON.stringify(input.tags.map((name) => ({ name })));\n return this.requireFirstType(await this.signedPost(\"1/bookmarks/add\", params), \"bookmark\");\n }\n\n async getText(bookmarkId: number): Promise {\n return await this.signedPost(\n \"1/bookmarks/get_text\",\n { bookmark_id: bookmarkId },\n true,\n ) as string;\n }\n\n async listFolders(): Promise {\n return await this.signedPost(\"1/folders/list\");\n }\n\n async createFolder(title: string): Promise {\n return this.requireFirstType(await this.signedPost(\"1/folders/add\", { title }), \"folder\");\n }\n\n async star(bookmarkId: number): Promise {\n return this.bookmarkAction(\"star\", bookmarkId);\n }\n\n async archive(bookmarkId: number): Promise {\n return this.bookmarkAction(\"archive\", bookmarkId);\n }\n\n async delete(bookmarkId: number): Promise {\n return this.bookmarkAction(\"delete\", bookmarkId);\n }\n\n async move(bookmarkId: number, folderId: number): Promise {\n return this.requireFirstType(\n await this.signedPost(\"1/bookmarks/move\", { bookmark_id: bookmarkId, folder_id: folderId }),\n \"bookmark\",\n );\n }\n\n private async bookmarkAction(action: \"star\" | \"archive\" | \"delete\", bookmarkId: number): Promise {\n return this.requireFirstType(\n await this.signedPost(`1/bookmarks/${action}`, { bookmark_id: bookmarkId }),\n \"bookmark\",\n );\n }\n}\n",[95],"pulls","branches","forks","envVars",{"_269":107,"_271":20},"connections",{"_269":20,"_270":20},"count","unfilledCount","emptyCount",{"_38":258,"_13":95,"_68":94,"_48":-5,"_40":41,"_239":151,"_240":175,"_42":290,"_44":79,"_71":86,"_242":260,"_73":24,"_244":-5,"_278":291,"_211":292},{"_38":254,"_13":85,"_68":84,"_48":-5,"_40":41,"_239":79,"_240":175,"_42":287,"_44":20,"_71":86,"_242":256,"_73":24,"_244":-5,"_278":288,"_211":289},{"_38":250,"_13":70,"_68":69,"_48":-5,"_40":41,"_239":158,"_240":175,"_42":284,"_44":98,"_71":72,"_242":252,"_73":24,"_244":-5,"_278":285,"_211":286},{"_38":246,"_13":104,"_68":103,"_48":-5,"_40":41,"_239":98,"_240":175,"_42":281,"_44":20,"_71":86,"_242":248,"_73":24,"_244":-5,"_278":282,"_211":283},{"_38":238,"_13":120,"_68":119,"_48":-5,"_40":41,"_239":123,"_240":175,"_42":277,"_44":45,"_71":86,"_242":243,"_73":24,"_244":-5,"_278":279,"_211":280},["D",1787184775234],"children",[],[120],["D",1787183991818],[],[104],["D",1787381468515],[],[70],["D",1787183991142],[],[85],["D",1787381456328],[],[95],["D",1787183267868],{"_11":12,"_210":76},{"_11":12,"_206":-5,"_75":76,"_25":74,"_207":208,"_209":24},{"_44":158,"_13":16,"_38":41,"_198":163,"_199":-5,"_200":-5,"_201":-5,"_202":-5,"_203":-5,"_204":14,"_205":12},"ctx",{"_57":-5,"_230":330,"_331":332,"_333":334,"_335":24,"_336":24,"_337":24,"_338":175,"_339":-5,"_340":-7,"_341":-7,"_342":20,"_343":24,"_344":24,"_345":-5,"_346":24,"_347":24,"_348":24,"_349":-5},"ENV",{"_301":302,"_303":304,"_305":16,"_306":307,"_308":309,"_310":311,"_312":313,"_314":315,"_316":317,"_318":319,"_320":321,"_322":323,"_324":325,"_326":327,"_328":329},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","5015b8df46402d8bba4f485ecc37aec202b0e06b","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History