[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_312":313,"_314":315},"routes/_app.x.$handle.$name",{"_96":95,"_32":43,"_105":86,"_27":106,"_13":14,"_107":-5,"_11":108,"_109":110,"_111":112,"_113":114,"_115":116,"_20":-5,"_117":-5,"_118":-5,"_119":26,"_120":121,"_122":26,"_123":-5,"_124":-5,"_125":126},"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":26,"_47":48,"_49":48,"_50":51,"_52":-5,"_18":53,"_54":-5,"_55":26,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":79,"_80":81,"_82":83,"_84":26},"version",16,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":26,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":20,"_34":35,"_36":37,"_38":14,"_39":40,"_23":26},"previous","deleted",true,"deletedHere",false,"path","CLAUDE.md","latestPath","fileId","3f327c94-4243-11f1-8240-42b51c65c3df","name","fileType","content","# 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","createdAt",["D",1777299201543],"branchVersion","branchId","3ddb19fa-4243-11f1-8011-42b51c65c3df","id","3dda5d80-4243-11f1-8011-42b51c65c3df","fsq2pds",["D",1777299199304],"deletedAt","legacyEnvVars","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",{"_96":95,"_104":100},"org",{"_96":95,"_97":98,"_99":100,"_18":53,"_101":102,"_103":26},"branch",{"_13":85,"_32":86,"_41":40,"_87":42,"_88":-5,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":43,"_94":95},"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":307,"_45":-5,"_46":26,"_47":48,"_49":48,"_50":51,"_52":-5,"_18":53,"_54":-5,"_55":26,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":63,"_64":65,"_66":308,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":309,"_80":310,"_82":311,"_84":26},"tree",[207,209,211,213,218,219,220,221,222],"files",[207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222],"counts",{"_196":59,"_197":187,"_198":59,"_199":200,"_201":202},"contents",[127,128,129,130,131,132,133,134,135],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_41":190,"_32":191,"_30":192,"_139":-5,"_39":40,"_38":193,"_141":26,"_36":194,"_13":59,"_33":176,"_34":-5,"_23":26,"_144":-5,"_27":195},{"_41":184,"_32":185,"_30":186,"_139":-5,"_39":40,"_38":187,"_141":26,"_36":188,"_13":59,"_33":176,"_34":-5,"_23":26,"_144":-5,"_27":189},{"_41":178,"_32":179,"_30":180,"_139":-5,"_39":40,"_38":181,"_141":26,"_36":182,"_13":59,"_33":176,"_34":-5,"_23":26,"_144":-5,"_27":183},{"_41":171,"_32":172,"_30":173,"_139":-5,"_39":40,"_38":174,"_141":24,"_36":175,"_13":59,"_33":176,"_34":-5,"_23":26,"_144":-5,"_27":177},{"_41":168,"_32":28,"_30":31,"_139":-5,"_39":40,"_38":14,"_141":26,"_36":169,"_13":59,"_33":20,"_34":35,"_23":26,"_144":-5,"_27":170},{"_41":161,"_32":162,"_30":163,"_139":-5,"_39":40,"_38":164,"_141":26,"_36":165,"_13":59,"_33":20,"_34":166,"_23":26,"_144":-5,"_27":167},{"_41":154,"_32":155,"_30":156,"_139":-5,"_39":40,"_38":157,"_141":26,"_36":158,"_13":59,"_33":20,"_34":159,"_23":26,"_144":-5,"_27":160},{"_41":146,"_32":147,"_30":148,"_139":-5,"_39":40,"_38":149,"_141":26,"_36":150,"_13":59,"_33":151,"_34":152,"_23":26,"_144":-5,"_27":153},{"_41":136,"_32":137,"_30":138,"_139":-5,"_39":40,"_38":140,"_141":26,"_36":142,"_13":59,"_33":20,"_34":143,"_23":26,"_144":-5,"_27":145},"3f00c438-4243-11f1-8240-42b51c65c3df","deno.json","3f00c4f6-4243-11f1-8240-42b51c65c3df","parentId",9,"latest",["D",1777299201231],"{\n \"tasks\": {\n \"bootstrap\": \"deno run --allow-env --allow-net bootstrap/fsq-oauth.ts\"\n }\n}\n","label",[137],"3f221408-4243-11f1-8a8a-42b51c65c3df","cron.ts","3f2214da-4243-11f1-8a8a-42b51c65c3df",14,["D",1777299201416],"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 let cursorTs = parseInt(cursorStr, 10);\n let newCursorTs = cursorTs;\n\n console.log(`Fetching checkins after ${new Date(cursorTs * 1000).toISOString()}`);\n\n let checkins;\n try {\n checkins = await getCheckins(FSQ_OAUTH_TOKEN, FSQ_API_VERSION, cursorTs);\n } catch (err) {\n console.error(\"Failed to fetch checkins from Foursquare:\", err);\n return;\n }\n\n if (checkins.length === 0) {\n console.log(\"No new checkins\");\n return;\n }\n\n console.log(`Processing ${checkins.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 checkins) {\n // Advance cursor even for already-seen checkins so we don't replay old ones\n if (await hasCheckin(checkin.id)) {\n console.log(`Already synced: ${checkin.id}`);\n newCursorTs = Math.max(newCursorTs, checkin.createdAt);\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 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 };\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 newCursorTs = Math.max(newCursorTs, checkin.createdAt);\n } catch (err) {\n console.error(`Failed to process checkin ${checkin.id}:`, err);\n // Stop here; cursor stays at last successful point so next run replays this checkin\n break;\n }\n }\n\n if (newCursorTs > cursorTs) {\n await setState(\"cursor_ts\", String(newCursorTs));\n console.log(`Cursor advanced to ${new Date(newCursorTs * 1000).toISOString()}`);\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",[155],"3f2a3746-4243-11f1-b8b5-42b51c65c3df","PLAN.md","3f2a3840-4243-11f1-b8b5-42b51c65c3df",15,["D",1777299201501],"# 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## 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",[162],"3f327bb8-4243-11f1-8240-42b51c65c3df",["D",1777299201543],[28],"3eb4128c-4243-11f1-bd90-42b51c65c3df","lib","3eb4134a-4243-11f1-bd90-42b51c65c3df",4,["D",1777299200731],"directory",[172],"3e943124-4243-11f1-b1e3-42b51c65c3df","lexicons","3e9431e2-4243-11f1-b1e3-42b51c65c3df",3,["D",1777299200522],[179],"3e4b85e6-4243-11f1-8011-42b51c65c3df","bootstrap","3e4b86c2-4243-11f1-8011-42b51c65c3df",1,["D",1777299200039],[185],"3e707a68-4243-11f1-b8b5-42b51c65c3df",".claude","3e707b44-4243-11f1-b8b5-42b51c65c3df",2,["D",1777299200287],[191],"pulls","branches","forks","envVars",{"_203":205,"_206":59},"connections",{"_203":59,"_204":59},"count","unfilledCount",5,"emptyCount",{"_41":190,"_32":191,"_30":192,"_139":-5,"_39":40,"_38":193,"_141":26,"_36":304,"_13":59,"_33":176,"_34":-5,"_23":26,"_144":-5,"_224":305,"_27":306},{"_41":296,"_32":297,"_30":298,"_139":192,"_39":40,"_38":299,"_141":26,"_36":300,"_13":59,"_33":20,"_34":301,"_23":26,"_144":-5,"_224":302,"_27":303},{"_41":184,"_32":185,"_30":186,"_139":-5,"_39":40,"_38":187,"_141":26,"_36":293,"_13":59,"_33":176,"_34":-5,"_23":26,"_144":-5,"_224":294,"_27":295},{"_41":286,"_32":287,"_30":288,"_139":186,"_39":40,"_38":205,"_141":26,"_36":289,"_13":59,"_33":244,"_34":290,"_23":26,"_144":-5,"_224":291,"_27":292},{"_41":178,"_32":179,"_30":180,"_139":-5,"_39":40,"_38":181,"_141":26,"_36":283,"_13":59,"_33":176,"_34":-5,"_23":26,"_144":-5,"_224":284,"_27":285},{"_41":275,"_32":276,"_30":277,"_139":180,"_39":40,"_38":278,"_141":26,"_36":279,"_13":59,"_33":20,"_34":280,"_23":26,"_144":-5,"_224":281,"_27":282},{"_41":171,"_32":172,"_30":173,"_139":-5,"_39":40,"_38":174,"_141":24,"_36":272,"_13":59,"_33":176,"_34":-5,"_23":26,"_144":-5,"_224":273,"_27":274},{"_41":264,"_32":265,"_30":266,"_139":173,"_39":40,"_38":267,"_141":26,"_36":268,"_13":59,"_33":244,"_34":269,"_23":26,"_144":-5,"_224":270,"_27":271},{"_41":256,"_32":257,"_30":258,"_139":173,"_39":40,"_38":259,"_141":24,"_36":260,"_13":59,"_33":244,"_34":261,"_23":26,"_144":-5,"_224":262,"_27":263},{"_41":248,"_32":249,"_30":250,"_139":173,"_39":40,"_38":251,"_141":26,"_36":252,"_13":59,"_33":244,"_34":253,"_23":26,"_144":-5,"_224":254,"_27":255},{"_41":239,"_32":240,"_30":241,"_139":173,"_39":40,"_38":242,"_141":26,"_36":243,"_13":59,"_33":244,"_34":245,"_23":26,"_144":-5,"_224":246,"_27":247},{"_41":168,"_32":28,"_30":31,"_139":-5,"_39":40,"_38":14,"_141":26,"_36":236,"_13":59,"_33":20,"_34":35,"_23":26,"_144":-5,"_224":237,"_27":238},{"_41":161,"_32":162,"_30":163,"_139":-5,"_39":40,"_38":164,"_141":26,"_36":233,"_13":59,"_33":20,"_34":166,"_23":26,"_144":-5,"_224":234,"_27":235},{"_41":154,"_32":155,"_30":156,"_139":-5,"_39":40,"_38":157,"_141":26,"_36":230,"_13":59,"_33":20,"_34":159,"_23":26,"_144":-5,"_224":231,"_27":232},{"_41":146,"_32":147,"_30":148,"_139":-5,"_39":40,"_38":149,"_141":26,"_36":227,"_13":59,"_33":151,"_34":152,"_23":26,"_144":-5,"_224":228,"_27":229},{"_41":136,"_32":137,"_30":138,"_139":-5,"_39":40,"_38":140,"_141":26,"_36":223,"_13":59,"_33":20,"_34":143,"_23":26,"_144":-5,"_224":225,"_27":226},["D",1777299201231],"children",[],[137],["D",1777299201416],[],[147],["D",1777299201001],[],[155],["D",1777299201501],[],[162],["D",1777299201543],[],[28],"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",[],[172,240],"3f1361b0-4243-11f1-a9ae-42b51c65c3df","foursquare.ts","3f1362aa-4243-11f1-a9ae-42b51c65c3df",11,["D",1777299201317],"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 };\n };\n photos?: {\n count: number;\n items: FsqPhoto[];\n };\n}\n\nexport async function getCheckins(\n oauthToken: string,\n apiVersion: string,\n afterTimestamp: number,\n): Promise {\n const params = new URLSearchParams({\n oauth_token: oauthToken,\n v: apiVersion,\n afterTimestamp: String(afterTimestamp),\n sort: \"oldestfirst\",\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",[],[172,249],"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",[],[172,257],"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

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

Diff · v16