[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_273":274,"_275":276},"routes/_app.x.$handle.$name",{"_97":96,"_32":43,"_106":87,"_27":107,"_13":14,"_108":-5,"_11":109,"_110":111,"_112":113,"_114":115,"_116":117,"_20":-5,"_118":-5,"_119":-5,"_120":47,"_121":122,"_123":47,"_124":-5,"_125":-5,"_126":127},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_41":42,"_32":43,"_36":44,"_45":-5,"_46":47,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":-5,"_56":47,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":68,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":80,"_81":82,"_83":84,"_85":47},"version",107,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":20,"_34":35,"_36":37,"_38":14,"_39":40,"_24":25},"previous",{"_30":31,"_32":28,"_33":20,"_34":35},"deleted",true,"deletedHere","path",".gitignore","latestPath","fileId","55017d92-424b-11f1-b792-42b51c65c3df","name","fileType","content",".vt/\n.env\n.claude/\n","createdAt",["D",1777302990163],"branchVersion","branchId","3ddb19fa-4243-11f1-8011-42b51c65c3df","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",{"_97":96,"_105":101},"org",{"_97":96,"_98":99,"_100":101,"_18":54,"_102":103,"_104":47},"branch",{"_13":86,"_32":87,"_41":40,"_88":42,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":43,"_95":96},"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",{"_41":42,"_32":43,"_36":268,"_45":-5,"_46":47,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":-5,"_56":47,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":269,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":270,"_81":271,"_83":272,"_85":47},"tree",[201,206,207,208,209,210,211],"files",[201,202,203,204,205,206,207,208,209,210,211],"counts",{"_190":60,"_191":142,"_192":60,"_193":194,"_195":196},"contents",[128,129,130,131,132,133,134],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_41":183,"_32":184,"_30":185,"_138":-5,"_39":40,"_38":186,"_140":25,"_36":187,"_13":60,"_33":188,"_34":-5,"_24":47,"_144":-5,"_27":189},{"_41":176,"_32":177,"_30":178,"_138":-5,"_39":40,"_38":179,"_140":47,"_36":180,"_13":60,"_33":20,"_34":181,"_24":47,"_144":-5,"_27":182},{"_41":169,"_32":170,"_30":171,"_138":-5,"_39":40,"_38":172,"_140":47,"_36":173,"_13":60,"_33":20,"_34":174,"_24":47,"_144":-5,"_27":175},{"_41":162,"_32":163,"_30":164,"_138":-5,"_39":40,"_38":165,"_140":47,"_36":166,"_13":151,"_33":20,"_34":167,"_24":47,"_144":-5,"_27":168},{"_41":155,"_32":156,"_30":157,"_138":-5,"_39":40,"_38":158,"_140":47,"_36":159,"_13":60,"_33":20,"_34":160,"_24":47,"_144":-5,"_27":161},{"_41":146,"_32":147,"_30":148,"_138":-5,"_39":40,"_38":149,"_140":47,"_36":150,"_13":151,"_33":152,"_34":153,"_24":47,"_144":-5,"_27":154},{"_41":135,"_32":136,"_30":137,"_138":-5,"_39":40,"_38":139,"_140":47,"_36":141,"_13":142,"_33":20,"_34":143,"_24":47,"_144":-5,"_27":145},"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",[136],"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",[147],"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",[156],"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",[163],"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",[170],"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",[177],"3eb4128c-4243-11f1-bd90-42b51c65c3df","lib","3eb4134a-4243-11f1-bd90-42b51c65c3df",4,["D",1777299200731],"directory",[184],"pulls","branches","forks","envVars",{"_197":199,"_200":60},"connections",{"_197":60,"_198":60},"count","unfilledCount",5,"emptyCount",{"_41":183,"_32":184,"_30":185,"_138":-5,"_39":40,"_38":186,"_140":25,"_36":265,"_13":60,"_33":188,"_34":-5,"_24":47,"_144":-5,"_213":266,"_27":267},{"_41":257,"_32":258,"_30":259,"_138":185,"_39":40,"_38":260,"_140":47,"_36":261,"_13":60,"_33":236,"_34":262,"_24":47,"_144":-5,"_213":263,"_27":264},{"_41":249,"_32":250,"_30":251,"_138":185,"_39":40,"_38":252,"_140":25,"_36":253,"_13":60,"_33":236,"_34":254,"_24":47,"_144":-5,"_213":255,"_27":256},{"_41":240,"_32":241,"_30":242,"_138":185,"_39":40,"_38":243,"_140":47,"_36":244,"_13":245,"_33":236,"_34":246,"_24":47,"_144":-5,"_213":247,"_27":248},{"_41":231,"_32":232,"_30":233,"_138":185,"_39":40,"_38":234,"_140":47,"_36":235,"_13":60,"_33":236,"_34":237,"_24":47,"_144":-5,"_213":238,"_27":239},{"_41":176,"_32":177,"_30":178,"_138":-5,"_39":40,"_38":179,"_140":47,"_36":228,"_13":60,"_33":20,"_34":181,"_24":47,"_144":-5,"_213":229,"_27":230},{"_41":169,"_32":170,"_30":171,"_138":-5,"_39":40,"_38":172,"_140":47,"_36":225,"_13":60,"_33":20,"_34":174,"_24":47,"_144":-5,"_213":226,"_27":227},{"_41":162,"_32":163,"_30":164,"_138":-5,"_39":40,"_38":165,"_140":47,"_36":222,"_13":151,"_33":20,"_34":167,"_24":47,"_144":-5,"_213":223,"_27":224},{"_41":155,"_32":156,"_30":157,"_138":-5,"_39":40,"_38":158,"_140":47,"_36":219,"_13":60,"_33":20,"_34":160,"_24":47,"_144":-5,"_213":220,"_27":221},{"_41":146,"_32":147,"_30":148,"_138":-5,"_39":40,"_38":149,"_140":47,"_36":216,"_13":151,"_33":152,"_34":153,"_24":47,"_144":-5,"_213":217,"_27":218},{"_41":135,"_32":136,"_30":137,"_138":-5,"_39":40,"_38":139,"_140":47,"_36":212,"_13":142,"_33":20,"_34":143,"_24":47,"_144":-5,"_213":214,"_27":215},["D",1777302675629],"children",[],[136],["D",1777302676038],[],[147],["D",1777299201001],[],[156],["D",1777302675863],[],[163],["D",1777299201543],[],[170],["D",1777302937067],[],[177],"3ef89970-4243-11f1-a8c8-42b51c65c3df","photos.ts","3ef89a10-4243-11f1-a8c8-42b51c65c3df",8,["D",1777299201181],"script","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",[],[184,232],"566b4500-424b-11f1-b6f5-42b51c65c3df","foursquare.ts","3f1362aa-4243-11f1-a9ae-42b51c65c3df",101,["D",1777302676037],3,"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",[],[184,241],"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",[],[184,250],"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 · v107