[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_319":320,"_321":322},"routes/_app.x.$handle.$name",{"_114":113,"_34":60,"_123":104,"_29":124,"_13":14,"_125":-5,"_11":126,"_127":128,"_129":130,"_131":132,"_133":134,"_22":-5,"_135":-5,"_136":-5,"_137":64,"_138":139,"_140":64,"_141":-5,"_142":-5,"_143":144},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_58":59,"_34":60,"_40":61,"_62":-5,"_63":64,"_65":66,"_67":66,"_68":69,"_70":-5,"_18":71,"_72":-5,"_73":64,"_74":-5,"_75":-5,"_76":77,"_78":79,"_80":81,"_82":83,"_84":85,"_86":-5,"_87":88,"_89":88,"_90":91,"_92":91,"_93":91,"_94":88,"_95":88,"_96":97,"_98":99,"_100":101,"_102":64},"version",105,"changes",[19,20,21],"aiChatInfo","userId",{"_22":52,"_24":53,"_26":27,"_28":27,"_29":54,"_31":54},{"_22":45,"_24":46,"_26":27,"_28":27,"_29":47,"_31":47},{"_22":23,"_24":25,"_26":27,"_28":27,"_29":30,"_31":30},"file",{"_32":33,"_34":35,"_36":37,"_38":39,"_40":41,"_42":14,"_43":44,"_26":27},"previous",{"_32":33,"_34":35,"_36":37,"_38":39},"deleted",true,"deletedHere","path","bootstrap/publish-lexicon.ts","latestPath","fileId","55171b84-424b-11f1-a519-42b51c65c3df","name","publish-lexicon.ts","fileType","script","content","/**\n * One-time script to publish the com.barryfrost.checkin lexicon to your PDS.\n *\n * Stores the lexicon at:\n * at:///com.atproto.lexicon.schema/com.barryfrost.checkin\n *\n * Uses putRecord (upsert) so it's safe to re-run if the lexicon is updated.\n *\n * Usage:\n * BSKY_HANDLE= BSKY_APP_PASSWORD= deno run --allow-env --allow-net --allow-read bootstrap/publish-lexicon.ts\n */\n\nimport lexicon from \"../lexicons/com.barryfrost.checkin.json\" with { type: \"json\" };\n\nconst PDS_URL = Deno.env.get(\"BSKY_PDS_URL\") ?? \"https://bsky.social\";\nconst handle = Deno.env.get(\"BSKY_HANDLE\");\nconst password = Deno.env.get(\"BSKY_APP_PASSWORD\");\n\nif (!handle || !password) {\n console.error(\"BSKY_HANDLE and BSKY_APP_PASSWORD must be set.\");\n Deno.exit(1);\n}\n\n// Authenticate\nconst sessionResp = await fetch(`${PDS_URL}/xrpc/com.atproto.server.createSession`, {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\" },\n body: JSON.stringify({ identifier: handle, password }),\n});\nif (!sessionResp.ok) {\n console.error(`Auth failed (${sessionResp.status}):`, await sessionResp.text());\n Deno.exit(1);\n}\nconst { accessJwt, did } = await sessionResp.json();\n\n// Publish lexicon using putRecord (upsert — safe to re-run)\nconst record = { \"$type\": \"com.atproto.lexicon.schema\", ...lexicon };\nconst putResp = await fetch(`${PDS_URL}/xrpc/com.atproto.repo.putRecord`, {\n method: \"POST\",\n headers: {\n \"content-type\": \"application/json\",\n \"authorization\": `Bearer ${accessJwt}`,\n },\n body: JSON.stringify({\n repo: did,\n collection: \"com.atproto.lexicon.schema\",\n rkey: lexicon.id,\n record,\n }),\n});\nif (!putResp.ok) {\n console.error(`putRecord failed (${putResp.status}):`, await putResp.text());\n Deno.exit(1);\n}\nconst result = await putResp.json();\nconsole.log(`Published: ${result.uri}`);\n","createdAt",["D",1777302979709],"branchVersion","branchId","3ddb19fa-4243-11f1-8011-42b51c65c3df",{"_32":48,"_34":49,"_36":37,"_38":50,"_40":51,"_42":14,"_43":44,"_26":27},{"_32":48,"_34":49,"_36":37,"_38":50},"bootstrap/fsq-oauth.ts","3ed655b8-4243-11f1-b8bc-42b51c65c3df","fsq-oauth.ts","/**\n * One-time script to obtain a Foursquare OAuth user token.\n *\n * Prerequisites:\n * 1. Create a Foursquare developer app at https://foursquare.com/developers/\n * 2. Set Redirect URI in the app settings to: http://localhost:8765/callback\n *\n * Usage:\n * FSQ_CLIENT_ID= FSQ_CLIENT_SECRET= deno run --allow-env --allow-net bootstrap/fsq-oauth.ts\n *\n * Copy the printed token and set it as FSQ_OAUTH_TOKEN in Val.Town env vars.\n * FSQ user tokens do not expire.\n */\n\nconst clientId = Deno.env.get(\"FSQ_CLIENT_ID\");\nconst clientSecret = Deno.env.get(\"FSQ_CLIENT_SECRET\");\n\nif (!clientId || !clientSecret) {\n console.error(\"Error: FSQ_CLIENT_ID and FSQ_CLIENT_SECRET must be set.\");\n Deno.exit(1);\n}\n\nconst PORT = 8765;\nconst REDIRECT_URI = `http://localhost:${PORT}/callback`;\nconst AUTH_URL =\n `https://foursquare.com/oauth2/authenticate?client_id=${clientId}&response_type=code&redirect_uri=${encodeURIComponent(REDIRECT_URI)}`;\n\nconsole.log(\"\\nStep 1: Open this URL in your browser:\\n\");\nconsole.log(AUTH_URL);\nconsole.log(\"\\nWaiting for redirect on http://localhost:\" + PORT + \" ...\\n\");\n\nconst code = await new Promise((resolve, _reject) => {\n const server = Deno.serve(\n { port: PORT, onListen: () => {} },\n (req: Request): Response => {\n const url = new URL(req.url);\n if (url.pathname === \"/callback\") {\n const code = url.searchParams.get(\"code\");\n if (code) {\n resolve(code);\n // Shut down after responding\n setTimeout(() => server.shutdown(), 100);\n return new Response(\n \"

Success! You can close this tab and return to the terminal.

\",\n { status: 200, headers: { \"content-type\": \"text/html\" } },\n );\n }\n return new Response(\"Missing code parameter\", { status: 400 });\n }\n return new Response(\"Not found\", { status: 404 });\n },\n );\n});\n\nconsole.log(\"Step 2: Exchanging code for access token...\\n\");\n\n// Foursquare's token endpoint uses a GET with query params (not POST/JSON)\nconst tokenParams = new URLSearchParams({\n client_id: clientId,\n client_secret: clientSecret,\n grant_type: \"authorization_code\",\n redirect_uri: REDIRECT_URI,\n code,\n});\nconst tokenResp = await fetch(\n `https://foursquare.com/oauth2/access_token?${tokenParams}`,\n);\n\nconst tokenData = await tokenResp.json();\n\nif (tokenData.access_token) {\n console.log(\"Success! Set this as FSQ_OAUTH_TOKEN in Val.Town:\\n\");\n console.log(tokenData.access_token);\n console.log();\n} else {\n console.error(\"Failed to get token:\");\n console.error(JSON.stringify(tokenData, null, 2));\n Deno.exit(1);\n}\n",["D",1777302979709],{"_32":55,"_34":54,"_36":56,"_38":-5,"_40":57,"_42":14,"_43":44,"_26":27},{"_32":55,"_34":54,"_36":56,"_38":-5},"bootstrap","3e4b86c2-4243-11f1-8011-42b51c65c3df","directory",["D",1777302979709],"id","3dda5d80-4243-11f1-8011-42b51c65c3df","fsq2pds",["D",1777299199304],"deletedAt","legacyEnvVars",false,"privacy","public","httpPrivacy","description","Foursquare/Swarm checkins → ATProto PDS","imageUrl","60ee761a-2727-4820-a921-a3de0f67378e","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","dc713b9c-8776-46e0-8027-faa0b9eae4af","tursoName","3dda5d80424311f1801142b51c65c3df","tursoHostname","3dda5d80424311f1801142b51c65c3df-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789499469860],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_114":113,"_122":118},"org",{"_114":113,"_115":116,"_117":118,"_18":71,"_119":120,"_121":64},"branch",{"_13":103,"_34":104,"_58":44,"_105":59,"_106":-5,"_107":-5,"_108":-5,"_109":-5,"_110":-5,"_111":60,"_112":113},"isOwned",134,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","barryf","handle","displayName","Barry Frost","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJ4Y3gxZ2p3ZkZydXhzM1lVTnAwekdLMXJBWSJ9","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_58":59,"_34":60,"_40":314,"_62":-5,"_63":64,"_65":66,"_67":66,"_68":69,"_70":-5,"_18":71,"_72":-5,"_73":64,"_74":-5,"_75":-5,"_76":77,"_78":79,"_80":81,"_82":83,"_84":315,"_86":-5,"_87":88,"_89":88,"_90":91,"_92":91,"_93":91,"_94":88,"_95":88,"_96":316,"_98":317,"_100":318,"_102":64},"tree",[232,234,239,240,241,242,243,244,245],"files",[232,233,234,235,236,237,238,239,240,241,242,243,244,245],"counts",{"_221":77,"_222":161,"_223":77,"_224":225,"_226":227},"contents",[145,146,147,148,149,150,151,152,153],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_58":215,"_34":216,"_32":217,"_157":-5,"_43":44,"_42":218,"_159":64,"_40":219,"_13":77,"_36":56,"_38":-5,"_26":64,"_163":-5,"_29":220},{"_58":209,"_34":210,"_32":211,"_157":-5,"_43":44,"_42":212,"_159":27,"_40":213,"_13":77,"_36":56,"_38":-5,"_26":64,"_163":-5,"_29":214},{"_58":202,"_34":203,"_32":204,"_157":-5,"_43":44,"_42":205,"_159":64,"_40":206,"_13":77,"_36":22,"_38":207,"_26":64,"_163":-5,"_29":208},{"_58":195,"_34":196,"_32":197,"_157":-5,"_43":44,"_42":198,"_159":64,"_40":199,"_13":77,"_36":22,"_38":200,"_26":64,"_163":-5,"_29":201},{"_58":188,"_34":189,"_32":190,"_157":-5,"_43":44,"_42":191,"_159":64,"_40":192,"_13":77,"_36":22,"_38":193,"_26":64,"_163":-5,"_29":194},{"_58":181,"_34":182,"_32":183,"_157":-5,"_43":44,"_42":184,"_159":64,"_40":185,"_13":170,"_36":22,"_38":186,"_26":64,"_163":-5,"_29":187},{"_58":174,"_34":175,"_32":176,"_157":-5,"_43":44,"_42":177,"_159":64,"_40":178,"_13":77,"_36":22,"_38":179,"_26":64,"_163":-5,"_29":180},{"_58":165,"_34":166,"_32":167,"_157":-5,"_43":44,"_42":168,"_159":64,"_40":169,"_13":170,"_36":171,"_38":172,"_26":64,"_163":-5,"_29":173},{"_58":154,"_34":155,"_32":156,"_157":-5,"_43":44,"_42":158,"_159":64,"_40":160,"_13":161,"_36":22,"_38":162,"_26":64,"_163":-5,"_29":164},"55f415a2-424b-11f1-a519-42b51c65c3df","deno.json","3f00c4f6-4243-11f1-8240-42b51c65c3df","parentId",97,"latest",["D",1777302675629],1,"{\n \"tasks\": {\n \"bootstrap\": \"deno run --allow-env --allow-net bootstrap/fsq-oauth.ts\",\n \"publish-lexicon\": \"deno run --allow-env --allow-net --allow-read bootstrap/publish-lexicon.ts\"\n }\n}\n","label",[155],"565f61b8-424b-11f1-a0af-42b51c65c3df","cron.ts","3f2214da-4243-11f1-8a8a-42b51c65c3df",100,["D",1777302676038],2,"interval","import {\n ensureSchema,\n getState,\n setState,\n hasCheckin,\n recordCheckin,\n} from \"./lib/db.ts\";\nimport { getCheckins } from \"./lib/foursquare.ts\";\nimport { fetchPhoto } from \"./lib/photos.ts\";\nimport { clearSession, getSession, uploadBlob, createRecord } from \"./lib/atproto.ts\";\n\nconst FSQ_OAUTH_TOKEN = Deno.env.get(\"FSQ_OAUTH_TOKEN\") ?? \"\";\nconst FSQ_API_VERSION = Deno.env.get(\"FSQ_API_VERSION\") ?? \"20240101\";\n\ninterface Interval {\n lastRunAt: Date | undefined;\n}\n\nexport default async function (_interval: Interval): Promise {\n if (!FSQ_OAUTH_TOKEN) {\n console.error(\"FSQ_OAUTH_TOKEN is not set\");\n return;\n }\n\n await ensureSchema();\n clearSession(); // fresh session each run; avoids stale JWT issues\n\n const cursorStr = await getState(\"cursor_ts\");\n\n // First ever run: record the launch time as our cursor and exit.\n // Sync will begin from this point on the next run.\n if (cursorStr === null) {\n const now = Math.floor(Date.now() / 1000);\n await setState(\"launched_at\", String(now));\n await setState(\"cursor_ts\", String(now));\n console.log(`First run: launch cursor set to ${new Date(now * 1000).toISOString()}`);\n return;\n }\n\n const launchTs = parseInt(cursorStr, 10);\n\n console.log(`Fetching recent checkins (launch cursor: ${new Date(launchTs * 1000).toISOString()})`);\n\n let checkins;\n try {\n checkins = await getCheckins(FSQ_OAUTH_TOKEN, FSQ_API_VERSION);\n } catch (err) {\n console.error(\"Failed to fetch checkins from Foursquare:\", err);\n return;\n }\n\n // Filter to checkins after our launch timestamp; FSQ returns newest-first\n const newCheckins = checkins.filter((c) => c.createdAt > launchTs);\n\n if (newCheckins.length === 0) {\n console.log(\"No new checkins\");\n return;\n }\n\n // Process oldest-first so records are written in chronological order\n newCheckins.reverse();\n\n console.log(`Processing ${newCheckins.length} checkin(s)`);\n\n let session;\n try {\n session = await getSession();\n } catch (err) {\n console.error(\"Failed to authenticate with PDS:\", err);\n return;\n }\n\n for (const checkin of newCheckins) {\n if (await hasCheckin(checkin.id)) {\n console.log(`Already synced: ${checkin.id}`);\n continue;\n }\n\n try {\n const location: Record = {\n \"$type\": \"community.lexicon.location.fsq\",\n fsq_place_id: checkin.venue.id,\n name: checkin.venue.name,\n };\n if (checkin.venue.location?.lat != null && checkin.venue.location?.lng != null) {\n location.latitude = String(checkin.venue.location.lat);\n location.longitude = String(checkin.venue.location.lng);\n }\n\n const formattedAddress = checkin.venue.location?.formattedAddress;\n const address = formattedAddress?.length ? formattedAddress.join(\", \") : undefined;\n const category = checkin.venue.categories?.[0]?.name;\n\n const photos: object[] = [];\n for (const photo of checkin.photos?.items ?? []) {\n const fetched = await fetchPhoto(photo);\n if (!fetched) continue;\n try {\n const blobRef = await uploadBlob(session, fetched.bytes, fetched.mimeType);\n photos.push({ image: blobRef });\n } catch (err) {\n // Non-fatal: checkin record still created without this photo\n console.warn(`Photo upload failed for checkin ${checkin.id}:`, err);\n }\n }\n\n const record: Record = {\n \"$type\": \"com.barryfrost.checkin\",\n createdAt: new Date(checkin.createdAt * 1000).toISOString(),\n location,\n ...(address && { address }),\n ...(category && { category }),\n };\n if (photos.length > 0) {\n record.photos = photos;\n }\n\n const { uri, cid } = await createRecord(\n session,\n \"com.barryfrost.checkin\",\n checkin.id, // FSQ checkin ID used as rkey — unique, valid chars, stable\n record,\n );\n\n await recordCheckin(checkin.id, checkin.createdAt, uri, cid);\n console.log(`Synced ${checkin.id} (${checkin.venue.name}) → ${uri}`);\n } catch (err) {\n console.error(`Failed to process checkin ${checkin.id}:`, err);\n // Stop here; seen_checkins dedup ensures next run replays this checkin cleanly\n break;\n }\n }\n}\n\n",[166],"3edd42f6-4243-11f1-a8c8-42b51c65c3df","README.md","3edd43be-4243-11f1-a8c8-42b51c65c3df",6,["D",1777299201001],"# fsq2pds\n\nSyncs your Foursquare/Swarm checkins to your ATProto PDS as `com.barryfrost.checkin` records. Runs on Val.Town's free tier as a 15-minute cron.\n\n## Setup\n\n### 1. Create a Foursquare developer app\n\n1. Go to https://foursquare.com/developers/ and create a new app.\n2. Add `http://localhost:8765/callback` as an allowed Redirect URI.\n3. Note your **Client ID** and **Client Secret**.\n\n### 2. Mint your OAuth token (one-time, local)\n\n```sh\nFSQ_CLIENT_ID= FSQ_CLIENT_SECRET= deno task bootstrap\n```\n\nA browser window will open. Log in and approve. The token is printed to your terminal — it doesn't expire.\n\n### 3. Create a Bluesky app password\n\n1. Go to https://bsky.app/settings/app-passwords\n2. Create a new app password named `fsq2pds`.\n\n### 4. Deploy to Val.Town\n\n1. Install the `vt` CLI: https://docs.val.town/cli/\n2. From this directory run `vt push` (or use the Val.Town editor to paste the files).\n3. Set these **environment variables** in Val.Town settings:\n\n | Variable | Value |\n |----------|-------|\n | `FSQ_OAUTH_TOKEN` | Token from step 2 |\n | `FSQ_API_VERSION` | `20240101` |\n | `BSKY_HANDLE` | Your Bluesky handle |\n | `BSKY_APP_PASSWORD` | App password from step 3 |\n\n4. Open `cron.ts` in Val.Town and add a **cron trigger** set to every 15 minutes.\n\n### 5. Verify\n\n1. **Trigger manually** (first run). It will set the sync cursor to now and exit — no records written yet. Check the logs for `First run: launch cursor set to ...`.\n2. **Check in on Swarm.**\n3. **Trigger again** (or wait up to 15 minutes). Check the logs for `Synced () → at://...`.\n4. **View your records** at:\n ```\n https://pdsls.dev/at:///com.barryfrost.checkin\n ```\n\n## Record shape\n\n```json\n{\n \"$type\": \"com.barryfrost.checkin\",\n \"createdAt\": \"2024-06-01T14:30:00.000Z\",\n \"location\": {\n \"$type\": \"community.lexicon.location.fsq\",\n \"fsq_place_id\": \"abc123def456\",\n \"name\": \"Blue Bottle Coffee\",\n \"latitude\": \"37.776\",\n \"longitude\": \"-122.418\"\n },\n \"photos\": [\n {\n \"image\": {\n \"$type\": \"blob\",\n \"ref\": { \"$link\": \"bafyrei...\" },\n \"mimeType\": \"image/jpeg\",\n \"size\": 245678\n }\n }\n ]\n}\n```\n\n## Notes\n\n- **Only new checkins** are synced. Nothing before the first run is imported.\n- **Photos**: fetched at FSQ's `1024x1024` size. Skipped if >1MB or unreachable.\n- **Edits/deletes**: not synced. Records are write-once. Delete PDS records manually if needed.\n- **If a run fails mid-way**, the cursor stays at the last successful checkin. The next run replays cleanly — duplicate protection is handled by the `seen_checkins` table.\n",[175],"561a12a2-424b-11f1-b750-42b51c65c3df","PLAN.md","3f2a3840-4243-11f1-b8b5-42b51c65c3df",98,["D",1777302675863],"# fsq2pds — Foursquare/Swarm checkins → ATProto PDS\n\n## Context\n\nYou want a personal pipeline that mirrors your Swarm checkins into your Bluesky-hosted PDS as ATProto records, so your website at barryfrost.com can read them via the AT Proto API. The pipeline runs entirely on Val.Town's free tier (Deno) on a 15-minute cron — which happens to be the free-tier cron floor, so this is the right cadence regardless. State lives in Val.Town SQLite (per-val 10MB DB) for robust idempotency. Records use the `community.lexicon.location.fsq` struct (embedded, not referenced — that schema is an object meant to live inside other records) wrapped in a bespoke `com.barryfrost.checkin` record.\n\n## Decisions locked in (from clarifying Q&A)\n\n- **Source**: Foursquare/Swarm v2 API via OAuth2 user token (you have a dev account, will mint a token via one-time bootstrap).\n- **Polling, not Push API**: 15-min cron is fine for a website backfill latency; Push API adds a public webhook + signature verification. Skip unless we need sub-15-min freshness later.\n- **Backfill**: none. First run records \"launch timestamp\"; only checkins after that get synced.\n- **State**: Val.Town SQLite, val-scoped (`std/sqlite`). UNIQUE PK on FSQ checkin id is the idempotency primitive.\n- **Record contents**: `createdAt` + embedded `community.lexicon.location.fsq` + photos (uploaded as PDS blobs). No shout text, no categories. (Easy to add later — record schema is yours.)\n- **Edits/deletes in Swarm**: ignored. Records are write-once. If you delete a Swarm checkin you'll manually delete the PDS record.\n- **Lexicon NSID**: `com.barryfrost.checkin`.\n- **PDS**: `bsky.social`, app-password auth.\n\n## Architecture\n\n```\n┌─────────────────────────┐ every 15min ┌────────────────────┐\n│ Val.Town cron val │ ───────────────────▶ │ Foursquare v2 API │\n│ cron.ts │ GET users/self/ │ (oauth_token) │\n│ │ checkins?after=... └────────────────────┘\n│ │\n│ ┌──────────────┐ │ per new checkin\n│ │ SQLite │ ◀──▶ │ 1. fetch photo bytes (if any)\n│ │ seen_checkins│ │ 2. createSession on bsky.social\n│ │ sync_state │ │ 3. uploadBlob × N photos\n│ └──────────────┘ │ 4. createRecord (com.barryfrost.checkin)\n│ │ 5. insert seen_checkins row\n│ │\n│ │ ───────────────────▶ ┌────────────────────┐\n└─────────────────────────┘ │ bsky.social PDS │\n │ XRPC │\n └────────────────────┘\n```\n\n## File layout (Val.Town project, edited locally via `vt`)\n\n```\nfsq2pds/\n├── CLAUDE.md # session context for future Claude runs\n├── README.md # setup steps (token mint, env vars)\n├── deno.json # imports + tasks\n├── cron.ts # main cron entry point\n├── lib/\n│ ├── foursquare.ts # FSQ v2 client (checkins, photo URL build)\n│ ├── atproto.ts # bsky XRPC: createSession, uploadBlob, createRecord\n│ ├── db.ts # SQLite schema + helpers\n│ └── photos.ts # fetch photo bytes from FSQ photo prefix/suffix\n├── lexicons/\n│ └── com.barryfrost.checkin.json # lexicon doc (publishable to PDS later)\n└── bootstrap/\n └── fsq-oauth.ts # one-time local script to mint FSQ token\n```\n\n## Lexicon: `com.barryfrost.checkin`\n\n```json\n{\n \"lexicon\": 1,\n \"id\": \"com.barryfrost.checkin\",\n \"defs\": {\n \"main\": {\n \"type\": \"record\",\n \"key\": \"tid\",\n \"record\": {\n \"type\": \"object\",\n \"required\": [\"createdAt\", \"location\"],\n \"properties\": {\n \"createdAt\": { \"type\": \"string\", \"format\": \"datetime\" },\n \"location\": {\n \"type\": \"ref\",\n \"ref\": \"community.lexicon.location.fsq\"\n },\n \"photos\": {\n \"type\": \"array\",\n \"maxLength\": 8,\n \"items\": {\n \"type\": \"object\",\n \"required\": [\"image\"],\n \"properties\": {\n \"image\": {\n \"type\": \"blob\",\n \"accept\": [\"image/jpeg\", \"image/png\", \"image/webp\"],\n \"maxSize\": 1000000\n },\n \"alt\": { \"type\": \"string\", \"maxLength\": 1000 }\n }\n }\n }\n }\n }\n }\n }\n}\n```\n\nEmbedded location object inside each record looks like:\n```json\n{\n \"$type\": \"community.lexicon.location.fsq\",\n \"fsq_place_id\": \"\",\n \"name\": \"Blue Bottle Coffee\",\n \"latitude\": \"37.776\",\n \"longitude\": \"-122.418\"\n}\n```\n\nRecord `rkey` = TID derived from FSQ `createdAt` (gives chronological ordering for free).\n\n## SQLite schema\n\n```sql\nCREATE TABLE IF NOT EXISTS seen_checkins (\n fsq_id TEXT PRIMARY KEY,\n fsq_created_at INTEGER NOT NULL, -- unix seconds\n pds_at_uri TEXT NOT NULL,\n pds_cid TEXT NOT NULL,\n processed_at INTEGER NOT NULL DEFAULT (unixepoch())\n);\nCREATE INDEX IF NOT EXISTS idx_seen_created ON seen_checkins(fsq_created_at);\n\nCREATE TABLE IF NOT EXISTS sync_state (\n key TEXT PRIMARY KEY,\n value TEXT NOT NULL\n);\n-- 'cursor_ts' → unix sec; advance only after successful run\n-- 'launched_at' → unix sec; written once on first ever run, used as initial cursor\n```\n\nThe PRIMARY KEY on `fsq_id` is the durability anchor: even if FSQ returns a checkin twice, or a run dies after PDS write but before cursor advance, the `INSERT OR IGNORE` keeps things consistent.\n\n## Cron flow (cron.ts, runs every 15 min)\n\n1. Open SQLite, ensure schema.\n2. `cursor_ts = sync_state['cursor_ts']`. If null → set `launched_at = now()`, `cursor_ts = now()`, exit (next run does the work).\n3. Call FSQ: `GET /v2/users/self/checkins?oauth_token=…&v=20240101&afterTimestamp=&sort=oldestfirst&limit=50`.\n4. For each checkin (in order):\n - Skip if `fsq_id` already in `seen_checkins`.\n - Build `community.lexicon.location.fsq` from `venue` (id, name, lat/lng).\n - For each `photos.items[]`: fetch `${prefix}1024x1024${suffix}` (caps each photo at safe size; FSQ's \"original\" can exceed 1MB lex limit), keep bytes only if ≤ 1,000,000 bytes.\n - Lazily createSession (once per cron run); cache `accessJwt` in a module-scoped variable.\n - For each photo: `com.atproto.repo.uploadBlob` → blob ref.\n - `com.atproto.repo.createRecord` with `repo=`, `collection=com.barryfrost.checkin`, `rkey=`, `record={createdAt, location, photos}`.\n - On success: `INSERT OR IGNORE` into `seen_checkins`, advance in-memory `cursor_ts` to `max(cursor_ts, fsq_created_at)`.\n - On failure: log, do NOT advance cursor past this id, continue to next (or break — see \"Failure semantics\" below).\n5. Persist final `cursor_ts` to `sync_state`.\n\n### Failure semantics\n\n- Per-checkin try/catch. A failure on one checkin stops the run (so we don't skip past it) but the cursor stays at the last *successfully* processed checkin's timestamp. Next run picks up at the same point; idempotency on `fsq_id` ensures any partially-processed checkin (e.g. blobs uploaded but record not created) just retries cleanly — orphan blobs on the PDS are GC'd by Bluesky after a TTL.\n- Network/auth errors at the top of the run abort early, no state change.\n\n## Secrets (Val.Town env vars)\n\n| Name | Purpose |\n|---|---|\n| `FSQ_OAUTH_TOKEN` | Long-lived FSQ user token (minted via bootstrap, doesn't expire) |\n| `FSQ_API_VERSION` | e.g. `20240101` — the FSQ `v=` param |\n| `BSKY_HANDLE` | e.g. `barryfrost.com` or `barryfrost.bsky.social` |\n| `BSKY_APP_PASSWORD` | App password from bsky.app/settings/app-passwords |\n| `BSKY_PDS_URL` | `https://bsky.social` (default) |\n\n## Bootstrap (one-time, run locally)\n\n`bootstrap/fsq-oauth.ts` — small Deno script:\n1. Print FSQ authorize URL using `FSQ_CLIENT_ID` from env + redirect_uri `http://localhost:8765/callback`.\n2. Spin up a one-shot HTTP server on `:8765`, capture `?code=`.\n3. POST to `https://foursquare.com/oauth2/access_token` to exchange for `access_token`.\n4. Print the token to stdout — paste into Val.Town env var.\n\nThis stays local (not deployed) because it needs an interactive browser handoff and is one-time.\n\n## Maintenance & durability notes\n\n- **Token longevity**: FSQ OAuth user tokens don't expire (historically). Bluesky `accessJwt` expires in ~2h, but we createSession each cron run — one extra request, no refresh logic, no edge cases. Trade tiny request volume for zero state.\n- **Rate limits**: FSQ ≈ 500 req/h/user — we use 1 req per 15 min plus a few per checkin → trivial. Bluesky free is generous; one session + N writes per run is fine.\n- **Storage**: 10MB SQLite holds ~100k checkin rows easily. Photos go to PDS blob storage, not Val.Town.\n- **Photo size**: We pull the `1024x1024` FSQ variant (rather than `original`) to stay under the 1MB lex `maxSize`. If a photo still exceeds 1MB after fetch, skip it (record still gets created without that photo) and log.\n- **Cron drift / catch-up**: If Val.Town cron is paused for hours, the `afterTimestamp` cursor + 50-checkin page size means we replay the gap on resume. For longer outages, the run loops through pages until current.\n- **Observability**: Log per checkin (fsq_id → at-uri); inspect via Val.Town logs UI. SQLite `seen_checkins` is the audit trail.\n- **Single-user assumption**: All code assumes one operator. No multi-tenancy in schema or auth.\n\n## Critical files / external references\n\n- Val.Town SQLite: `import { sqlite } from \"https://esm.town/v/std/sqlite\"`.\n- Val.Town blob (not used here, but available): `https://esm.town/v/std/blob`.\n- FSQ v2 endpoint: `https://api.foursquare.com/v2/users/self/checkins`.\n- Bluesky XRPC: `https://bsky.social/xrpc/com.atproto.server.createSession`, `…/com.atproto.repo.uploadBlob`, `…/com.atproto.repo.createRecord`.\n- Lexicon to embed: `community.lexicon.location.fsq` (struct, NOT a record — embedded via `$type` field).\n\n## Verification\n\nEnd-to-end test plan once deployed:\n1. **Bootstrap**: run `bootstrap/fsq-oauth.ts` locally, paste token into Val.Town env.\n2. **First-run gating**: deploy cron, trigger manually once. Confirm `sync_state` rows for `launched_at` and `cursor_ts` exist; no records written yet.\n3. **Real checkin**: do a real Swarm checkin (with a photo). Wait ≤15 min for next cron tick (or trigger manually).\n4. **PDS verification**: open `https://pdsls.dev/at:///com.barryfrost.checkin` (or `https://atproto-browser.vercel.app/at//com.barryfrost.checkin`) — confirm record exists with embedded location and photo blob.\n5. **Idempotency**: trigger cron again immediately. Confirm no duplicate record (check PDS list, check SQLite has only one row for that fsq_id).\n6. **DB inspection**: Val.Town admin → SQLite → `SELECT * FROM seen_checkins ORDER BY fsq_created_at DESC LIMIT 5`.\n7. **Failure replay** (optional): manually delete the just-written PDS record, then `DELETE FROM seen_checkins WHERE fsq_id = '…'`, trigger cron — confirm it re-creates cleanly.\n\n## Teething issues (encountered during setup)\n\n- **FSQ token exchange uses GET, not POST**: Foursquare's `/oauth2/access_token` endpoint expects a GET request with query params, not a POST with a JSON body. `bootstrap/fsq-oauth.ts` was fixed accordingly. The `\"unsupported_grant_type\"` error is the symptom if you accidentally revert this.\n- **`vt push` requires prior `vt create`**: The `vt` CLI needs a `.vt` directory (created by `vt create`) before `vt push` works. On a fresh local clone, run `vt create` first to initialise the project, then `vt push`.\n- **`BSKY_PDS_URL` env var warning**: Val.Town warns about any `Deno.env.get(...)` reference that isn't set in env vars, even when the code has a fallback default. Suppress by adding `BSKY_PDS_URL` = `https://bsky.social` to Val.Town env vars. Functionally harmless either way.\n- **FSQ `afterTimestamp` param is broken**: The original cron used `afterTimestamp` + `sort=oldestfirst` to filter server-side. The API returns `count: 1318, items: []` — non-zero count but empty items. Switched to fetching the 50 most recent checkins (default newest-first, no filter params) and filtering locally against the `cursor_ts` launch gate. Dedup via `seen_checkins` PRIMARY KEY handles idempotency. The `cursor_ts` value is now a fixed launch gate (never advanced), not a sliding cursor.\n\n## Out of scope (v1)\n\n- Edits / deletes from Swarm (you'll manage manually).\n- Shout text, venue categories (easy to add to lexicon later — additive change, won't break existing records).\n- Push API webhook (revisit if 15-min latency feels too slow).\n- Publishing the lexicon doc itself to your PDS as `com.atproto.lexicon.schema` (nice-to-have, doesn't affect record validity).\n- Backfill of historical checkins.\n",[182],"3f327bb8-4243-11f1-8240-42b51c65c3df","CLAUDE.md","3f327c94-4243-11f1-8240-42b51c65c3df",16,["D",1777299201543],"# fsq2pds\n\nSyncs Foursquare/Swarm checkins to an ATProto PDS (bsky.social) as `com.barryfrost.checkin` records. Runs as a Val.Town cron val (Deno) every 15 minutes — the free-tier cron minimum.\n\n## File layout\n\n| File | Purpose |\n|------|---------|\n| `cron.ts` | Entry point; exported default function is the cron handler |\n| `lib/db.ts` | Val.Town SQLite helpers (schema, state, dedup) |\n| `lib/foursquare.ts` | Foursquare v2 API client |\n| `lib/atproto.ts` | Bluesky XRPC client (createSession, uploadBlob, createRecord) |\n| `lib/photos.ts` | Downloads FSQ photos, enforces 1MB size cap |\n| `lexicons/com.barryfrost.checkin.json` | Lexicon doc for the checkin record type |\n| `bootstrap/fsq-oauth.ts` | One-time local script to mint an FSQ OAuth token |\n\n## Required env vars (Val.Town secrets)\n\n| Var | Purpose |\n|-----|---------|\n| `FSQ_OAUTH_TOKEN` | Long-lived Foursquare user token (doesn't expire) |\n| `FSQ_API_VERSION` | FSQ API date-version param (e.g. `20240101`) |\n| `BSKY_HANDLE` | Bluesky handle (e.g. `barryfrost.com`) |\n| `BSKY_APP_PASSWORD` | Bluesky app password from bsky.app/settings/app-passwords |\n| `BSKY_PDS_URL` | PDS base URL (optional; defaults to `https://bsky.social`) |\n\n## Key design decisions\n\n- **Idempotency**: `seen_checkins` table with PRIMARY KEY on `fsq_id`. `INSERT OR IGNORE` means re-running is always safe.\n- **Cursor**: `sync_state` table holds `cursor_ts` (unix seconds). Advanced only after successful write.\n- **First run**: Sets cursor to NOW and exits immediately. Sync begins next run (prevents accidental historical import).\n- **rkey**: Uses FSQ checkin ID directly (hex string, valid AT Proto rkey chars, guaranteed unique).\n- **Photos**: Downloaded at FSQ's `1024x1024` size variant. Skipped silently if fetch fails or bytes > 1MB. Checkin record still created.\n- **Session**: `createSession` called at the start of each cron run. No refresh token logic.\n- **Edits/deletes**: Not synced. Records are write-once. Manually delete PDS records if needed.\n- **Backfill**: None. Only checkins after first-run timestamp are synced.\n\n## Lexicon\n\nRecord collection: `com.barryfrost.checkin` \nLocation embedded via `community.lexicon.location.fsq` (struct, not a separate record). \nRecord shape: `{ createdAt, location, photos? }`\n\n## Observability\n\n- Val.Town logs show per-checkin outcome: `Synced () → at://...`\n- SQLite `seen_checkins` is the audit trail; inspect via Val.Town admin panel.\n- `sync_state` holds `cursor_ts` and `launched_at`.\n",[189],"f1bc3a32-424b-11f1-8e47-42b51c65c3df",".vtignore","f1bc3adc-424b-11f1-8e47-42b51c65c3df",102,["D",1777302937067],".git/\n.gitignore\n.claude/\nPLAN.md\nREADME.md\nbootstrap/\nlexicons/\n",[196],"55017cde-424b-11f1-b792-42b51c65c3df",".gitignore","55017d92-424b-11f1-b792-42b51c65c3df",65,["D",1777302674034],".vt/\n.env\n.claude/\n",[203],"3eb4128c-4243-11f1-bd90-42b51c65c3df","lib","3eb4134a-4243-11f1-bd90-42b51c65c3df",4,["D",1777299200731],[210],"3e943124-4243-11f1-b1e3-42b51c65c3df","lexicons","3e9431e2-4243-11f1-b1e3-42b51c65c3df",3,["D",1777299200522],[216],"pulls","branches","forks","envVars",{"_228":230,"_231":77},"connections",{"_228":77,"_229":77},"count","unfilledCount",5,"emptyCount",{"_58":215,"_34":216,"_32":217,"_157":-5,"_43":44,"_42":218,"_159":64,"_40":311,"_13":77,"_36":56,"_38":-5,"_26":64,"_163":-5,"_247":312,"_29":313},{"_58":303,"_34":304,"_32":305,"_157":217,"_43":44,"_42":306,"_159":64,"_40":307,"_13":161,"_36":22,"_38":308,"_26":64,"_163":-5,"_247":309,"_29":310},{"_58":209,"_34":210,"_32":211,"_157":-5,"_43":44,"_42":212,"_159":27,"_40":300,"_13":77,"_36":56,"_38":-5,"_26":64,"_163":-5,"_247":301,"_29":302},{"_58":292,"_34":293,"_32":294,"_157":211,"_43":44,"_42":295,"_159":64,"_40":296,"_13":77,"_36":37,"_38":297,"_26":64,"_163":-5,"_247":298,"_29":299},{"_58":284,"_34":285,"_32":286,"_157":211,"_43":44,"_42":287,"_159":27,"_40":288,"_13":77,"_36":37,"_38":289,"_26":64,"_163":-5,"_247":290,"_29":291},{"_58":276,"_34":277,"_32":278,"_157":211,"_43":44,"_42":279,"_159":64,"_40":280,"_13":218,"_36":37,"_38":281,"_26":64,"_163":-5,"_247":282,"_29":283},{"_58":268,"_34":269,"_32":270,"_157":211,"_43":44,"_42":271,"_159":64,"_40":272,"_13":77,"_36":37,"_38":273,"_26":64,"_163":-5,"_247":274,"_29":275},{"_58":202,"_34":203,"_32":204,"_157":-5,"_43":44,"_42":205,"_159":64,"_40":265,"_13":77,"_36":22,"_38":207,"_26":64,"_163":-5,"_247":266,"_29":267},{"_58":195,"_34":196,"_32":197,"_157":-5,"_43":44,"_42":198,"_159":64,"_40":262,"_13":77,"_36":22,"_38":200,"_26":64,"_163":-5,"_247":263,"_29":264},{"_58":188,"_34":189,"_32":190,"_157":-5,"_43":44,"_42":191,"_159":64,"_40":259,"_13":77,"_36":22,"_38":193,"_26":64,"_163":-5,"_247":260,"_29":261},{"_58":181,"_34":182,"_32":183,"_157":-5,"_43":44,"_42":184,"_159":64,"_40":256,"_13":170,"_36":22,"_38":186,"_26":64,"_163":-5,"_247":257,"_29":258},{"_58":174,"_34":175,"_32":176,"_157":-5,"_43":44,"_42":177,"_159":64,"_40":253,"_13":77,"_36":22,"_38":179,"_26":64,"_163":-5,"_247":254,"_29":255},{"_58":165,"_34":166,"_32":167,"_157":-5,"_43":44,"_42":168,"_159":64,"_40":250,"_13":170,"_36":171,"_38":172,"_26":64,"_163":-5,"_247":251,"_29":252},{"_58":154,"_34":155,"_32":156,"_157":-5,"_43":44,"_42":158,"_159":64,"_40":246,"_13":161,"_36":22,"_38":162,"_26":64,"_163":-5,"_247":248,"_29":249},["D",1777302675629],"children",[],[155],["D",1777302676038],[],[166],["D",1777299201001],[],[175],["D",1777302675863],[],[182],["D",1777299201543],[],[189],["D",1777302937067],[],[196],["D",1777302674034],[],[203],"3ef89970-4243-11f1-a8c8-42b51c65c3df","photos.ts","3ef89a10-4243-11f1-a8c8-42b51c65c3df",8,["D",1777299201181],"import { photoUrl, type FsqPhoto } from \"./foursquare.ts\";\n\nconst MAX_PHOTO_BYTES = 1_000_000;\n\nexport interface FetchedPhoto {\n bytes: Uint8Array;\n mimeType: string;\n}\n\nexport async function fetchPhoto(photo: FsqPhoto): Promise {\n const url = photoUrl(photo);\n try {\n const resp = await fetch(url);\n if (!resp.ok) {\n console.warn(`Photo fetch failed (${resp.status}): ${url}`);\n return null;\n }\n const bytes = new Uint8Array(await resp.arrayBuffer());\n if (bytes.byteLength > MAX_PHOTO_BYTES) {\n console.warn(`Photo too large (${bytes.byteLength} bytes), skipping: ${url}`);\n return null;\n }\n const mimeType = resp.headers.get(\"content-type\")?.split(\";\")[0].trim() ?? \"image/jpeg\";\n return { bytes, mimeType };\n } catch (err) {\n console.warn(`Photo fetch error for ${url}:`, err);\n return null;\n }\n}\n",[],[210,269],"566b4500-424b-11f1-b6f5-42b51c65c3df","foursquare.ts","3f1362aa-4243-11f1-a9ae-42b51c65c3df",101,["D",1777302676037],"const FSQ_API_BASE = \"https://api.foursquare.com/v2\";\n\nexport interface FsqPhoto {\n prefix: string;\n suffix: string;\n}\n\nexport interface FsqCheckin {\n id: string;\n createdAt: number; // unix seconds\n venue: {\n id: string;\n name: string;\n location?: {\n lat?: number;\n lng?: number;\n formattedAddress?: string[];\n };\n categories?: { name: string }[];\n };\n photos?: {\n count: number;\n items: FsqPhoto[];\n };\n}\n\nexport async function getCheckins(\n oauthToken: string,\n apiVersion: string,\n): Promise {\n const params = new URLSearchParams({\n oauth_token: oauthToken,\n v: apiVersion,\n limit: \"50\",\n });\n const resp = await fetch(`${FSQ_API_BASE}/users/self/checkins?${params}`);\n if (!resp.ok) {\n throw new Error(`FSQ API error ${resp.status}: ${await resp.text()}`);\n }\n const data = await resp.json();\n if (data.meta?.code !== 200) {\n throw new Error(`FSQ API returned non-200: ${JSON.stringify(data.meta)}`);\n }\n return (data.response?.checkins?.items ?? []) as FsqCheckin[];\n}\n\nexport function photoUrl(photo: FsqPhoto, size = \"1024x1024\"): string {\n return `${photo.prefix}${size}${photo.suffix}`;\n}\n",[],[210,277],"3f1dea7c-4243-11f1-8a98-42b51c65c3df","db.ts","3f1deb4e-4243-11f1-8a98-42b51c65c3df",13,["D",1777299201415],"import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nexport async function ensureSchema(): Promise {\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS seen_checkins (\n fsq_id TEXT PRIMARY KEY,\n fsq_created_at INTEGER NOT NULL,\n pds_at_uri TEXT NOT NULL,\n pds_cid TEXT NOT NULL,\n processed_at INTEGER NOT NULL DEFAULT (unixepoch())\n )\n `);\n await sqlite.execute(\n `CREATE INDEX IF NOT EXISTS idx_seen_created ON seen_checkins(fsq_created_at)`,\n );\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS sync_state (\n key TEXT PRIMARY KEY,\n value TEXT NOT NULL\n )\n `);\n}\n\nexport async function getState(key: string): Promise {\n const result = await sqlite.execute({\n sql: \"SELECT value FROM sync_state WHERE key = ?\",\n args: [key],\n });\n return result.rows.length > 0 ? String(result.rows[0].value) : null;\n}\n\nexport async function setState(key: string, value: string): Promise {\n await sqlite.execute({\n sql: \"INSERT OR REPLACE INTO sync_state (key, value) VALUES (?, ?)\",\n args: [key, value],\n });\n}\n\nexport async function hasCheckin(fsqId: string): Promise {\n const result = await sqlite.execute({\n sql: \"SELECT 1 FROM seen_checkins WHERE fsq_id = ?\",\n args: [fsqId],\n });\n return result.rows.length > 0;\n}\n\nexport async function recordCheckin(\n fsqId: string,\n fsqCreatedAt: number,\n pdsAtUri: string,\n pdsCid: string,\n): Promise {\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO seen_checkins (fsq_id, fsq_created_at, pds_at_uri, pds_cid)\n VALUES (?, ?, ?, ?)`,\n args: [fsqId, fsqCreatedAt, pdsAtUri, pdsCid],\n });\n}\n",[],[210,285],"3f18edf6-4243-11f1-a8c8-42b51c65c3df","atproto.ts","3f18eea0-4243-11f1-a8c8-42b51c65c3df",12,["D",1777299201382],"const PDS_URL = Deno.env.get(\"BSKY_PDS_URL\") ?? \"https://bsky.social\";\n\ninterface Session {\n accessJwt: string;\n did: string;\n}\n\n// Module-scoped session cache; cleared on each cron invocation via clearSession()\nlet cachedSession: Session | null = null;\n\nexport function clearSession(): void {\n cachedSession = null;\n}\n\nexport async function getSession(): Promise {\n if (cachedSession) return cachedSession;\n const handle = Deno.env.get(\"BSKY_HANDLE\");\n const password = Deno.env.get(\"BSKY_APP_PASSWORD\");\n if (!handle || !password) {\n throw new Error(\"BSKY_HANDLE and BSKY_APP_PASSWORD env vars are required\");\n }\n const resp = await fetch(`${PDS_URL}/xrpc/com.atproto.server.createSession`, {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\" },\n body: JSON.stringify({ identifier: handle, password }),\n });\n if (!resp.ok) {\n throw new Error(`createSession failed (${resp.status}): ${await resp.text()}`);\n }\n const data = await resp.json();\n cachedSession = { accessJwt: data.accessJwt, did: data.did };\n return cachedSession;\n}\n\nexport async function uploadBlob(\n session: Session,\n bytes: Uint8Array,\n mimeType: string,\n): Promise

Diff · v105