feat: add getActorPhotos query with parameters and output schema; implement route and handler for fetching actor photos

__generated__/index.ts

···
 import * as SocialGrainActorGetProfile from './types/social/grain/actor/getProfile.ts'
 import * as SocialGrainActorSearchActors from './types/social/grain/actor/searchActors.ts'
 import * as SocialGrainActorGetActorFavs from './types/social/grain/actor/getActorFavs.ts'
+import * as SocialGrainPhotoGetActorPhotos from './types/social/grain/photo/getActorPhotos.ts'
 
 export const APP_BSKY_GRAPH = {
   DefsModlist: 'app.bsky.graph.defs#modlist',
···
 
   constructor(server: Server) {
     this._server = server
+  }
+
+  getActorPhotos<AV extends AuthVerifier>(
+    cfg: ConfigOf<
+      AV,
+      SocialGrainPhotoGetActorPhotos.Handler<ExtractAuth<AV>>,
+      SocialGrainPhotoGetActorPhotos.HandlerReqCtx<ExtractAuth<AV>>
+    >,
+  ) {
+    const nsid = 'social.grain.photo.getActorPhotos' // @ts-ignore
+    return this._server.xrpc.method(nsid, cfg)
   }
 }
 

__generated__/lexicons.ts

···
       },
     },
   },
+  SocialGrainPhotoGetActorPhotos: {
+    lexicon: 1,
+    id: 'social.grain.photo.getActorPhotos',
+    defs: {
+      main: {
+        type: 'query',
+        description: "Get a view of an actor's photos. Does not require auth.",
+        parameters: {
+          type: 'params',
+          required: ['actor'],
+          properties: {
+            actor: {
+              type: 'string',
+              format: 'at-identifier',
+            },
+            limit: {
+              type: 'integer',
+              minimum: 1,
+              maximum: 100,
+              default: 50,
+            },
+            cursor: {
+              type: 'string',
+            },
+          },
+        },
+        output: {
+          encoding: 'application/json',
+          schema: {
+            type: 'object',
+            required: ['items'],
+            properties: {
+              cursor: {
+                type: 'string',
+              },
+              items: {
+                type: 'array',
+                items: {
+                  type: 'ref',
+                  ref: 'lex:social.grain.photo.defs#photoView',
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+  },
   SocialGrainPhoto: {
     lexicon: 1,
     id: 'social.grain.photo',
···
   SocialGrainActorProfile: 'social.grain.actor.profile',
   SocialGrainPhotoDefs: 'social.grain.photo.defs',
   SocialGrainPhotoExif: 'social.grain.photo.exif',
+  SocialGrainPhotoGetActorPhotos: 'social.grain.photo.getActorPhotos',
   SocialGrainPhoto: 'social.grain.photo',
   ComAtprotoLabelDefs: 'com.atproto.label.defs',
   ComAtprotoRepoStrongRef: 'com.atproto.repo.strongRef',

__generated__/types/social/grain/photo/getActorPhotos.ts

···
+/**
+ * GENERATED CODE - DO NOT MODIFY
+ */
+import { HandlerAuth, HandlerPipeThrough } from "npm:@atproto/xrpc-server";
+import express from "npm:express";
+import { validate as _validate } from "../../../../lexicons.ts";
+import { is$typed as _is$typed } from "../../../../util.ts";
+import type * as SocialGrainPhotoDefs from "./defs.ts";
+
+const is$typed = _is$typed,
+  validate = _validate;
+const id = "social.grain.photo.getActorPhotos";
+
+export interface QueryParams {
+  actor: string;
+  limit: number;
+  cursor?: string;
+}
+
+export type InputSchema = undefined;
+
+export interface OutputSchema {
+  cursor?: string;
+  items: SocialGrainPhotoDefs.PhotoView[];
+}
+
+export type HandlerInput = undefined;
+
+export interface HandlerSuccess {
+  encoding: "application/json";
+  body: OutputSchema;
+  headers?: { [key: string]: string };
+}
+
+export interface HandlerError {
+  status: number;
+  message?: string;
+}
+
+export type HandlerOutput = HandlerError | HandlerSuccess | HandlerPipeThrough;
+export type HandlerReqCtx<HA extends HandlerAuth = never> = {
+  auth: HA;
+  params: QueryParams;
+  input: HandlerInput;
+  req: express.Request;
+  res: express.Response;
+  resetRouteRateLimits: () => Promise<void>;
+};
+export type Handler<HA extends HandlerAuth = never> = (
+  ctx: HandlerReqCtx<HA>,
+) => Promise<HandlerOutput> | HandlerOutput;

lexicons/social/grain/photo/getActorPhotos.json

···
+{
+  "lexicon": 1,
+  "id": "social.grain.photo.getActorPhotos",
+  "defs": {
+    "main": {
+      "type": "query",
+      "description": "Get a view of an actor's photos. Does not require auth.",
+      "parameters": {
+        "type": "params",
+        "required": ["actor"],
+        "properties": {
+          "actor": { "type": "string", "format": "at-identifier" },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "default": 50
+          },
+          "cursor": { "type": "string" }
+        }
+      },
+      "output": {
+        "encoding": "application/json",
+        "schema": {
+          "type": "object",
+          "required": ["items"],
+          "properties": {
+            "cursor": { "type": "string" },
+            "items": {
+              "type": "array",
+              "items": {
+                "type": "ref",
+                "ref": "social.grain.photo.defs#photoView"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

src/api/mod.ts

···
 import {
   OutputSchema as GetNotificationsOutputSchema,
 } from "$lexicon/types/social/grain/notification/getNotifications.ts";
+import {
+  OutputSchema as GetActorPhotosOutputSchema,
+  QueryParams as GetActorPhotosQueryParams,
+} from "$lexicon/types/social/grain/photo/getActorPhotos.ts";
 
 import { AtUri } from "@atproto/syntax";
 import { BffMiddleware, route } from "@bigmoves/bff";
 import {
   getActorGalleries,
   getActorGalleryFavs,
+  getActorPhotos,
   getActorProfile,
   getActorProfileDetailed,
   searchActors,
···
     const { actor } = getActorFavsQueryParams(url);
     const galleries = getActorGalleryFavs(actor, ctx);
     return ctx.json({ items: galleries } as GetActorFavsOutputSchema);
+  }),
+  route("/xrpc/social.grain.photo.getActorPhotos", (req, _params, ctx) => {
+    const url = new URL(req.url);
+    const { actor } = getActorPhotosQueryParams(url);
+    const photos = getActorPhotos(actor, ctx);
+    return ctx.json({ items: photos } as GetActorPhotosOutputSchema);
   }),
   route("/xrpc/social.grain.gallery.getGallery", (req, _params, ctx) => {
     const url = new URL(req.url);
···
 }
 
 function getActorFavsQueryParams(url: URL): GetActorFavsQueryParams {
+  const actor = url.searchParams.get("actor");
+  if (!actor) throw new BadRequestError("Missing actor parameter");
+  const limit = parseInt(url.searchParams.get("limit") ?? "50", 10);
+  if (isNaN(limit) || limit <= 0) {
+    throw new BadRequestError("Invalid limit parameter");
+  }
+  const cursor = url.searchParams.get("cursor") ?? undefined;
+  return { actor, limit, cursor };
+}
+
+function getActorPhotosQueryParams(url: URL): GetActorPhotosQueryParams {
   const actor = url.searchParams.get("actor");
   if (!actor) throw new BadRequestError("Missing actor parameter");
   const limit = parseInt(url.searchParams.get("limit") ?? "50", 10);